何をするのか
/elevated onはゲートウェイ ホスト上で実行され、実行承認を維持します (/elevated askと同じ)。/elevated fullはゲートウェイ ホスト上で実行され、** 実行を自動承認します (実行の承認をスキップします)。/elevated askはゲートウェイ ホスト上で実行されますが、実行承認は維持されます (/elevated onと同じ)。on/askはexec.security=fullを強制しません。設定されたセキュリティ/アスクポリシーは引き続き適用されます。- エージェントが サンドボックス である場合にのみ動作が変更されます (それ以外の場合は、exec がホスト上ですでに実行されている場合)。
- ディレクティブ形式:
/elevated on|off|ask|full、/elev on|off|ask|full。 on|off|ask|fullのみが受け入れられます。それ以外の場合はヒントを返し、状態は変更されません。
制御するもの (および制御しないもの)- 可用性ゲート: tools.elevated はグローバル ベースラインです。 agents.list[].tools.elevated は、エージェントごとの昇格をさらに制限できます (両方で許可する必要があります)
- セッションごとの状態:
/elevated on|off|ask|fullは、現在のセッション キーの昇格レベルを設定します。 - インライン ディレクティブ: メッセージ内の
/elevated on|ask|fullは、そのメッセージにのみ適用されます。 - グループ: グループ チャットでは、エージェントが言及された場合にのみ、昇格されたディレクティブが適用されます。メンション要件を回避するコマンドのみのメッセージは、メンションされたものとして扱われます。
- ホスト実行: 昇格により、
execがゲートウェイ ホストに強制されます。fullはsecurity=fullも設定します。 - 承認:
fullは幹部の承認をスキップします。on/askは、ホワイトリスト/アスク ルールが必要とする場合にそれらを尊重します。 - サンドボックス化されていないエージェント: 位置情報については何も操作しません。ゲート、ロギング、ステータスにのみ影響します。
- ツール ポリシーは引き続き適用されます:
execがツール ポリシーによって拒否された場合、昇格は使用できません。 /execとは別のもの:/execは、承認された送信者のセッションごとのデフォルトを調整し、昇格する必要はありません。
解決順序
- メッセージのインライン ディレクティブ (そのメッセージにのみ適用されます)。
- セッションオーバーライド (ディレクティブ専用メッセージの送信によって設定)。
- グローバルデフォルト (構成内の
agents.defaults.elevatedDefault)。
セッションのデフォルトの設定- ディレクティブ のみ のメッセージを送信します (空白は許可されます)。 /elevated full
- 確認応答が送信されます (
Elevated mode set to full.../Elevated mode disabled.)。 - 昇格されたアクセスが無効になっている場合、または送信者が承認された許可リストに載っていない場合、ディレクティブは対処可能なエラーを返し、セッション状態は変更されません。
- 現在の高いレベルを確認するには、引数なしで
/elevated(または/elevated:) を送信します。
可用性 + 許可リスト- 機能ゲート: tools.elevated.enabled (コードがサポートしている場合でも、デフォルトは設定によってオフにすることができます)
- 送信者許可リスト: プロバイダーごとの許可リストを含む
tools.elevated.allowFrom(例:discord、whatsapp)。 - プレフィックスのない許可リスト エントリは、送信者スコープの ID 値のみと一致します (
SenderId、SenderE164、From)。受信者ルーティング フィールドは、昇格された承認には決して使用されません。 - 変更可能な送信者メタデータには明示的なプレフィックスが必要です。
name:<value>はSenderNameと一致しますusername:<value>はSenderUsernameと一致しますtag:<value>はSenderTagと一致しますid:<value>、from:<value>、e164:<value>は明示的な ID ターゲティングに使用できます
- エージェントごとのゲート:
agents.list[].tools.elevated.enabled(オプション。さらに制限することのみ可能)。 - エージェントごとの許可リスト:
agents.list[].tools.elevated.allowFrom(オプション。設定すると、送信者はグローバル許可リストとエージェントごとの許可リストの 両方 に一致する必要があります)。 - Discord フォールバック:
tools.elevated.allowFrom.discordが省略された場合、channels.discord.allowFromリストがフォールバックとして使用されます (レガシー:channels.discord.dm.allowFrom)。tools.elevated.allowFrom.discord([]も) をオーバーライドするように設定します。エージェントごとの許可リストはフォールバックを使用しません**。 - すべてのゲートを通過する必要があります。それ以外の場合、昇格されたものは利用できないものとして扱われます。
ロギング + ステータス
- 昇格された exec 呼び出しは情報レベルで記録されます。
- セッション ステータスには昇格モードが含まれます (例:
elevated=ask、elevated=full)。