4.5 KiB
@deepseek-ai/dsh-user-approval
English | 中文
与通道无关的一次性审批 seam。ctx.approval.request(req) 返回 allowed-once、rejected、cancelled 或 unavailable；应答者缺失或失败时会以拒绝方式关闭，授权也只适用于所请求的操作。确切事件签名见生成的 Cordis 目录。
每个请求都必须属于一个打开的 agent（智能体）轮次。服务会追加一对 approval/asked 与 approval/decided 审计记录，而模型只会看到由此产生且已写入日志的工具结果。已中止的请求会 resolve 为 cancelled；如果审计追加在提交前失败，请求会被拒绝，而不会返回一项未记录的决定。
应答者是 approval/request waterfall（瀑布式事件）监听器。要回答所拥有 agent 的请求，请返回一个结果；否则调用 next() 委托。限定到 agent 的监听器只接收该 agent 的请求；每项部署应当组合一个终端应答者，因为同级监听器的顺序不是策略优先级机制。ACP（Agent Client Protocol）自动化桥接层为其拥有的会话提供一次性机器决定。
ApprovalPolicy 为 'ask' 或 'never'。实际值取最后一条 approval/policy 事件，并回退到配置；setApprovalPolicy() 是写入路径。'never' 会在交互式分发之前拒绝请求，也是提示词中唯一声明的策略。切换最多产生一条合并通知：如果覆盖发生在最后一个 request/header 之后，则归因于用户；否则归因于操作方／配置。
工具流水线通过此 seam 路由 ask 决定，并在该 seam 缺失时以拒绝方式关闭；沙箱 bash 工具也会将它用于升权重试。ACP 自动化桥接层根据客户端的机器策略，回答其自有 agent 的调用。审计事件仍只写入日志，因此模型只会看到发起请求的消费方所返回的结果。详见审批 seam Agent Note（agent 决策记录）和沙箱 Agent Note。
模型体验
系统提示词与策略通知
模型看到的内容
在 ask 下，每个 agent 请求都会携带下方的 ask 策略提示词段。在 never 下，请求会携带下方的 never 策略提示词段。策略切换会在下一步骤前精确注入 The approval policy changed from "<old>" to "<new>" (changed by the user). 或 The approval policy changed from "<old>" to "<new>" (changed by the operator/config).。
Ask 策略提示词段
<!-- dsh-user-approval-policy:ask -->
Never 策略提示词段
Approval prompts are disabled in this session: actions that require approval are rejected automatically — do not request sandbox escalation (do not set `sandbox_permissions`).
<!-- dsh-user-approval-policy:never -->
Token 影响
每个请求有少量固定成本，never 下的成本更高；变更通知按条件出现，并保留在历史中。
KV Cache 影响
审批策略不变时，前缀保持稳定。ask／never 切换会改变系统提示词段，并从首个变化的 token 开始使复用失效；随附通知只会追加。
工具结果
模型看到的内容
approval/asked 和 approval/decided 只写入日志。模型只会看到发起请求的消费方最终给出的允许、拒绝、取消或不可用工具结果；面向人类的权限 UI 不属于上下文。
Token 影响
不会产生重复的审计 token。拒绝可能以一条少量且保留的错误替换正常工具结果，而允许会保留消费方的普通结果。
KV Cache 影响
仅追加；新出现的可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
已知限制与延期工作
- 请求只在打开的轮次内有效：空闲时或轮次之间的调用方会在审计前抛出异常；持久化的轮次外审批工作流仍属延期事项。
- 仅存在一次性授权：结果词汇包含
allowed-once，但不含allow-always、记忆规则、撤销或授权存储；会话策略只有ask／never。 - 请求不携带工具参数：应答者会看到工具名称、原因和可选调用 id；ACP 机器通道要求调用 id，并会委托不含 id 的请求。
- 没有内置应答者：无头或组合不完整的部署会 resolve 为
unavailable并以拒绝方式关闭；服务自身绝不会提示人类。