主题
第 8 章 · Agent 状态存储与语义资产
核心观点 + 逻辑框架（运行篇 · 存储与资产）
▍速览
一句话版（开场，约 20 秒）
Agent 的状态由什么承载？任务事实、工作成果、记忆知识和业务语义四类对象，各有各的存储要求——运行时状态管可恢复，工作区产物管可交付，记忆知识管可复用，本体管可理解。分层承载，但身份、版本、权限与生命周期必须是同一套治理契约。
一段话版（展开，约 60–90 秒）
Agent 的状态放哪。模型和工具负责跑，但任务事实、工作成果、记忆和知识，必须有一个可靠的系统来承载。这里要分清四类对象，要求完全不同。第一，运行时状态，靠事件日志和检查点，管的是任务可恢复：每一步发生了什么按顺序记下来，故障了从最近的检查点接着跑；旧实例要抢回来，用执行租约当接力棒。第二，工作区和产物，管的是成果可交付：工作区分基础层、共享层、可写层，写时复制做快照，正式成果进 Artifact Store，有稳定引用、有版本、不可变。第三，记忆和知识，管的是跨任务复用：记忆从对话和行为里抽取、合并、去重，召回要混合向量和关键词；知识库靠 RAG 检索，复杂关系靠图谱。第四，本体，管的是理解业务世界：对象、关系、动作、规则显式定义，规则和 LLM 协同推理，结论要能解释。最后平台层统一管三件事：多租户隔离要前置到检索之前，权威事实和派生索引分开提交，元数据把血缘、版本、策略绑在一起。选型一句话：分层承载、统一治理——各对象可以用不同引擎，但身份、版本、权限、生命周期必须是一套契约。
- 四类对象：运行时状态｜工作区产物｜记忆知识｜本体语义（要求各不相同）
- 两层架构：底层按特性承载（事务/对象/向量/图）＋上层统一契约（身份·血缘·策略）
- 三组机制：Event Log+Checkpoint+租约（可恢复）｜CoW 快照+Artifact（可交付）｜混合召回+图谱（可复用）
- 一条平台线：隔离前置检索 · 权威与派生分离 · 元数据统一
- 一个选型：组件组合 vs Agent 数据库（Lakebase 一体化，非单一引擎）
一句话（收尾）
当数据的主要读者从人变成 Agent，存储不能只负责保存——它还要让任务可续接、成果可交付、经验可积累、知识可信赖、语义可解释。
▍逻辑框架（记忆卡片）
① 命题：状态外置后的存储职责
连接推理 · 执行 · 协作 · 学习 · Harness 组织控制循环 · Runtime 管理生命周期 · 每次推理与行动都可接续
运行时状态 · 任务可恢复 · 工作区与产物 · 成果可交付 · 记忆与知识 · 跨任务复用 · 本体语义 · 业务可理解
状态不再依附执行实例后，存储不仅要保存数据，还要让每一次推理和行动都可接续；四类对象的生命周期、访问方式、一致性要求各不相同，不能落入同一种存储。
② 分层地图：统一契约下的匹配承载
- 上：四类数据对象 （运行时状态 / 工作区与产物 / 记忆与知识 / 本体语义）
- 其下：统一状态契约与元数据 （统一身份 · 关联关系 · 版本血缘 · 策略绑定；状态读取 / 更新 / 冻结 / 恢复）
- 再下：基础能力 （事务与状态存储 ｜ 对象与文件存储 ｜ 检索与向量 ｜ 关系与图）
- 最底：统一治理与运营 （多租户隔离 · 审计观测 · 生命周期成本 · 备份容灾）
不是让所有状态落入同一种存储 · 每类状态匹配物理承载 · 先定义正确性边界，再选引擎
分层承载、统一治理：各对象可以用不同引擎，但身份、版本、权限、生命周期必须是一套契约。
③ 运行时状态（任务可恢复）
- Event Log：只追加、顺序性强一致 （边界=任务 / 会话 / 业务对象，不必全局串行）；事件与当前状态同事务提交或 Outbox，以事件标识去重；只有含完整状态变更与必要输入才能重放，诊断日志不能替代
- Checkpoint：频率匹配任务成本 （外部调用前后 / 长计算后 / 人工确认前后 / 工作区变更后 / 交接时）；增量快照=完整快照+变化集；恢复点目标以用户视角定义（从哪恢复 · 丢多少 · 是否重复）
- Durable Execution：执行实例可替换；快照+事件重放；执行租约=接力棒（只有持最新租约可提交）+ 围栏标识；状态指针关联任务 / 检查点 / 工作区 / 产物
- ≠恰好一次：外部副作用需幂等标识 + 结果确认 + 补偿
可恢复 = 事件日志 + 检查点 + 租约围栏：故障后从最近检查点接着跑，旧实例靠最新租约抢回提交权。
④ 工作区与产物（成果可交付）
- 分层工作区：基础层（只读可复用）+ 共享层 + 可写层（当前任务独占）（共享不变部分，隔离变化部分；同时是治理边界）——公共层平台维护、可写层归属任务、正式成果显式进产物库
- Copy-on-Write 快照 / 回滚 / 分支：未变化复用、新写入成新块；Checkpoint 记录工作区快照引用，避免"任务状态已恢复、文件状态已变"
- 多副本并发：执行租约管任务状态、围栏管可写层（独占挂载 / 撤销旧端 / 私有分支）；多 Agent 协作显式区分共享与私有边界，合并走版本审批
- Artifact Store：可寻址（稳定引用）、可保留（临时 vs 正式）、可交付；元数据含来源任务 / 版本 / 审批状态 / 权限——是工作区通向语义层的桥梁
可交付 = 分层隔离 + CoW 快照 + 不可变制品引用：正式成果进入产物库后带版本、可追溯、可交付。
⑤ 记忆与知识（跨任务复用）
记忆两维：来源（用户显式 / Agent 行为归纳 / 外部业务事实）× 稳定性（人设层 / 画像层 / 事件偏好层）（Persona 不是经验记忆，由治理方显式维护）
写入：抽取（分什么值得记 / 什么应该忘）→ 合并去重 → 冲突消解（时效性 + 来源可靠度）
召回：多路混合（向量 + BM25 + 实体关系）→ Rerank → 时间衰减 + 类别过滤；长期约束不应因少被调用而淡出；图像 / 音频 / 视频等多模态附件与主记忆共用身份边界、权限策略与检索口径，不为附件另建治理孤岛
遗忘与记住同等重要：归档 / 降权 / 删除是不同操作；删除要连原始记录 / 摘要 / 索引 / 缓存一起处理，防重建重新引入
左：RAG 语义检索 深度文档理解 · 智能切片 · 向量化 · 语义 + 关键词混合检索；原始文档湖库一体存储 · 热点常驻检索库 · 历史文档分层归档；新增 / 变更 / 删除后索引按水位阈值增量重建；DataProbe 受控探查（只读账号 · 授权 Schema）
右：GraphRAG 关系推理 实体关系抽取 · 图谱构建 · 关系遍历 / 模式匹配；经验证的规则启用，处理复杂关联问题
治理：分类分级 · 权限隔离 · 访问审计 · 合规脱敏 · 来源与更新时间可追溯 · 全链路可观测 · 运营监测：召回时延 · 命中率 · 召回相关性 · 冲突积压 · 隐私越权 · 记忆膨胀趋势
统一 Rerank（相关性 + 权威性 + 时效性）→ 答案溯源到文档段落版本；权限过滤覆盖检索到生成全链路。
⑥ 本体（理解业务世界）
对象：是什么 · 关系：有什么关系 · 动作：能做什么 · 规则：应遵循什么
- 找到信息 ≠ 理解信息；三层递进：语义层 → 数据流转层 → 智能决策层
- 责任分离：本体承担语义建模，动作执行由 Runtime 按语义完成，授权决策由治理责任方作出
- 推理：确定性规则 + LLM 结构化上下文协同，结论附带推理路径（关系遍历 / 规则应用 / 上下文参考）供审查"为什么"
- 与记忆知识协同：本体为知识提供骨架、知识为记忆赋予业务语义、记忆驱动本体演进 （受控更新，模型推测不得直接写成组织规则）
- 更新与运维：业务实例数据随业务过程持续更新，对象类型 / 关系定义 / 规则等 Schema 变更走受控流程；本体平台配可视化建模 · 版本管理 · 权限边界 · 导入导出与覆盖率监测，变更可审阅、历史版本可追溯
⑦ 平台化：隔离、一致性与元数据
- 多租户隔离：身份边界贯穿记忆召回、知识检索、文件访问、向量搜索、工具执行全链路；物理 / 逻辑 / 行级三层可组合；语义检索前置过滤——先跨租户召回再过滤=已暴露
- 一致性：权威事实（事件日志 / 元数据 / 关键状态）与派生视图（向量索引 / 图谱投影 / 缓存 / 读副本）分离提交——先可靠提交权威，再异步推索引；知识更新=新版本 → 解析向量化 → 新索引达水位 → 切换流量；一致性还=可解释性（标注引用版本 / 索引时间 / 来源）
- 统一元数据：对象目录 + 血缘（源更新 → 识别受影响下游 → 重算 / 失效 / 审核）+ 策略绑定（访问 / 保留 / 脱敏 / 删除=治理属性；法律保留与不可变审计不自动清理）；成本治理三原则：按知识价值分层 · 为不同对象配置显式保留期 · 减少无效复制与重复计算，长期未命中的索引 / 派生缓存 / 临时副本及时回收
⑧ 选型与容灾
左：组件组合 复用既有设施、按负载扩展；代价=自维护跨组件身份 / 版本 / 更新契约
右：Agent 数据库（Lakebase 一体化） 统一对象模型、服务接口、治理控制面；统一=数据模型与治理界面，非单一底层引擎；短会话轻量场景组件组合仍是合理起点
高可用：按数据对象定义恢复目标——事件 / 检查点=低 RPO；工作区产物=版本可追溯；记忆知识=区分权威源与可重建派生
任务可续接：定位最后确认事件 → 加载检查点 → 校验租约幂等 → 确认外部调用 → 继续 / 重试 / 补偿 / 转人工；容灾能力必须持续演练
▍逻辑全景图 · 图 1 · 四类状态对象分层存储：运行时 / 工作区 / 记忆 / 本体 + Event Log·Checkpoint·租约
状态不再依附执行实例：每类对象匹配物理承载，上层共享同一套身份 · 版本 · 血缘 · 策略契约，底层统一治理。
- 运行时状态（可恢复）
- 工作区产物（可交付）
- 记忆知识（可复用）
- 本体语义（可理解）
- 基础能力 / 中性存储
读法：① 顶部命题卡给出存储职责变化；② 四类对象各配机制与目标（可恢复 / 可交付 / 可复用 / 可理解），向下汇聚到统一契约条；③ 基础能力四引擎按特性匹配承载，最底是统一治理；绿色条给出承载匹配三原则。面试一句话：四类状态对象分层匹配物理承载——Event Log + Checkpoint + 租约保可恢复，CoW + Artifact 保可交付，混合召回 + 图谱保可复用，本体四要素保可理解，身份、版本、权限、生命周期一套契约。
▍逻辑全景图 · 图 2 · 记忆两维三纵召回 + 本体四要素 + Lakebase
记忆从抽取到召回的全链路跨任务复用，本体用四要素建模业务世界，平台在组件组合与 Lakebase 一体化之间按场景权衡。
- 记忆 / 知识
- 本体 / 平台核心
- 检索 / 编排
- 选型 / 风险边界
- 中性流程
读法：左上记忆面板先按来源 × 稳定性两维分类三纵分层，写入走抽取 → 去重 → 冲突消解，召回三路混合 → 统一 Rerank → 衰减过滤；右上本体四要素网格，规则 + LLM 协同推理、路径可解释；底部两条选型路线对比，高可用按对象定恢复目标，续接从最后确认事件与检查点恢复。面试一句话：记忆靠两维分类、三路召回与遗忘治理跨任务复用，本体用对象 / 关系 / 动作 / 规则四要素理解业务世界，平台按场景选组件组合或 Lakebase 一体化，容灾按对象定义恢复目标。
▍书中关键图（SVG 重绘版·示意）① 状态对象与分层存储架构
示意 · 按正文重绘（原书图 8-1）
▍书中关键图（SVG 重绘版·示意）② 长期记忆的分层组织与混合召回
示意 · 按正文重绘（原书图 8-3）。横轴为来源三分类：用户显式表达 · Agent 行为归纳 · 外部业务事实；纵轴为稳定性三层（人设层 · 画像层 · 事件偏好层）。原书图 8-3 横轴原名对话记忆 Dialog Memory / 行为记忆 Behavior Memory。
▍书中关键图（SVG 重绘版·示意）③ RAG 与 GraphRAG 双轨知识检索
示意 · 按正文重绘（原书图 8-4）