迁移 mem0 时,先验证语义,再切流量。

熟悉的操作名可以降低改造成本,但不能证明作用域、推理、分页、错误与删除完全一致。先盘点真实契约,再用脱敏生产轨迹逐步迁移。

  1. 01盘点固定 mem0 版本、调用、默认值、作用域与数据导出。
  2. 02重放在隔离项目中比较写入、历史、检索和下游答案。
  3. 03切换按用户群迁移,并保留旧读路径直到验收结束。
  • 01熟悉的作用域字段
  • 02显式 infer=false
  • 03持久推理事件
  • 04保留回滚

迁移成功的标准不是编译通过,而是持久状态、召回答案、失败行为与回滚都通过验收。

从实际使用的契约开始。

记录客户端与服务版本,以及新增、搜索、列表、更新、删除、历史、过滤、批处理与分页的真实调用。

  • 保存脱敏请求和预期响应。
  • 标记隐式推理与默认限制。
  • 先导出来源数据,再开始转换。

同名字段也要验证所有权。

user_id、agent_id 和 run_id 需要映射到真实产品参与者。已提炼记录关闭推理后导入,需要推理的写入则等待事件终态。

  • 稳定身份和幂等键避免重复。
  • 元数据保留来源系统与原始标识。
  • 不为缺失时间或关系补造事实。

用答案和恢复能力验收。

比较规范记录、历史、搜索排序、下游答案、删除、延迟和失败。观察窗口结束前不要移除旧读取和来源导出。

  • 包含修订、重试和无效输入。
  • 每个拒绝项都保留原因。
  • 退役前测试 FishMem 导出与恢复。

这个产品范围包含什么

  • 契约盘点、字段映射、重放、分批切换与回滚清单。
  • 熟悉的核心记忆操作与显式差异。
  • 用于验收持久状态和下游答案的方法。

明确边界

  • FishMem 与 mem0 没有关联。
  • 不保证每个版本、端点或隐式行为都能无缝替换。
  • 迁移结论必须来自你的实际数据与工作负载。