展开本页目录
开始前准备什么
- 下载完整练习包，在独立目录阅读README与已执行范围。
- 安装requirements.txt指定版本或使用文中目标工具；依赖与模型权重不要混入网站工程。
- 只有明确标为已执行的部分有本次证据；真实模型、账号或GPU步骤按自己的环境另行验证。
- 把迁移算法与包版本分开
- 将用户范围放进filters
- 先用原创记忆验证作用域
- 显式复现旧默认值
- 在独立Mem0环境迁移
- 比较默认和显式参数
- 交付接口差异和真实回读
1. 把迁移算法与包版本分开
本题V2/V3指官方迁移指南中的记忆算法/接口阶段，不假定pip包一定叫3.x。先保存实际mem0ai版本与当前search签名。
2. 将用户范围放进filters
input.json的新请求把user_id置于filters，另显式写top_k=20、threshold=0.1。legacy反例仍把user_id放顶层，应先定位而不是删掉用户范围。
本题独立目录执行
bash
python reference/audit.py3. 先用原创记忆验证作用域
audit.py在两位虚构用户间筛出M-A，避免升级后把bob记忆混进alice。作者列表筛选不等于真实Mem0搜索。
本题SDK或目标环境入口
bash
python reference/run_sdk.py
4. 显式复现旧默认值
若要比较旧行为，按当前指南显式设top_k=100与合适阈值；不要把结果数量减少直接归因“新算法变差”。
5. 在独立Mem0环境迁移
配置自己的embedding、向量库与LLM，保存迁移前备份；按实际版本执行新接口，不连接已有生产记忆库。
6. 比较默认和显式参数
同一query记录返回ID、分数和过滤条件，补一个错误阈值/参数反例。SDK拒绝旧参数时保留真实错误，不能静默改为无过滤。
7. 交付接口差异和真实回读
把包版本、算法迁移阶段、用户过滤、默认值与实际结果分列。本文只完成参数和作用域基准，没有真实记忆搜索。
怎样确认已经完成
- 没有顶层user_id旧写法残留
- 默认值来自当前指南
- 被拒绝参数不静默忽略
- 已实测mem0ai 2.2.1的Memory.search默认top_k=20/threshold=0.1及顶层user_id拒绝helper；算法V3不等于pip版本3，未运行真实记忆搜索。
常见问题
Mem0从V2升级V3，search接口要改哪些参数？
作用域放入filters，例如filters={user_id:alice}，并显式设置top_k/threshold。真实mem0ai2.2.1 helper拒绝顶层user_id；算法V3不等于pip3.x。
Mem0检索结果变少了，是top_k还是threshold默认值变了？
当前真实Memory.search默认top_k20、threshold0.1，两者都可能改变结果。固定旧参数做对照再分别变化，本文未运行真实记忆搜索。
这篇教程哪些步骤已经真正执行？
已实测mem0ai 2.2.1的Memory.search默认top_k=20/threshold=0.1及顶层user_id拒绝helper；算法V3不等于pip版本3，未运行真实记忆搜索。