昇格モード

エージェントがサンドボックス内で実行される場合、その exec コマンドはサンドボックス環境内に制限されます。昇格モードを使用すると、代わりにエージェントがサンドボックスを抜け出して外部でコマンドを実行でき、承認ゲートも設定できます。

ディレクティブ

スラッシュコマンドを使用して、セッションごとに昇格モードを制御します。

/elev on|off|ask|full としても使用できます。

現在のレベルを確認するには、引数なしで /elevated を送信します。

仕組み

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

/elevated full

/elevated on デプロイスクリプトを実行する

解決順序

1. メッセージ内のインラインディレクティブ（そのメッセージにのみ適用）
2. セッションオーバーライド（ディレクティブのみのメッセージを送信して設定）
3. グローバルデフォルト（設定内の agents.defaults.elevatedDefault）

利用可否と許可リスト

• グローバルゲート：tools.elevated.enabled（true である必要があります）
• 送信者の許可リスト：チャンネルごとのリストを持つ tools.elevated.allowFrom
• エージェントごとのゲート：agents.entries.*.tools.elevated.enabled（制限をさらに厳しくすることのみ可能。グローバルゲートとエージェントごとのゲートの両方が true である必要があります）
• エージェントごとの許可リスト：agents.entries.*.tools.elevated.allowFrom（送信者はグローバルとエージェントごとの両方に一致する必要があります）
• チャンネル提供のフォールバック許可リスト：チャンネル Plugin は、SDK アダプターフックを通じてフォールバック許可リストを任意で提供できます。これは tools.elevated.allowFrom.<provider> が設定されていない場合に使用されます。現在、このフックを実装している同梱チャンネルはないため、現時点では実際上、すべてのプロバイダーに明示的な tools.elevated.allowFrom.<provider> エントリが必要です。
• すべてのゲートを通過する必要があります。通過しない場合、昇格は利用不可として扱われます

許可リストのエントリ形式：

昇格によって制御されないもの

• ツールポリシー：exec がツールポリシーによって拒否されている場合、昇格でオーバーライドすることはできません。
• ホスト選択ポリシー：昇格によって auto が自由なホスト間オーバーライドになることはありません。設定またはセッションの exec ターゲットルールを使用し、ターゲットがすでに node である場合にのみ node を選択します。
• /exec とは別個：/exec ディレクティブは、承認された送信者についてセッションごとの exec デフォルト（ホスト、セキュリティ、確認、Node）を調整するものであり、昇格モードを必要としません。

関連項目