Tools
提高權限模式
當代理在沙盒內執行時，它的 exec 命令會被限制在沙盒環境中。Elevated 模式讓代理改為跳出沙盒，並在沙盒外執行命令，同時可設定核准閘門。
指令
使用斜線命令依工作階段控制 elevated 模式：
| 指令 | 作用 |
|---|---|
/elevated on |
在設定的主機路徑上於沙盒外執行，保留核准流程 |
/elevated ask |
與 on 相同（別名） |
/elevated full |
在設定的主機路徑上於沙盒外執行，並略過核准流程 |
/elevated off |
回到受沙盒限制的執行方式 |
也可使用 /elev on|off|ask|full。
不帶引數傳送 /elevated 可查看目前層級。
運作方式
Check availability
必須在設定中啟用 Elevated，且傳送者必須在允許清單中：
{
tools: {
elevated: {
enabled: true,
allowFrom: {
discord: ["user-id-123"],
whatsapp: ["+15555550123"],
},
},
},
}
Set the level
傳送只有指令的訊息來設定工作階段預設值：
/elevated full
或以內嵌方式使用（只套用到該訊息）：
/elevated on run the deployment script
Commands run outside the sandbox
啟用 elevated 後，exec 呼叫會離開沙盒。有效主機預設為 gateway，或在設定/工作階段 exec 目標為 node 時使用 node。在 full 模式中，會略過 exec 核准流程。在 on/ask 模式中，仍會套用設定的核准規則。
解析順序
- 訊息上的內嵌指令（只套用到該訊息）
- 工作階段覆寫（透過傳送只有指令的訊息設定）
- 全域預設值（設定中的
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作為後援 - 所有閘門都必須通過；否則 elevated 會被視為不可用
允許清單項目格式：
| 前綴 | 符合項目 |
|---|---|
| （無） | 傳送者 ID、E.164 或 From 欄位 |
name: |
傳送者顯示名稱 |
username: |
傳送者使用者名稱 |
tag: |
傳送者標籤 |
id:, from:, e164: |
明確指定身分 |
elevated 不控制的項目
- 工具政策：如果
exec被工具政策拒絕，elevated 無法覆寫。 - 主機選擇政策：elevated 不會將
auto變成可任意跨主機覆寫的模式。它會使用設定/工作階段 exec 目標規則，只有在目標已經是node時才選擇node。 - 與
/exec分開：/exec指令會為已授權的傳送者調整各工作階段的 exec 預設值，且不需要 elevated 模式。