AI Agent Engineering · Week 06
06-04|实战:让客服 Agent 拥有连续业务上下文
完成 Support Agent V0.6:跨轮恢复退款任务、选择必要 Context、复用合规偏好,同时继续从 Tool 获取业务事实。
Business Goal
客户第一天申请退款,第二天换一个新会话问“批准了吗?”,第三天要求以后使用西班牙语。系统需要恢复同一退款任务、查询最新事实并在允许范围内记住沟通偏好,不能靠重放全部聊天猜测状态。
完成后得到 Support Agent V0.6 Context + Memory:连续服务来自 Context Builder、Workflow State、Memory Policy 和业务 Tool 的协作。
Current Architecture
V0.5 Refund Workflow + State
能恢复业务流程
但每次 Agent Run 的 Context 仍缺少统一选择策略
This Lesson Change
↓
Task Resolver|找到 ticketId / refundId
↓
Context Builder
↙ ↓ ↘
Workflow State Selected Memory Business Tools / DB
↘ ↓ ↙
Task-fit Model Context
↓
Agent Decision → Validated Event / Reply
Codex Task
在 Support Agent V0.5 上实现 V0.6 continuous context。
新增:
- Context Builder:按当前任务组装 instructions、current input、
workflow state、verified tool evidence、selected memory、output contract。
- Short-term session store:保存当前 ticket 的必要消息与带引用摘要。
- Long-term preference store:仅保存已确认 language preference。
- Memory write policy:source、scope、updatedAt、reviewAt、delete。
约束:
- refund status 必须来自 V0.5 State;订单/支付事实必须通过 Tool 查询。
- 不把全部聊天历史自动注入 Context。
- 不把订单状态写入 Long-term Memory。
- 所有读取按 tenant/customer 授权。
- 模型只提出 state event 或 memory candidate,不能直接写库。
- Context Trace 记录选了什么、为什么选、来自哪里;敏感值脱敏。
实现前报告数据模型、读取顺序和文件范围;实现后运行测试与标准验证。
Context Contract
{
"task": { "ticketId": "TK-7", "refundId": "RF-9" },
"workflow": { "status": "waiting_for_approval", "version": 3 },
"currentInput": "¿Ya fue aprobado?",
"memory": [{ "type": "language_preference", "value": "es" }],
"evidence": [{ "source": "approval_mock", "status": "pending" }],
"allowedActions": ["reply", "check_approval", "escalate"]
}
这里只包含模型做当前决定需要的信息。完整审批记录、订单对象、历史 Trace 和其他工单留在各自存储。
Expected Multi-turn Scenarios
- DAY 1客户申请退款创建 refundId;State=waiting_for_approval
- DAY 2新会话问进度按身份找到 refundId;查询审批;不重放全部历史
- DAY 3确认语言偏好写入 scoped Memory;当前回复使用西班牙语
- LATER订单状态变化重新调用 Tool;不信任旧 Memory
Test Cases
- 新会话携带同一可信客户身份,能恢复正确 refundId 与 State。
- 其他客户提供 refundId,不能读取任何状态。
- Short-term 摘要遗漏关键信息时,能通过引用回查必要消息。
- 已确认西班牙语偏好进入下一会话;一次临时英文请求只覆盖当前轮。
- Memory 中伪造订单状态不会进入业务回复。
- Tool 返回更新物流状态时,旧对话摘要不会覆盖新事实。
- Memory 删除后,新 Context 不再包含该偏好。
- Context 超过预算时按优先级裁剪,并保留 Workflow State 与关键证据。
安全指令、当前请求、Workflow State
完成当前决定所需 Tool 证据
相关 Memory 与最近必要消息
无关历史、重复 Tool payload、旧日志
Failure Lab
用 customerId 直接加载全部历史
为什么诱人: 一个查询就能获得完整上下文。
为什么失败: 多个工单相互污染,敏感信息扩大暴露,当前任务难以定位。
更合理设计: 先解析 ticket / workflow 实例,再读取该任务必要历史与 scoped Memory。
摘要写着“退款已批准”就推进 Workflow
为什么诱人: 摘要已经在 Context 中,读取方便。
为什么失败: 摘要不是可信审批事件,可能过期或生成错误。
更合理设计: Workflow 只接受审批服务事件;摘要只帮助理解对话。
把 Context Trace 记录成完整 Prompt
为什么诱人: 调试时信息最全。
为什么失败: 日志会复制客户隐私、Tool 数据和潜在敏感指令。
更合理设计: 记录来源 ID、选择理由、Token 统计和脱敏摘要;敏感正文按权限单独保存。
Acceptance Criteria
- ☐ 新会话能按可信身份恢复正确退款任务。
- ☐ Workflow State、Memory 与 Database / Tool 有独立存储和读取路径。
- ☐ Context Builder 只选择当前决定所需信息。
- ☐ Short-term 摘要保留证据引用和过期规则。
- ☐ Long-term 仅保存已确认语言偏好,支持更正与删除。
- ☐ 订单、退款执行和审批事实不会写入 Memory 取代真源。
- ☐ 跨租户和跨客户读取测试均被拒绝。
- ☐ Context 预算、裁剪优先级和脱敏 Trace 有测试。
- ☐ V0.1~V0.5 的接口、Stop Condition 与权限约束继续生效。
- ☐ TypeScript、lint、测试与 production build 通过。
Architecture After This Lesson
Support Agent V0.6
Structured Intent V0.1
→ Agent Loop V0.2
→ Tools V0.3
→ API / MCP V0.4
→ Refund Workflow + State V0.5
→ Context Builder + Scoped Memory V0.6
Business facts remain in authorized Databases / Tools.
Week 06 完成。下一周将加入 RAG:企业政策和知识文档怎样被检索、引用与评估,同时继续保持业务事实、Memory 和知识证据的边界。
延伸阅读 / Sources
核查日期:2026-10-18。
- OpenAI API:Conversation state。用于核对跨轮输入与服务端状态延续方式。
- OpenAI Agents SDK:Sessions。用于核对当前会话持久化实现及其信任边界。
- OpenAI Agents SDK:Agent memory。用于核对跨运行 Memory 与 Session history 的区分。
长期有效的原理: 先定位任务,再从各自真源选择最小 Context;任何持久写入都经过独立策略。当前实现方式: Session、conversation 和 Memory API 会变化,V0.6 通过项目自己的 Context Contract 保持可迁移。