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

AI Agent Engineering · Week 05

05-04|实战:构建退款售后 Workflow

完成 Support Agent V0.5:把退款资格、审批、执行和通知组织成可恢复、可幂等验收的 Workflow。

实战 · Refund Workflow · V0.5

Business Goal

客户提出退款后,系统要查询授权订单、计算资格、等待必要审批、执行教学 Mock 退款并留下可恢复记录。Agent 继续负责理解诉求和解释结果,Workflow 掌握业务状态与副作用。

完成后得到 Support Agent V0.5 Workflow + State。本课不连接真实支付系统,退款执行使用幂等 Mock。

Current Architecture

Customer → Intent V0.1 → Loop V0.2 → Tools V0.3 → MCP Integration V0.4

系统已经能取得订单事实,但退款仍没有持久状态、合法转移和审批等待。

This Lesson Change

refund_requested
↓ order facts via V0.4
eligibility_checked
↙ rejected       eligible ↘
rejected   waiting_for_approval
              ↓ approved / rejected
         approved → refund_execution
              ↓ idempotent Mock
            refunded
图 1|V0.5 把订单查询、规则、审批和副作用串成可恢复流程。

Codex Task

为 Cross-border AI Support Agent 实现 V0.5 refund workflow。

输入:V0.1 refund intent、可信 customer/tenant、orderId、requestedAmount。
复用:V0.2 Loop/Trace、V0.3 Tool Contract、V0.4 Order integration。

要求:
- 持久化退款实例与 version。
- 状态限定为 refund_requested, eligibility_checked,
  waiting_for_approval, approved, rejected, refunded, failed。
- 资格检查使用确定规则;Agent 不决定资格。
- 高金额或规则命中时进入 waiting_for_approval。
- 审批事件必须来自可信 Mock approval service。
- Mock refund 使用稳定 idempotency key。
- timeout 有有限重试;unauthorized 与非法 transition 立即停止。
- 记录 transition history、requestId 和 stop reason。
- 不连接生产支付,不修改订单原始事实。

实现前报告状态表、文件范围与恢复策略;实现后运行测试和标准验证。

State / Event Contract

{
  "refundId": "RF-XB-1024-01",
  "orderId": "XB-1024",
  "status": "waiting_for_approval",
  "version": 3,
  "requestedAmount": 49.9,
  "eligibilityDecisionId": "EL-7",
  "approvalId": "AP-9",
  "idempotencyKey": "refund:RF-XB-1024-01:v1"
}

订单金额和物流状态继续从业务 Tool 查询;Workflow State 保存引用与当次决策结果,不复制整份业务数据库。

Expected Inputs / Outputs

Eligible / low risk

自动进入 approved,再执行 Mock

Approval required

保存 waiting_for_approval 并暂停

Rule rejected

进入 rejected,保存原因码

Duplicate request

返回已有 refundId,不新建实例

Provider timeout

同一幂等键有限重试

Unauthorized

停止且不创建退款实例

图 2|每个结果都落到可恢复状态;“正在处理”不能代替业务状态。

Test Cases

  1. 符合资格且无需审批:最终 refunded。
  2. 高金额:暂停在 waiting_for_approval,重启后可恢复。
  3. 审批拒绝:进入 rejected,退款 handler 从未执行。
  4. 同一客户重复提交:返回同一 refundId。
  5. Mock 执行成功但响应超时:复用 idempotency key,不重复退款。
  6. 伪造审批事件:拒绝 transition。
  7. 并发审批与取消:version 冲突必须显式处理。
  8. 任意非法状态跳转:记录错误,不静默修复。

Agent 理解与解释
↓ event proposal
Workflow Runtime 验证 State / Transition
↓
Rules + Approval 产生可信决定
↓
Idempotent Refund Handler 执行副作用
↓
State + Transition History

图 3|每一层都有明确证据;Agent 的自然语言不能跳过状态机。

Failure Lab

用聊天 Session ID 当 refundId

为什么诱人: 已经有现成 ID,可以少建一个实体。

为什么失败: 一次对话可能包含多笔退款,一笔退款也可能跨多个渠道继续。

更合理设计: 退款使用独立业务 ID,聊天只保存关联引用。

审批后重新运行资格规则并覆盖历史

为什么诱人: 希望使用最新数据。

为什么失败: 无法解释审批基于哪个版本,规则变化还可能改变已批准流程。

更合理设计: 保存决策引用与版本;需要重审时产生明确的新事件。

Mock 成功就省略幂等测试

为什么诱人: Mock 不会真的重复扣款。

为什么失败: 接真实 Provider 后最危险的恢复路径从未被验证。

更合理设计: Mock 记录 key 与执行次数,测试响应丢失和重复命令。

Acceptance Criteria

  • ☐ State、Event、Transition Table 已实现并有测试。
  • ☐ V0.4 订单事实通过已有 Tool / MCP 边界取得。
  • ☐ 资格判断确定、可复现,Agent 无法覆盖。
  • ☐ waiting_for_approval 可跨进程恢复。
  • ☐ 审批来源和身份经过校验。
  • ☐ Mock refund 幂等,重复调用只产生一次效果。
  • ☐ Retry、Timeout、并发冲突和非法转移均有测试。
  • ☐ Trace 能重建完整状态演进与责任主体。
  • ☐ 未连接生产支付系统。
  • ☐ TypeScript、lint、测试与 production build 通过。

Architecture After This Lesson

Support Agent V0.5
  Intent V0.1 → Loop V0.2 → Tools V0.3 → MCP V0.4
                                      ↓
                         Refund Workflow + State V0.5
                         Rules → Approval → Idempotent Mock

Week 05 完成。下一周处理模型每一轮能看到什么,以及 State、Memory 和业务 Database 为什么必须保持不同职责。

延伸阅读 / Sources

核查日期:2026-10-18。

长期有效的原理: 业务实体独立、状态转移可验证、等待可恢复、副作用幂等。当前实现方式: 本课使用教学存储与 Mock;接入真实 Workflow / Payment Provider 前要重新完成授权和恢复测试。