Tools

昇格モード

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

ディレクティブ

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

ディレクティブ	動作
`/elevated on`	設定されたホストパス上でサンドボックス外から実行し、承認を維持する
`/elevated ask`	`on` と同じ（別名）
`/elevated full`	設定されたホストパス上でサンドボックス外から実行し、モードまたはホストの承認ポリシーがすでに許容的な場合は承認を省略する
`/elevated off`	サンドボックス内に制限された実行へ戻す

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

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

仕組み

利用可能か確認する

設定で昇格モードが有効になっており、送信者が許可リストに登録されている必要があります。

json5

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

レベルを設定する

セッションのデフォルトを設定するには、ディレクティブだけのメッセージを送信します。

Code

/elevated full

または、インラインで使用します（そのメッセージにのみ適用されます）。

Code

/elevated on run the deployment script

サンドボックス外でコマンドを実行する

昇格モードが有効な場合、exec 呼び出しはサンドボックス外で実行されます。実効ホストはデフォルトで gateway です。設定またはセッションの exec ターゲットが node の場合は node になります。full モードでは、解決された exec のモードまたはホスト承認ポリシーがすでに完全に許容的（セキュリティが full、 ask が 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（送信者はグローバルとエージェントごとの両方に一致する必要があります）
チャンネル提供のフォールバック許可リスト: チャンネル Plugin は、SDK アダプターフックを通じてフォールバック許可リストを任意で提供できます。これは tools.elevated.allowFrom.<provider> が設定されていない場合に使用されます。現在、このフックを実装している同梱チャンネルはないため、実際には現時点ですべてのプロバイダーに明示的な tools.elevated.allowFrom.<provider> エントリが必要です。
すべてのゲートを通過する必要があります。それ以外の場合、昇格モードは利用不可として扱われます

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

プレフィックス	一致対象
（なし）	送信者 ID、E.164、または From フィールド
`name:`	送信者の表示名
`username:`	送信者のユーザー名
`tag:`	送信者のタグ
`id:`, `from:`, `e164:`	明示的なアイデンティティ指定