AI Agent Engineering · Week 05
05-04|实战:构建退款售后 Workflow
完成 Support Agent V0.5:把退款资格、审批、执行和通知组织成可恢复、可幂等验收的 Workflow。
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
↓ order facts via V0.4
eligibility_checked
↙ rejected eligible ↘
rejected waiting_for_approval
↓ approved / rejected
approved → refund_execution
↓ idempotent Mock
refunded
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
自动进入 approved,再执行 Mock
保存 waiting_for_approval 并暂停
进入 rejected,保存原因码
返回已有 refundId,不新建实例
同一幂等键有限重试
停止且不创建退款实例
Test Cases
- 符合资格且无需审批:最终
refunded。 - 高金额:暂停在
waiting_for_approval,重启后可恢复。 - 审批拒绝:进入
rejected,退款 handler 从未执行。 - 同一客户重复提交:返回同一 refundId。
- Mock 执行成功但响应超时:复用 idempotency key,不重复退款。
- 伪造审批事件:拒绝 transition。
- 并发审批与取消:version 冲突必须显式处理。
- 任意非法状态跳转:记录错误,不静默修复。
Agent 理解与解释
↓ event proposal
Workflow Runtime 验证 State / Transition
↓
Rules + Approval 产生可信决定
↓
Idempotent Refund Handler 执行副作用
↓
State + Transition History
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。
- Temporal:Workflow。用于核对可恢复等待与持久 Workflow。
- Stripe:Idempotent requests。用于核对退款类副作用的幂等实践。
- PostgreSQL:Transaction Isolation。用于核对并发更新与版本冲突。
长期有效的原理: 业务实体独立、状态转移可验证、等待可恢复、副作用幂等。当前实现方式: 本课使用教学存储与 Mock;接入真实 Workflow / Payment Provider 前要重新完成授权和恢复测试。