这是本章第一条非常重要的工程边界。
有些 Demo 会这样处理:
if risky:
return "请用户确认"
看起来完成了人工确认。
但实际上没有。
因为:
“请确认”
只是一个文本结果。
系统并不知道:
任务现在应该暂停吗?
Tool 执行了吗?
下一步还能不能继续?
用户批准的是哪个动作?
批准后从哪里恢复?
正确做法:Run 状态机必须增加 WAITING_APPROVAL
单独设置 WAITING_APPROVAL,相当于在 Run 的生命周期里增加一个明确的“等人”节点。看一下状态图就能发现,它既不是任务已完成,也不等于工具运行失败。
![图片[1]-核心小节一:为什么 REQUIRE_APPROVAL 必须变成正式状态,而不是一句“请确认”-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1683.png)
实际实现时,拒绝后可以把拒绝信息作为 Observation 交回 Agent,让它选择替代方案;也可以根据策略直接终止。图示中的箭头表达可能的业务分支,最终使用哪一条,应由 Run 状态机与安全策略明确决定。
第 20 节定义的 Run 有:
READY
RUNNING
COMPLETED
FAILED
现在增加:
WAITING_APPROVAL
于是状态转换:
RUNNING
↓
Middleware.require_approval
↓
WAITING_APPROVAL
这个状态意味着:
Main Loop 不继续
pending Tool 不执行
Run 还没结束
等待外部事件
为什么不能仍然保持 RUNNING?
如果状态仍然是:
RUNNING
前端不知道:
是系统正在执行,还是在等用户。
监控系统也会把审批等待时间误算成执行耗时。
更糟的是,某个 Worker 可能继续推进 Main Loop。
所以:
WAITING_APPROVAL
必须是一等公民。
为什么不能直接 COMPLETED?
因为任务还没结束。
比如用户批准后:
git push
还要执行。
甚至执行完以后,Agent 还可能需要:
检查 push 结果
生成最终总结
所以 Approval 不是结束。
它只是:
任务生命周期中的暂停点。
为什么不能直接 FAILED?
因为 require_approval 不是失败。
它只是:
当前必须等一个外部决定。
这和后面可能出现的:
WAITING_INPUT
WAITING_EXTERNAL
概念很接近。
RunStatus 扩展
class RunStatus:
READY = "ready"
RUNNING = "running"
WAITING_APPROVAL = (
"waiting_approval"
)
COMPLETED = "completed"
FAILED = "failed"
这一个状态加入以后,整个 Agent Backend 才真正能表达:
正在工作
和:
正在等人
是两回事。
WAITING_APPROVAL 是否继续计 Timeout?
要区分两类时间。
一种:
execution_timeout
真正 Agent 执行预算。
另一种:
approval_timeout
等待用户的最长时间。
比如:
Agent 最多运行 5 分钟
审批最多等 24 小时
如果混成一个 Timeout,Agent 等用户 10 分钟就会被判运行超时。
所以成熟系统会把:
运行时间
审批等待时间
分开统计。
本章先建立概念。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END

















请登录后查看评论内容