Skip to main content
agentscope-extensions-mem0 接入 Mem0 记忆服务,提供基于向量检索 + LLM 抽取的长期记忆能力,支持 Mem0 Platform、自托管以及本地部署三种模式。

何时使用

  • 需要给 Agent 加上跨会话的事实记忆,例如用户偏好、历史决策。
  • 想用 agentId / userId / runId 三层 metadata 隔离不同租户、不同 session 的记忆。
  • 想用自定义 metadata(例如 category=travel)做检索过滤。

添加依赖

快速上手

部署模式

Mem0ApiType 决定客户端调用的 URL 与鉴权方式:

多租户隔离

agentName / userId / runName 是 Mem0 用来组织记忆的三层 ID:
至少要提供其中之一,全部为空时 build() 抛出 IllegalArgumentException。检索时只会返回 metadata 完全匹配的记忆。

自定义 metadata 过滤

metadata(...) 同时影响写入和读取:写入时随记忆持久化,检索时作为 filter 注入。
适合按项目、按业务线切分知识;如果只是按用户切分,用 userId 就够了。

Builder 配置参数

三个 ID(agentName / userId / runName)至少要填一个,否则 build()IllegalArgumentException