项目详情

Mem0

AI Agent 的通用记忆层——7K token 搞定长程记忆

GitHub 地址 Apache-2.0 TypeScriptPython

更新于 2026-07-20

← 返回汇总
项目速览

一句话定位

AI Agent 的通用记忆层——7K token 搞定长程记忆

Agent Memory 赛道 Star 数最高的开源项目(61.3k)。v3 算法用 ADD-only 单次提取 + 语义/BM25/实体/时态四路检索融合,7K token 即达 LongMemEval 94.4% 精度(全量上下文需 25K+)。支持 Python/TS/Go/Rust SDK、自托管 Docker、云平台三种部署,AWS Agent SDK 官方集成,arXiv 论文背书。

项目速览

核心数据

61.3k
GitHub Stars
7.1k
Forks
94.4%
LongMemEval
7K
Token / 检索
为什么存在

Agent 记忆的三个痛点

上下文窗口不够用

多轮对话 + 多会话积累后,原始 chat history 轻松超上下文上限。全量塞入 25K+ token,贵且慢。

旧信息被覆盖丢失

传统 UPDATE/DELETE 模式在信息变化时覆写旧事实,丢失"用户偏好如何演变"的时间线索。

缺乏跨会话连续性

Agent 每次对话从零开始,无法记住用户偏好、历史决策、待办事项——每次都是"新用户"。

核心算法

v3:ADD-only 提取 —— 只增不改不删

核心理念:记忆只累加,不覆写。信息变化时新旧事实共存,保留完整时间线索。单次 LLM 调用完成提取——无 agentic 循环、无多轮协商。

设计决策传统做法Mem0 v3
写入模式ADD + UPDATE + DELETE仅 ADD
提取方式多轮 agentic 循环单次 LLM 调用
Agent 事实忽略或次优先级一等公民,同等权重
实体处理文本匹配实体提取 + 嵌入 + 跨记忆链接
检索信号仅语义相似度语义 + BM25 + 实体 + 时态四路融合
架构

提取流水线:六阶段蒸馏

1. 存储新记忆 2. 上下文查找 3. 蒸馏提取 4. 去重嵌入 5. 实体链接 6. 时态推理
异步触发

Agent 回复后异步进入流水线,不阻塞对话响应

上下文查找

检索相关已有记忆,避免重复提取相同事实

时态推理独立

独立于提取的时态推理 pass,异步运行,写入不减速

架构

三级存储:为不同检索模式各司其职

向量数据库(Qdrant)
记忆文本 + Embedding + 元数据
主事实存储 + 语义检索。时间戳、哈希、分类、归属信息一并存储
+
图 / 实体存储
实体 + 实体 Embedding + 关联记忆 ID
跨记忆图连接 + 基于实体的检索增强
+
SQL 数据库
ADD 事件历史 + 滚动消息窗口
审计追踪 + 提取去重上下文
核心机制

多信号检索:四路并行评分

1. 语义搜索

向量相似度匹配记忆 embedding,捕捉概念性查询

例:"用户对远程办公怎么看?"

2. 关键词检索 BM25

词形还原 + 归一化词项匹配,精确命中术语/名称

例:"我上周参加了哪些会议?"

3. 实体匹配

提取查询中实体,匹配关联记忆图谱

例:"我们对 Alice 了解多少?"

4. 时态推理

无额外 LLM 调用,分类查询时态意图,匹配写入时提取的时间元数据

例:"Kendra 什么时候换了鞋品牌?"

四路信号 Rank Fusion 合并为最终 Top-K,语义主导,时态加成——不丢弃任何候选项

核心机制

时态推理:让记忆知道"什么时候"

写入时(提取阶段)

独立时态推理 pass 读取新记忆 + 源对话 + 日期,提取元数据:

  • 事件发生时间
  • 进行中 / 已完成
  • 时间精度
  • 记忆类型:事件、状态、计划、偏好、关系、缺失
检索时(查询阶段)

无需额外 LLM 调用,分类查询的时态意图,按时间元数据匹配度排序:

  • "当前状态" → 偏好、最近事件
  • "过去事件" → 历史事实
  • "即将到来" → 计划、日程
性能基准

SOTA 级记忆精度,7K token 预算

基准旧算法v3 新算法提升Token延迟 p50
LoCoMo71.492.5+21.17.0K0.88s
LongMemEval67.894.4+26.66.8K1.09s
BEAM (1M)64.1新增6.7K1.00s
BEAM (10M)48.6新增6.9K1.05s

全量上下文方案在同基准上通常消耗 25,000+ token/查询。Mem0 以 1/4 token 达到领先精度。评估框架已开源:mem0ai/memory-benchmarks

性能基准

分类精度:时态推理最亮眼

98.6
单会话-用户
98.2
单会话-助手
97.0
时态推理
93.6
知识更新

时态查询("用户现在喜欢什么?")提升 +29.6 分,多跳推理("基于用户偏好推荐 X")提升 +23.1 分——这两类最直接反映 Agent 如何处理真实用户历史。

部署模式

三种方式:从原型到生产

维度SDK 库自托管服务器云平台
适合测试、原型自建基础设施的团队零运维生产环境
安装pip install mem0aidocker compose up注册 app.mem0.ai
Dashboard
认证/API Key
高级特性基础部分全部
Agent 注册5 秒免邮箱自注册
快速上手

Python SDK:三行代码装上记忆

# 1. 安装
pip install mem0ai
# 2. 初始化(默认 OpenAI + 内存向量库)
from mem0 import Memory
m = Memory()
# 3. 添加记忆
m.add("Alice prefers dark mode and vim keybindings",
      user_id="alice")
m.add("Alice switched to VS Code with vim plugin last week",
      user_id="alice")
# 4. 搜索——自动融合语义+关键词+实体+时态
results = m.search("What editor does Alice use?",
                    user_id="alice")
# → "Alice uses VS Code with vim plugin (switched last week)"
# → "Alice prefers vim keybindings" (historical preference preserved)
生态集成

全栈 SDK + 框架整合

多语言 SDK
  • Python(主要)
  • TypeScript / JS
  • Go
  • Rust
  • CLI(npm/pip)
Agent 集成
  • MCP Server
  • Agent Skills(Claude Code / Codex / Cursor)
  • LangChain / CrewAI
  • Vercel AI SDK
  • AWS Agent SDK
LLM 提供商
  • OpenAI(默认)
  • Anthropic Claude
  • Google Gemini
  • Ollama / vLLM
  • 任何 OpenAI 兼容端点
适用场景

适合谁用

风险提示

需要警惕

潜力评估

未来空间

Agent Memory 赛道绝对王者——61.3k Stars、99 个发布版本、AWS 官方集成。v3 算法用 ADD-only + 四路检索融合重新定义了记忆层的性能/成本平衡点。若知识更新(ADD-only 的天然短板)和超大规模记忆库继续优化,有望成为所有 AI Agent 的标配记忆基础设施。


上一个
Graphiti
下一个
LikeC4
1 / 17