提升权限模式

提升权限的 Exec 模式：从沙箱隔离的智能体在沙箱外运行命令

当智能体在沙箱内运行时，其 exec 命令会被限制在沙箱环境中。提升权限模式允许智能体突破这一限制，改为在沙箱外运行命令，并可配置审批关卡。

提升权限模式仅在智能体处于沙箱隔离状态时改变行为。对于未进行沙箱隔离的智能体，exec 已经在宿主机上运行。

指令

使用斜杠命令按会话控制提升权限模式：

指令	作用
`/elevated on`	在配置的宿主机路径上于沙箱外运行，同时保留审批
`/elevated ask`	与 `on` 相同（别名）
`/elevated full`	在配置的宿主机路径上于沙箱外运行，并在模式/宿主机审批策略已经宽松时跳过审批
`/elevated off`	恢复仅限沙箱内执行

也可使用 /elev on|off|ask|full。

发送不带参数的 /elevated 可查看当前级别。

工作原理

检查可用性

必须在配置中启用提升权限，并且发送者必须在允许列表中：

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

设置级别

发送一条仅包含指令的消息，以设置会话默认值：

/elevated full

也可以内联使用（仅应用于该消息）：

/elevated on 运行部署脚本

命令在沙箱外运行

启用提升权限后，exec 调用会离开沙箱。有效宿主机默认是 gateway；当配置的/会话的 exec 目标为 node 时，则为 node。在 full 模式下，如果解析后的 exec 模式/宿主机审批策略已经完全宽松（security full、 ask off），则会跳过 exec 审批；否则仍应用正常审批策略。在 on/ask 模式下，始终应用配置的审批规则。

解析顺序

内联指令，位于消息中（仅应用于该消息）
会话覆盖值（通过发送仅包含指令的消息设置）
全局默认值（配置中的 agents.defaults.elevatedDefault）

可用性和允许列表

全局关卡：tools.elevated.enabled（必须为 true）
发送者允许列表：tools.elevated.allowFrom，包含各渠道的列表
每智能体关卡：agents.entries.*.tools.elevated.enabled（只能进一步限制；全局关卡和每智能体关卡都必须为 true）
每智能体允许列表：agents.entries.*.tools.elevated.allowFrom（发送者必须同时匹配全局和每智能体允许列表）
渠道提供的后备允许列表：渠道插件可以选择通过 SDK 适配器钩子提供后备允许列表，在未配置 tools.elevated.allowFrom.<provider> 时使用。目前没有内置渠道实现此钩子，因此实际使用中，每个提供商目前都需要显式的 tools.elevated.allowFrom.<provider> 条目。
所有关卡都必须通过；否则提升权限将被视为不可用

允许列表条目格式：

前缀	匹配项
（无）	发送者 ID、E.164 或 From 字段
`name:`	发送者显示名称
`username:`	发送者用户名
`tag:`	发送者标签
`id:`、`from:`、`e164:`	显式指定身份

提升权限不控制的内容

工具策略：如果工具策略拒绝了 exec，提升权限无法将其覆盖。
宿主机选择策略：提升权限不会将 auto 变成可随意跨宿主机覆盖的设置。它使用配置的/会话的 exec 目标规则，仅当目标已经是 node 时才选择 node。
与 /exec 分离：/exec 指令可供已获授权的发送者调整每会话 exec 默认值（host、security、ask、node），且不需要提升权限模式。

bash 聊天命令（! 前缀；/bash 别名）使用独立关卡，除其自身的 tools.bash.enabled 标志外，还要求启用 tools.elevated。禁用提升权限也会禁止 ! shell 命令。

提升权限模式

指令

工作原理

解析顺序

可用性和允许列表

提升权限不控制的内容

相关内容