Elevated 模式(/elevated 指令)
作用
/elevated on在网关主机上运行并保留 exec 审批(同/elevated ask)。/elevated full在网关主机上运行且自动通过 exec(跳过 exec 审批)。/elevated ask在网关主机上运行但保留 exec 审批(同/elevated on)。on/ask不强制exec.security=full;仍按配置的 security/ask 策略执行。- 仅当代理处于沙箱时改变行为(否则 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 级别。 - 行内指令:消息中的
/elevated on|ask|full仅对该条消息生效。 - 群组:在群聊中,仅当提及代理时才会处理 elevated 指令;绕过提及要求的纯指令消息视为已提及。
- 主机执行:elevated 强制
exec在网关主机执行;full还会设置security=full。 - 审批:
full跳过 exec 审批;on/ask在 allowlist/ask 规则要求时仍会走审批。 - 非沙箱代理:对执行位置无影响;仅影响门控、日志和状态。
- 工具策略仍适用:若工具策略拒绝
exec,则无法使用 elevated。 - 与
/exec独立:/exec为授权发送方调整每会话默认值,不要求 elevated。
解析顺序
- 消息中的行内指令(仅对该条消息)。
- 发送仅含指令的消息所设的会话覆盖。
- 全局默认(配置中的
agents.defaults.elevatedDefault)。
设置会话默认
- 发送仅含该指令的消息(可含空白),例如
/elevated full。 - 会收到确认回复(
Elevated mode set to full.../Elevated mode disabled.)。 - 若 elevated 被禁用或发送方不在批准白名单内,指令会返回可操作的错误且不改变会话状态。
- 发送
/elevated(或/elevated:)且无参数可查看当前 elevated 级别。
可用性与白名单
- 功能门控:
tools.elevated.enabled(默认可由配置关闭)。 - 发送方白名单:
tools.elevated.allowFrom,可按提供商设白名单(如discord、whatsapp)。 - 每代理门控:
agents.list[].tools.elevated.enabled(可选;只能进一步限制)。 - 每代理白名单:
agents.list[].tools.elevated.allowFrom(可选;设置后发送方须同时满足全局与每代理白名单)。 - Discord 回退:若未设置
tools.elevated.allowFrom.discord,则使用channels.discord.dm.allowFrom。设置tools.elevated.allowFrom.discord(可为[])可覆盖。每代理白名单不使用该回退。 - 所有门控均需通过;否则 elevated 视为不可用。
日志与状态
- Elevated 的 exec 调用以 info 级别记录。
- 会话状态中包含 elevated 模式(如
elevated=ask、elevated=full)。
最后更新于: