Elevated Mode (/elevated directives)
What it does
/elevated on은 게이트웨이 호스트에서 실행되며 exec 승인을 유지합니다(또는/elevated ask와 동일합니다)./elevated full은 게이트웨이 호스트에서 실행되고 exec를 자동 승인합니다(exec 승인을 건너뜁니다)./elevated ask은 게이트웨이 호스트에서 실행되지만 exec 승인을 유지합니다(또는/elevated on과 동일합니다).on/ask는exec.security=full을 강제하지 않습니다; 구성된 보안/질의 정책은 여전히 적용됩니다.- 에이전트가 샌드박스 격리될 때만 동작을 변경합니다(그렇지 않으면 exec가 이미 호스트에서 실행됩니다).
- 지시문의 형식:
/elevated on|off|ask|full,/elev on|off|ask|full. on|off|ask|full만 허용됩니다; 그 외의 입력은 힌트를 반환하고 상태를 변경하지 않습니다.
What it controls (and what it doesn’t)
- 사용 가능성 게이트:
tools.elevated는 전역 기초입니다.agents.list[].tools.elevated는 에이전트별로 추가로 승격을 제한할 수 있습니다(둘 다 허용해야 합니다). - 세션별 상태:
/elevated on|off|ask|full은 현재 세션 키의 승격 수준을 설정합니다. - 인라인 지시문: 메시지 내의
/elevated on|ask|full은 해당 메시지에만 적용됩니다. - 그룹: 그룹 채팅에서는 에이전트가 언급될 때만 승격 지시문이 인식됩니다. 언급 요구사항을 우회하는 명령어 전용 메시지는 언급된 것으로 처리됩니다.
- 호스트 실행: 승격은 게이트웨이 호스트에서
exec를 강제하며;full은 여기에security=full도 설정합니다. - 승인들:
full은 exec 승인을 건너뛰며;on/ask는 허용 목록/질의 규칙이 요구할 때 이를 준수합니다. - 샌드박스 격리되지 않은 에이전트들: 위치에 대한 작동 없음; 차단, 로깅 및 상태에만 영향을 줍니다.
- 도구 정책 여전히 적용: 도구 정책에 의해
exec가 거부되면 승격을 사용할 수 없습니다. /exec과 분리됨:/exec는 인증된 발신자에 대해 세션 기본값을 조정하며 승격이 필요하지 않습니다.
Resolution order
- 메시지의 인라인 지시문 (해당 메시지에만 적용).
- 세션 오버라이드 (지시문 전용 메시지를 보내 설정).
- 글로벌 기본값 (구성의
agents.defaults.elevatedDefault).
Setting a session default
- 지시문만 포함된 메시지를 전송합니다 (공백 허용), 예:
/elevated full. - 확인 응답이 전송됩니다 (
Elevated mode set to full.../Elevated mode disabled.). - 승급된 접근이 비활성화되었거나 발신자가 승인된 허용 목록에 없을 경우, 지시문은 실행 가능한 오류와 함께 응답하며 세션 상태를 변경하지 않습니다.
/elevated(또는/elevated:)를 인수 없이 보내서 현재 승급 수준을 확인할 수 있습니다.
Availability + allowlists
- 기능 게이트:
tools.elevated.enabled(설정이 허용하더라도 기본적으로 비활성화 가능). - 발신자 허용 목록:
tools.elevated.allowFrom으로 프로바이더별 허용 목록 (예:discord,whatsapp). - 에이전트별 게이트:
agents.list[].tools.elevated.enabled(선택적; 추가로 제한할 수만 있음). - 에이전트별 허용 목록:
agents.list[].tools.elevated.allowFrom(선택적; 설정 시 발신자는 전역 및 에이전트별 허용 목록에 모두 일치해야 함). - Discord 대체:
tools.elevated.allowFrom.discord가 생략되면channels.discord.allowFrom목록이 대체로 사용됩니다 (레거시:channels.discord.dm.allowFrom).tools.elevated.allowFrom.discord(빈 배열이라도)로 덮어씌울 수 있습니다. 에이전트별 허용 목록은 대체를 사용하지 않습니다. - 모든 게이트가 통과해야 하며, 그렇지 않으면 승급이 사용 불가능으로 처리됩니다.
Logging + status
- 승격된 exec 호출은 정보 수준으로 기록됩니다.
- 세션 상태에는 승급 모드가 포함됩니다 (예:
elevated=ask,elevated=full).