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。