Skip to main content
에이전트가 샌드박스 내부에서 실행될 때 해당 에이전트의 exec 명령은 샌드박스 환경으로 제한됩니다. 권한 상승 모드를 사용하면 에이전트가 샌드박스를 벗어나 외부에서 명령을 실행할 수 있으며, 승인 게이트를 구성할 수 있습니다.
권한 상승 모드는 에이전트가 샌드박스화된 경우에만 동작을 변경합니다. 샌드박스화되지 않은 에이전트의 경우 exec는 이미 호스트에서 실행됩니다.

지시어

슬래시 명령으로 세션별 권한 상승 모드를 제어합니다. /elev on|off|ask|full로도 사용할 수 있습니다. 현재 수준을 확인하려면 인수 없이 /elevated를 전송합니다.

작동 방식

1

사용 가능 여부 확인

권한 상승이 구성에서 활성화되어 있어야 하며 발신자가 허용 목록에 있어야 합니다.
2

수준 설정

지시어만 포함된 메시지를 전송하여 세션 기본값을 설정합니다.
또는 인라인으로 사용합니다(해당 메시지에만 적용됨).
3

샌드박스 외부에서 명령 실행

권한 상승이 활성화되면 exec 호출은 샌드박스를 벗어납니다. 유효 호스트는 기본적으로 gateway이며, 구성된/세션의 exec 대상이 node인 경우에는 node입니다. full 모드에서는 확인된 exec 모드/호스트 승인 정책이 이미 완전히 허용적인 경우(보안 full, 요청 off) exec 승인을 건너뜁니다. 그렇지 않으면 일반 승인 정책이 계속 적용됩니다. on/ask 모드에서는 구성된 승인 규칙이 항상 적용됩니다.

결정 순서

  1. 메시지의 인라인 지시어(해당 메시지에만 적용)
  2. 세션 재정의(지시어만 포함된 메시지를 전송하여 설정)
  3. 전역 기본값(구성의 agents.defaults.elevatedDefault)

사용 가능 여부 및 허용 목록

  • 전역 게이트: tools.elevated.enabled(true여야 함)
  • 발신자 허용 목록: 채널별 목록이 있는 tools.elevated.allowFrom
  • 에이전트별 게이트: agents.list[].tools.elevated.enabled(추가로 제한만 가능하며 전역 게이트와 에이전트별 게이트가 모두 true여야 함)
  • 에이전트별 허용 목록: agents.list[].tools.elevated.allowFrom(발신자가 전역 및 에이전트별 목록 모두와 일치해야 함)
  • 채널에서 제공하는 대체 허용 목록: tools.elevated.allowFrom.<provider>가 구성되지 않은 경우 채널 Plugin은 SDK 어댑터 훅을 통해 대체 허용 목록을 선택적으로 제공할 수 있습니다. 현재 번들 채널은 이 훅을 구현하지 않으므로, 실제로는 현재 모든 공급자에 명시적인 tools.elevated.allowFrom.<provider> 항목이 필요합니다.
  • 모든 게이트를 통과해야 합니다. 그렇지 않으면 권한 상승을 사용할 수 없는 것으로 처리합니다.
허용 목록 항목 형식:

권한 상승이 제어하지 않는 항목

  • 도구 정책: 도구 정책에서 exec가 거부된 경우 권한 상승으로 이를 재정의할 수 없습니다.
  • 호스트 선택 정책: 권한 상승은 auto를 자유로운 호스트 간 재정의로 바꾸지 않습니다. 구성된/세션의 exec 대상 규칙을 사용하며, 대상이 이미 node인 경우에만 node를 선택합니다.
  • /exec와 별개: /exec 지시어는 권한이 있는 발신자의 세션별 exec 기본값(호스트, 보안, 요청, 노드)을 조정하며 권한 상승 모드가 필요하지 않습니다.
bash 채팅 명령(! 접두사, /bash 별칭)은 자체 tools.bash.enabled 플래그 외에도 tools.elevated가 활성화되어야 하는 별도의 게이트입니다. 권한 상승을 비활성화하면 ! 셸 명령도 사용할 수 없습니다.

관련 항목

Exec 도구

에이전트에서 셸 명령을 실행합니다.

Exec 승인

exec의 승인 및 허용 목록 시스템입니다.

샌드박스화

Gateway 수준의 샌드박스 구성입니다.

샌드박스와 도구 정책 및 권한 상승 비교

도구 호출 중 세 가지 게이트가 결합되는 방식입니다.