如何设计 Agent 状态机?
题目
如何设计 Agent 状态机?
参考答案
点击展开参考答案
- 建议显式定义状态与合法转移,例如:
CREATED → PLANNING → RUNNING → WAITING_TOOL/WAITING_USER/WAITING_APPROVAL → RUNNING → SUCCEEDED/FAILED/CANCELLED/TIMED_OUT状态记录至少包含run_id、state、state_version、attempt、checkpoint、pending_action、reason、created_at/updated_at。 - 设计要求: - 每次转移由事件驱动,并校验当前状态、前置条件和
state_version;通过事务或 CAS 更新,防止并发覆盖,事件发布可配合 outbox。 -
- 转移必须走白名单和 guard,例如只有收到有效审批才能从
WAITING_APPROVAL返回RUNNING,取消可从非终态进入CANCELLED。
- 转移必须走白名单和 guard,例如只有收到有效审批才能从
-
- 状态与事件分离:状态用于快速读取,事件日志用于审计、回放和重建;重试创建新 attempt,不篡改历史事实。
-
- 长任务定期保存 checkpoint;等待用户、工具或外部任务时持久化关联 ID、截止时间并释放计算资源,由回调、超时事件或恢复扫描继续执行。
-
- 取消信号向模型、工具和子任务传播,副作用操作使用幂等键。
-
- 终态不可再次转移或执行副作用,必须固定结束时间和结果摘要;重复事件只能得到同一结果,避免任务“复活”。