Tools

권한 상승 모드

샌드박스 안에서 에이전트가 실행되면 해당 exec 명령은 샌드박스 환경으로 제한됩니다. 권한 상승 모드를 사용하면 에이전트가 대신 샌드박스를 벗어나 외부에서 명령을 실행할 수 있으며, 승인 게이트를 구성할 수 있습니다.

지시문

슬래시 명령으로 세션별 권한 상승 모드를 제어합니다.

지시문 수행 작업
/elevated on 구성된 호스트 경로에서 샌드박스 외부로 실행하고 승인은 유지합니다
/elevated ask on과 동일합니다(별칭)
/elevated full 구성된 호스트 경로에서 샌드박스 외부로 실행하고 승인을 건너뜁니다
/elevated off 샌드박스에 제한된 실행으로 돌아갑니다

/elev on|off|ask|full로도 사용할 수 있습니다.

현재 수준을 보려면 인수 없이 /elevated를 보내세요.

작동 방식

  • 사용 가능 여부 확인

    구성에서 Elevated가 활성화되어 있어야 하며, 보낸 사람이 허용 목록에 있어야 합니다.

    {
      tools: {
        elevated: {
          enabled: true,
          allowFrom: {
            discord: ["user-id-123"],
            whatsapp: ["+15555550123"],
          },
        },
      },
    }
    
  • 수준 설정

    세션 기본값을 설정하려면 지시문만 포함된 메시지를 보내세요.

    /elevated full
    

    또는 인라인으로 사용하세요(해당 메시지에만 적용됨).

    /elevated on run the deployment script
    
  • 명령이 샌드박스 외부에서 실행됨

    권한 상승이 활성화되면 exec 호출은 샌드박스를 벗어납니다. 유효한 호스트는 기본적으로 gateway이며, 구성된/세션 exec 대상이 node인 경우에는 node입니다. full 모드에서는 exec 승인을 건너뜁니다. on/ask 모드에서는 구성된 승인 규칙이 계속 적용됩니다.

  • 확인 순서

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

    사용 가능 여부 및 허용 목록

    • 전역 게이트: tools.elevated.enabled(true여야 함)
    • 보낸 사람 허용 목록: 채널별 목록이 포함된 tools.elevated.allowFrom
    • 에이전트별 게이트: agents.list[].tools.elevated.enabled(더 제한만 가능)
    • 에이전트별 허용 목록: agents.list[].tools.elevated.allowFrom(보낸 사람이 전역 및 에이전트별 조건을 모두 충족해야 함)
    • Discord 폴백: tools.elevated.allowFrom.discord가 생략된 경우 channels.discord.allowFrom이 폴백으로 사용됩니다
    • 모든 게이트를 통과해야 합니다. 그렇지 않으면 권한 상승은 사용할 수 없는 것으로 처리됩니다

    허용 목록 항목 형식:

    접두사 일치 대상
    (없음) 보낸 사람 ID, E.164 또는 From 필드
    name: 보낸 사람 표시 이름
    username: 보낸 사람 사용자 이름
    tag: 보낸 사람 태그
    id:, from:, e164: 명시적 ID 대상 지정

    권한 상승이 제어하지 않는 것

    • 도구 정책: 도구 정책에서 exec가 거부된 경우, 권한 상승으로 이를 재정의할 수 없습니다.
    • 호스트 선택 정책: 권한 상승은 auto를 자유로운 교차 호스트 재정의로 바꾸지 않습니다. 구성된/세션 exec 대상 규칙을 사용하며, 대상이 이미 node인 경우에만 node를 선택합니다.
    • /exec와 별개: /exec 지시문은 인증된 보낸 사람에 대한 세션별 exec 기본값을 조정하며 권한 상승 모드를 요구하지 않습니다.

    관련 항목