提升模式（/elevated 指令）

它的作用

  • /elevated on 在 gateway host 上运行并保留 exec 批准（与 /elevated ask 相同）。
  • /elevated full 在 gateway host 上运行并且自动批准 exec（跳过 exec 批准）。
  • /elevated ask 在 gateway host 上运行但保留 exec 批准（与 /elevated on 相同）。
  • on/ask 不会强制 exec.security=full；配置的安全/询问策略仍然适用。
  • 仅在 agent 被沙箱化时改变行为（否则 exec 已经在 host 上运行）。
  • 指令形式：/elevated on|off|ask|full、/elev on|off|ask|full。
  • 仅接受 on|off|ask|full；其他任何内容返回提示且不改变状态。

它控制什么（以及它不控制什么）

  • 可用性门控：tools.elevated 是全局基线。agents.list[].tools.elevated 可以进一步限制每个 agent 的提升（两者都必须允许）。
  • 每会话状态：/elevated on|off|ask|full 为当前会话 key 设置提升级别。
  • 内联指令：消息内的 /elevated on|ask|full 仅应用于该消息。
  • 群组：在群聊中，仅当 agent 被提及时才遵守提升指令。绕过提及要求的仅命令消息被视为已提及。
  • Host 执行：elevated 强制 exec 到 gateway host；full 还设置 security=full。
  • 批准：full 跳过 exec 批准；on/ask 在允许列表/询问规则要求时遵守它们。
  • 未沙箱化的 agent：对于位置来说是无操作；仅影响门控、日志记录和状态。
  • 工具策略仍然适用：如果工具策略拒绝 exec，则无法使用 elevated。
  • 与 /exec 分开：/exec 为授权发送者调整每会话默认值，不需要 elevated。

解析顺序

  1. 消息上的内联指令（仅应用于该消息）。
  2. 会话覆盖（通过发送仅指令消息设置）。
  3. 全局默认值（配置中的 agents.defaults.elevatedDefault）。

设置会话默认值

  • 发送一个只包含指令的消息（允许空格），例如 /elevated full。
  • 发送确认回复（Elevated mode set to full... / Elevated mode disabled.）。
  • 如果提升访问被禁用或发送者不在批准的允许列表中，指令会回复一个可操作的错误，并且不改变会话状态。
  • 发送 /elevated（或 /elevated:）不带参数以查看当前提升级别。

可用性 + 允许列表

  • 功能门控：tools.elevated.enabled（即使代码支持，默认也可以通过配置关闭）。
  • 发送者允许列表：tools.elevated.allowFrom 带有每个提供商的允许列表（例如 discord、whatsapp）。
  • 每 agent 门控：agents.list[].tools.elevated.enabled（可选；只能进一步限制）。
  • 每 agent 允许列表：agents.list[].tools.elevated.allowFrom（可选；设置时，发送者必须同时匹配全局 + 每 agent 允许列表）。
  • Discord 回退：如果省略 tools.elevated.allowFrom.discord，则使用 channels.discord.dm.allowFrom 列表作为回退。设置 tools.elevated.allowFrom.discord（即使是 []）来覆盖。每 agent 允许列表不使用回退。
  • 所有门控都必须通过；否则 elevated 被视为不可用。

日志记录 + 状态

  • 提升的 exec 调用在 info 级别记录。
  • 会话状态包括提升模式（例如 elevated=ask、elevated=full）。
← 返回文档首页