本页内容
本页内容
工具
高架模式
当代理在沙箱内运行时,其 exec 命令仅限于沙箱环境。 E提升模式允许代理突破普通代理配置的沙箱,并在沙箱外运行命令,并具有可配置的批准门。其创建者角色需要沙箱的会话无法使用提升模式来逃脱。
指令
Control 每个会话的提升模式,带有斜杠命令:
| 指令 | 它的作用 |
|---|---|
/elevated on |
在配置的主机路径上于沙箱外运行,保留审批 |
/elevated ask |
与 on 相同(别名) |
/elevated full |
在配置的主机路径上的沙箱外部运行,并在 mode/host 批准策略已允许时跳过批准 |
/elevated off |
返回到受沙箱限制的执行 |
也可使用 /elev on|off|ask|full。
发送不带参数的 /elevated 可查看当前级别。
工作原理
检查空房情况
必须在配置中启用 elevated,且发送者必须在允许列表中:
设置级别
发送仅包含指令的消息以设置会话默认值:
或以内联方式使用(仅适用于该消息):
命令在沙箱外运行
随着活动的增加,exec 调用离开沙箱。默认情况下,有效主机为 gateway;当 configured/session 执行目标为 node 时,有效主机为 node。在 full 模式下,当解析的 exec mode/host 批准策略已经完全许可时,将跳过 exec 批准(安全 full,请询问 off);否则仍适用正常审批政策。在on/ask模式下,配置的审批规则始终适用。
解析顺序
- 消息中的内联指令(仅适用于该消息)
- 会话覆盖(通过发送仅包含指令的消息设置)
- 全局默认值(配置中的
agents.defaults.elevatedDefault)
可用性和允许列表
- Global gate:
tools.elevated.enabled(必须为true) - Sender allowlist:
tools.elevated.allowFrom,按频道分别配置列表 - Per-agent gate:
agents.entries.*.tools.elevated.enabled(只能进一步限制;全局和 per-agent gate 都必须为true) - Per-agent allowlist:
agents.entries.*.tools.elevated.allowFrom(发送者必须同时匹配全局 + per-agent) - Channel-provided fallback allowlist: 频道插件可以通过 SDK adapter hook 选择性提供一个回退允许列表,当未配置
tools.elevated.allowFrom.<provider>时使用。目前没有任何内置频道实现这个 hook,因此实际上现在每个 provider 都需要显式配置一个tools.elevated.allowFrom.<provider>条目。 - All gates must pass;否则 elevated 会被视为不可用
允许列表条目格式:
| 前缀 | 匹配内容 |
|---|---|
| (无) | 发送者 ID、E.164,或 From 字段 |
name: |
发送者显示名称 |
username: |
发送者用户名 |
tag: |
发送者标签 |
id:, from:, e164: |
显式身份标识目标 |
什么升高不控制
- 工具策略:如果
exec被工具策略拒绝,则提升无法覆盖它。 - 必需的角色沙箱:如果经过身份验证的会话创建者的操作员角色需要沙箱,则提升模式无法在网关或节点上运行命令。
- 主机选择策略:提升不会将
auto变成免费的跨主机覆盖。它使用 configured/session 执行目标规则,仅当目标已经是node时才选择node。 - 与
/exec分开:/exec指令为授权发件人调整每会话执行默认值(主机、安全性、询问、节点),并且不需要提升模式。
相关内容
本页有帮助吗?