核心小节一:为什么 REQUIRE_APPROVAL 必须变成正式状态,而不是一句“请确认”

这是本章第一条非常重要的工程边界。

有些 Demo 会这样处理:

if risky:
    return "请用户确认"

看起来完成了人工确认。

但实际上没有。

因为:

“请确认”

只是一个文本结果。

系统并不知道:

任务现在应该暂停吗?
Tool 执行了吗?
下一步还能不能继续?
用户批准的是哪个动作?
批准后从哪里恢复?

正确做法:Run 状态机必须增加 WAITING_APPROVAL

单独设置 WAITING_APPROVAL,相当于在 Run 的生命周期里增加一个明确的“等人”节点。看一下状态图就能发现,它既不是任务已完成,也不等于工具运行失败。

图片[1]-核心小节一:为什么 REQUIRE_APPROVAL 必须变成正式状态,而不是一句“请确认”-大赛人网

实际实现时,拒绝后可以把拒绝信息作为 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
喜欢就支持一下吧
点赞11 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容