이 페이지에서
이 페이지에서
Tools
권한 상승 모드
에이전트가 샌드박스 내부에서 실행될 때 해당 에이전트의 exec 명령은 샌드박스 환경으로 제한됩니다. 권한 상승 모드를 사용하면 에이전트가 샌드박스를 벗어나 외부에서 명령을 실행할 수 있으며, 승인 게이트를 구성할 수 있습니다.
지시어
슬래시 명령으로 세션별 권한 상승 모드를 제어합니다.
| 지시어 | 기능 |
|---|---|
/elevated on |
구성된 호스트 경로에서 샌드박스 외부로 실행하며 승인을 유지합니다 |
/elevated ask |
on과 동일합니다(별칭) |
/elevated full |
구성된 호스트 경로에서 샌드박스 외부로 실행하며, 모드/호스트 승인 정책이 이미 허용적인 경우 승인을 건너뜁니다 |
/elevated off |
샌드박스로 제한된 실행으로 돌아갑니다 |
/elev on|off|ask|full로도 사용할 수 있습니다.
현재 수준을 확인하려면 인수 없이 /elevated를 전송합니다.
작동 방식
사용 가능 여부 확인
권한 상승이 구성에서 활성화되어 있어야 하며 발신자가 허용 목록에 있어야 합니다.
수준 설정
지시어만 포함된 메시지를 전송하여 세션 기본값을 설정합니다.
또는 인라인으로 사용합니다(해당 메시지에만 적용됨).
샌드박스 외부에서 명령 실행
권한 상승이 활성화되면 exec 호출은 샌드박스를 벗어납니다. 유효 호스트는
기본적으로 gateway이며, 구성된/세션의 exec 대상이 node인 경우에는
node입니다. full 모드에서는 확인된 exec 모드/호스트 승인 정책이
이미 완전히 허용적인 경우(보안 full, 요청 off) exec 승인을
건너뜁니다. 그렇지 않으면 일반 승인 정책이 계속 적용됩니다.
on/ask 모드에서는 구성된 승인 규칙이 항상 적용됩니다.
결정 순서
- 메시지의 인라인 지시어(해당 메시지에만 적용)
- 세션 재정의(지시어만 포함된 메시지를 전송하여 설정)
- 전역 기본값(구성의
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>항목이 필요합니다. - 모든 게이트를 통과해야 합니다. 그렇지 않으면 권한 상승을 사용할 수 없는 것으로 처리합니다.
허용 목록 항목 형식:
| 접두사 | 일치 대상 |
|---|---|
| (없음) | 발신자 ID, E.164 또는 From 필드 |
name: |
발신자 표시 이름 |
username: |
발신자 사용자 이름 |
tag: |
발신자 태그 |
id:, from:, e164: |
명시적인 ID 대상 지정 |
권한 상승이 제어하지 않는 항목
- 도구 정책: 도구 정책에서
exec가 거부된 경우 권한 상승으로 이를 재정의할 수 없습니다. - 호스트 선택 정책: 권한 상승은
auto를 자유로운 호스트 간 재정의로 바꾸지 않습니다. 구성된/세션의 exec 대상 규칙을 사용하며, 대상이 이미node인 경우에만node를 선택합니다. /exec와 별개:/exec지시어는 권한이 있는 발신자의 세션별 exec 기본값(호스트, 보안, 요청, 노드)을 조정하며 권한 상승 모드가 필요하지 않습니다.
관련 항목
Was this useful?
