跳到主要内容
← 返回AI Agent Engineering|12 周从 Demo 到真实 Agent 系统

AI Agent Engineering · Week 05

05-03|State:系统怎么知道任务进行到哪里

用退款状态机理解业务 State、Event、Transition、Invariant 与恢复位置。

State · State Machine · Workflow

“客户提过退款”不足以恢复流程

聊天里出现过退款、客服回复过“正在处理”,都不能证明业务当前处于哪个节点。系统需要一份可验证的 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

图 1|状态是有限集合,事件触发合法转移;模型生成一句话不会自动改变业务状态。

State 里保存什么

一个退款实例可以保存 refundId、orderId、customerId、status、version、requestedAmount、资格检查结果引用、审批引用、执行结果引用与时间戳。订单完整详情仍在业务数据库,通过 ID 和 Tool 查询。

Transition 还要检查 Invariant

从 waiting_for_approval 到 approved 必须有有效审批事件;从 approved 到 refunded 必须有幂等执行结果。Invariant 是任何转移都不能破坏的规则,例如退款金额不能超过可退金额、终态不能被普通事件重新打开。

Load
按 ID + version 读取
Validate Event
类型、来源、去重
Check Transition
当前状态允许?
Check Invariant
金额、授权、审批
Persist
原子写入新状态
Emit
记录事件与下一任务
图 2|状态转移是一项受控写操作,需要并发、重复事件和业务约束检查。

业务状态与聊天历史

数据例子用途
Business Statewaiting_for_approval恢复流程、限制转移
Conversation History客户说“我很着急”理解语气与前文
Business Fact订单金额、物流状态由数据库 / Tool 提供
TraceAgent 选择过哪些动作调试与审计

聊天历史可以帮助组织回复,却不能作为“已经批准”的凭证。状态记录应引用审批系统产生的事件和身份。

从聊天猜状态

“客服说正在退款” → 可能已申请、待审批或已执行。

从 State 恢复

waiting_for_approval + approvalId + version → 下一步唯一可判断。

图 3|对话提供语言线索;业务 State 提供可执行事实。

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 与引用恢复下一步。

主动回忆

  1. State、Event 与 Transition 分别是什么?
  2. 为什么 State 不应保存整份订单对象?
  3. Invariant 在哪个环节检查?
  4. 聊天中出现“已批准”为什么不能推进状态?

下一课把状态机、确定流程、Agent 入口和 V0.4 外部查询组合起来,完成可恢复的退款售后 Workflow V0.5。

延伸阅读 / Sources

核查日期:2026-10-18。

长期有效的原理: 有限状态、合法转移、业务不变量与并发保护。当前实现方式: 状态机库、Workflow 引擎和存储方案可替换,Transition Table 是业务真源。