AI Agent Engineering · Week 05
05-03|State:系统怎么知道任务进行到哪里
用退款状态机理解业务 State、Event、Transition、Invariant 与恢复位置。
“客户提过退款”不足以恢复流程
聊天里出现过退款、客服回复过“正在处理”,都不能证明业务当前处于哪个节点。系统需要一份可验证的 State:当前状态、版本、相关事实、最后事件和允许的下一步。
State 是某个业务实例在当前时刻的可恢复快照。Event 表示发生了什么,Transition 定义当前 State 收到该 Event 后能否移动到新 State。
退款状态机
refund_requested
↓ eligibility_passed
eligibility_checked
↓ approval_required
waiting_for_approval
↙ approval_rejected approval_granted ↘
rejected approved
↓ refund_succeeded
refunded
State 里保存什么
一个退款实例可以保存 refundId、orderId、customerId、status、version、requestedAmount、资格检查结果引用、审批引用、执行结果引用与时间戳。订单完整详情仍在业务数据库,通过 ID 和 Tool 查询。
Transition 还要检查 Invariant
从 waiting_for_approval 到 approved 必须有有效审批事件;从 approved 到 refunded 必须有幂等执行结果。Invariant 是任何转移都不能破坏的规则,例如退款金额不能超过可退金额、终态不能被普通事件重新打开。
按 ID + version 读取
类型、来源、去重
当前状态允许?
金额、授权、审批
原子写入新状态
记录事件与下一任务
业务状态与聊天历史
| 数据 | 例子 | 用途 |
|---|---|---|
| Business State | waiting_for_approval | 恢复流程、限制转移 |
| Conversation History | 客户说“我很着急” | 理解语气与前文 |
| Business Fact | 订单金额、物流状态 | 由数据库 / Tool 提供 |
| Trace | Agent 选择过哪些动作 | 调试与审计 |
聊天历史可以帮助组织回复,却不能作为“已经批准”的凭证。状态记录应引用审批系统产生的事件和身份。
“客服说正在退款” → 可能已申请、待审批或已执行。
waiting_for_approval + approvalId + version → 下一步唯一可判断。
Failure Lab
只保存一个 completed: true/false
为什么诱人: 字段简单,页面也容易显示。
为什么失败: 无法区分待资格检查、待审批、执行中和失败恢复,重启后不知道从哪里继续。
更合理设计: 使用有限业务状态和明确终态,并保存必要引用。
让 LLM 输出新状态并直接写库
为什么诱人: 模型已经理解客户意图。
为什么失败: 它可能跳过审批、生成不存在状态或覆盖并发更新。
更合理设计: 模型只提出事件或候选动作;transition validator 完成确定写入。
忽略重复和乱序事件
为什么诱人: 测试环境里每个事件只来一次。
为什么失败: Webhook 重投与网络延迟会让旧审批覆盖新状态,或重复触发退款。
更合理设计: 使用 event ID、版本检查、终态保护和幂等 handler。
实践:写出退款 Transition Table
列出每个 State 可接受的 Event、前置条件、新 State、副作用、重复事件行为和非法事件结果。至少覆盖审批先到、重复到达与退款响应晚到。
Acceptance Criteria
- ☐ 状态集合有限且命名表达业务含义。
- ☐ 每个 Transition 有事件、前置条件和新状态。
- ☐
approved只能由可信审批事件进入。 - ☐
refunded有 provider 结果和幂等键引用。 - ☐ 重复、乱序和并发事件有预定行为。
- ☐ 聊天历史不能直接改变业务 State。
- ☐ 系统重启后能仅凭 State 与引用恢复下一步。
主动回忆
- State、Event 与 Transition 分别是什么?
- 为什么 State 不应保存整份订单对象?
- Invariant 在哪个环节检查?
- 聊天中出现“已批准”为什么不能推进状态?
下一课把状态机、确定流程、Agent 入口和 V0.4 外部查询组合起来,完成可恢复的退款售后 Workflow V0.5。
延伸阅读 / Sources
核查日期:2026-10-18。
- Amazon States Language Specification。用于核对状态、转移、终态与错误处理概念。
- Temporal:Workflow。用于核对持久执行与恢复语义。
- PostgreSQL:Transaction Isolation。用于核对并发状态更新需要处理的数据库语义。
长期有效的原理: 有限状态、合法转移、业务不变量与并发保护。当前实现方式: 状态机库、Workflow 引擎和存储方案可替换,Transition Table 是业务真源。