AI Agent Engineering · Week 06
06-02|State、Memory、Database 到底怎么区分
用同一退款案例区分模型 Context、业务 State、可复用 Memory 与事实 Database 的所有权和生命周期。
四个问题,四种数据职责
客户说:“我习惯用西班牙语。昨天批准的 XB-1024 退款为什么还没到账?”系统需要同时处理偏好、退款阶段、订单事实和本轮模型输入。把它们都塞进一个“memory”字段,会失去数据所有权、更新规则与安全边界。
| 问题 | 数据位置 | 例子 |
|---|---|---|
| 模型这一轮需要看到什么? | Context | 当前问题、退款状态摘要、查询证据 |
| 任务进行到哪一步? | State | approved、version、approvalId |
| 哪些信息允许以后复用? | Memory | 已确认语言偏好 es |
| 订单与物流事实是什么? | Business Database | 金额、付款、carrier status |
一张信息归属图
临时组装
本轮模型输入;调用结束可丢弃
业务实例持久化
控制合法下一步;有版本与状态机
选择性长期保留
跨轮可复用偏好或稳定信息;可更正与过期
业务事实真源
订单、支付、物流;通过授权查询
Context:一次运行的工作台
Context 由应用动态组装。它可以包含 State 摘要、Memory 片段和 Database 查询结果,却不拥有这些数据。调用结束后,下一轮会重新选择。
State:任务控制面
State 决定 Workflow 可以接受哪些事件。退款处于 approved 时可以执行幂等退款;处于 rejected 时不能因客户再次要求就直接执行。State 更新必须通过 transition validator。
Memory:跨运行复用的选择性信息
Memory 适合保存已确认、未来可能有用且允许保留的信息,例如首选语言、沟通渠道或明确的无障碍需求。它需要来源、写入理由、作用域、更新时间、过期和删除机制。
Database:业务事实真源
订单金额、付款状态和物流事件属于业务 Database。即使昨天的对话里提过金额,今天仍应按授权通过 Tool 查询当前事实。Memory 不应复制可能变化的余额和订单状态。
Customer Turn
↓
Context Builder
↙ ↓ ↘
State Store Memory Store Business Tools / DB
↘ ↓ ↙
Authorized, task-fit Context
↓ model output
候选事件 → State validator;候选记忆 → Memory write policy
用所有权处理冲突
如果 Memory 说客户偏好西班牙语,而当前消息明确要求英文,本轮 Context 可以优先当前请求,但不一定永久覆盖 Memory。若聊天摘要说退款已完成,而 State 仍为 approved,业务动作必须信任 State;必要时查询支付 Database 确认。
State + Database
Current input + verified evidence
Current instruction, then scoped Memory
Trace;不能拿来执行业务
Failure Lab
把全部聊天历史称为 Memory
为什么诱人: 历史确实能让下一轮看起来“记得”。
为什么失败: 历史包含过期事实、噪声和敏感内容,没有选择、作用域与生命周期。
更合理设计: 原始历史单独保存;Context 选择必要消息;Memory 只保存通过写入策略的信息。
把订单状态复制进长期 Memory
为什么诱人: 下次不必再次查询,响应更快。
为什么失败: 订单状态会变化,缓存副本可能驱动错误退款或物流回复。
更合理设计: Memory 可保存订单引用,当前事实仍从授权 Tool / Database 读取。
用 State Store 保存整份客户画像
为什么诱人: Workflow 已经有持久化能力。
为什么失败: 退款实例生命周期结束后,偏好与多个任务难以共享;删除和权限也混在流程里。
更合理设计: State 只保存完成当前业务流程所需内容,跨任务信息进入有独立策略的 Memory Store。
实践:给 12 条信息分配真源
把客户语言偏好、订单金额、退款状态、最新消息、审批 ID、物流更新时间、模型摘要等信息逐项分配到 Context、State、Memory、Database 或 Trace,并说明读取和写入规则。
Acceptance Criteria
- ☐ 每条信息只有一个明确真源。
- ☐ Context 被描述为组装结果,不是持久仓库。
- ☐ State 只通过合法 Transition 更新。
- ☐ Memory 有作用域、来源、更新时间和删除规则。
- ☐ 订单、支付、物流事实继续由业务 Database 拥有。
- ☐ 模型不能直接写四类存储。
- ☐ 数据冲突时能按当前决策责任选择真源。
主动回忆
- Context 为什么可以包含 State,却不能替代 State?
- 哪类信息适合长期 Memory?
- 昨天对话里的订单状态为什么不能作为今天的事实?
- 模型提出“记住这个偏好”后还需要什么?
下一课进一步区分 Short-term 与 Long-term Memory:保存多久只是一个维度,更重要的是作用域、压缩、更新和遗忘策略。
延伸阅读 / Sources
核查日期:2026-10-18。
- OpenAI Agents SDK:Sessions。用于核对对话 Session 历史的当前实现与边界。
- OpenAI Agents SDK:Agent memory。用于核对可跨运行复用的 Memory 与会话历史的区分。
- PostgreSQL:Current Documentation。用于核对业务 Database 作为持久事实存储的基本能力。
长期有效的原理: Context 是选择,State 是任务控制,Memory 是选择性复用,Database 是业务事实真源。当前实现方式: SDK 可能把 Session 称为 memory,设计文档仍应写明具体保存内容、真源和生命周期。