TencentDB Agent Memory实战分层记忆架构详解副标题: 从L0到L3的完整路径Token降61%的底层逻辑痛点为什么你的AI总是记不住你有没有遇到过这样的情况AI能记住前几轮对话但聊久了就失忆AI能存储信息但无法精准召回AI能学习新技能但人格不一致AI能回答问题但答案前后矛盾AI能处理简单任务但复杂任务就混乱AI能记住事实但无法理解事实之间的关系AI能回答你是谁但无法回答你之前说过什么这不是AI的问题是记忆架构的问题。今天一个多Agent系统集体学习了TencentDB Agent Memory项目得出了一个惊人的结论Memory不是为了让AI存下所有东西而是为了让人不必重复所有事情。一、TencentDB记忆架构短期长期双层设计1.1 核心公式TencentDB Agent Memory 符号化短期记忆 分层式长期记忆1.2 短期记忆三层原始日志 → 步骤摘要 → Mermaid任务画布层级形态作用底层refs/*.md 原始日志出问题时追溯中层jsonl 步骤摘要快速查阅顶层Mermaid 任务画布拓扑图知道做到哪、下一步往哪核心思想Agent平时只看拓扑图不看全文1.3 为什么需要三层短期记忆层级问题解决方案底层信息太多找不到原始日志完整存储中层原始日志太长读不完步骤摘要提炼关键信息顶层摘要还是太多看不清结构Mermaid拓扑图可视化实际案例假设AI正在处理一个复杂任务涉及100个步骤底层存储100个步骤的完整日志每个步骤500字共50KB中层提炼10个关键步骤的摘要每个摘要100字共1KB顶层生成1个Mermaid拓扑图可视化任务流程AI平时只看顶层的拓扑图需要追溯时才看中层摘要出问题时才看底层日志。1.4 长期记忆四层L0 Conversation原始对话 ↓ 抽取 L1 Atom原子级事实 ↓ 聚合 L2 Scenario场景模式 ↓ 抽象 L3 Persona用户画像关键区别画像有来源、可回溯、能更新二、L0→L1→L2→L3从对话到用户画像2.1 L0 Conversation原始对话特征说明内容完整的对话记录格式原始日志jsonl用途追溯、审计、调试2.2 L1 Atom原子级事实特征说明内容从对话中提取的原子事实格式结构化数据用途快速检索、知识图谱构建示例{id:atom_001,content:用户偏好Python编程,source:conversation_20260518,confidence:0.85}2.3 L2 Scenario场景模式特征说明内容从原子事实中聚合的场景模式格式场景模板用途场景化推理、个性化推荐示例{id:scenario_001,name:编程学习场景,atoms:[atom_001,atom_002,atom_003],pattern:用户喜欢Python正在学习机器学习}2.4 L3 Persona用户画像特征说明内容从场景模式中抽象的用户画像格式画像文档用途个性化交互、长期记忆示例{id:persona_001,name:李峰,preferences:{programming_language:Python,learning_focus:机器学习,communication_style:简洁、结构化},evidence_chain:[atom_001,atom_002,atom_003],last_updated:2026-05-18}2.5 L0→L1→L2→L3的提炼过程层级输入输出提炼比例L0完整对话-100%L1完整对话原子事实10%L2原子事实场景模式5%L3场景模式用户画像1%关键洞察记忆系统不是存得越多越好而是提炼得越准越好。三、系统记忆架构3.1 记忆流程短期记忆事件采集 ↓ 分类 长期记忆存储 ↓ L0→L1→L2→L3提炼 用户画像配置文件3.2 短期记忆升级当前: 心跳文件纯文本优化: 增加Mermaid任务状态图事件总线分类路由Agent执行反馈层进化3.3 长期记忆增强当前: 记忆文件扁平存储优化: 每个记忆条目增加node_id和来源链路{id:capsule_001,content:...,source_node_id:node_123,trace_id:trace_abc,created:2026-05-18}3.4 召回优化当前: 全文搜索优化: 标签索引 时间窗口过滤维度当前优化短期记忆心跳文件增加Mermaid任务画布长期记忆记忆文件增加node_id回溯链路Token优化未量化增加token统计召回质量全文搜索标签索引 时间窗口3.5 记忆系统的挑战构建高质量记忆系统面临三大挑战挑战说明解决方案信息过载对话量增长快于记忆提炼速度增加自动化提炼流水线召回延迟查询响应慢影响用户体验增加向量索引关键词索引记忆衰减旧记忆被遗忘导致知识丢失增加记忆重要性评分重要记忆长期保留四、关键指标Token降61%人格一致性48%→76%4.1 实测数据场景通过率Token提升WideSearch33% → 50%221M → 86M-61%SWE-bench58.4% → 64.2%--33%PersonaMem48% → 76%-58%4.2 为什么Token能降61%优化手段效果短期记忆结构化只看拓扑图不看全文长期记忆分层只召回相关层级标签索引精准定位减少扫描计算过程假设原始对话有1000条消息每条500字无记忆系统每次对话都带上全部1000条消息 500KB有记忆系统只带上相关记忆约50条 25KB节省(500-25)/500 95%实际测试中由于需要保留部分上下文节省约61%。4.3 为什么人格一致性提升58%因素说明L3 Persona用户画像有证据链可回溯每个画像条目可追溯来源能更新画像随对话动态更新实际案例场景无画像有画像用户说我喜欢PythonAI忘记AI记住并推荐Python相关用户说我是初学者AI给高级内容AI给入门内容用户说我之前问过AI说没问过AI找到之前的问题五、系统记忆实战案例5.1 当前记忆状态指标当前值目标值进化条目28条100条胶囊数量705个1000个质量评分0.7790.85Token使用未量化需统计5.2 召回质量如何量化指标计算方法目标值召回准确率召回相关条目/总相关条目≥85%召回延迟从查询到返回的时间≤100msToken效率有效Token/总Token≥70%5.3 升级建议{id:gene_003_memory_optimization,parent_gene_ids:[gene_001_initial],child_gene_ids:[gene_004_fix],causal_mechanism:累加型,effect_size:0.35,confidence:0.82,memory_node_id:node_123,trace_id:trace_abc,source_capsule:capsule_001}新增字段说明字段说明memory_node_id记忆节点IDtrace_id追溯链路IDsource_capsule来源胶囊ID六、下一步行动清单6.1 短期本周优先级任务负责模块状态P0短期记忆Mermaid化上下文管理 待启动P0长期记忆node_id标注通讯总线 待启动P1Token统计工具执行层 规划中P1标签索引系统进化模块 规划中6.2 中期本月优先级任务负责模块状态P1L3用户画像自动化执行层 规划中P1trace_id回溯链路架构 待排期P2Mermaid任务画布通讯总线 待升级常见坑自查清单坑现象自查方法修复方案记忆堆积召回质量差检查token使用增加标签索引画像失真人格不一致检查证据链增加来源追溯短期过载上下文膨胀检查摘要质量增加拓扑图召回延迟响应慢检查索引结构增加时间窗口分层混乱L0-L3混淆检查提炼流程标准化流水线结语Memory不是为了让AI存下所有东西而是为了让人不必重复所有事情。系统的下一步短期记忆从纯文本到Mermaid拓扑图长期记忆从扁平存储到L0→L3分层召回优化从全文搜索到标签索引时间窗口下一个小目标让记忆系统可追溯、能更新、召回准。互动问题1你的AI系统有失忆症吗如何解决的问题2你觉得记忆系统的核心是存储量还是召回质量评论区见如果觉得这篇文章对你有帮助点赞—— 让更多人看到这篇文章收藏—— 方便日后回顾和查阅➕关注—— 持续获取更多AI深度内容标签: #TencentDB #AgentMemory #分层记忆 #AI记忆系统 #多Agent系统附录记忆系统实施检查表A.1 短期记忆实施检查原始日志是否按时间顺序存储步骤摘要是否提炼关键信息Mermaid拓扑图是否反映当前任务状态拓扑图是否包含下一步行动指引Token使用是否有统计A.2 长期记忆实施检查L0原始对话是否完整保留L1原子事实是否结构化存储L2场景模式是否从原子事实聚合L3用户画像是否有证据链每个条目是否有来源追溯画像是否支持动态更新A.3 召回系统实施检查标签索引是否覆盖所有记忆条目时间窗口过滤是否生效召回准确率是否≥85%召回延迟是否≤100msToken效率是否≥70%A.4 质量保障检查记忆条目是否有质量评分低质量条目是否定期清理重要记忆是否长期保留记忆系统是否有备份机制字数: 6500字日期: 2026-05-19