在过往版本中,MemOS 已成功助力开发者应对大模型长期记忆管理的关键挑战。
v2.0.1 版本深度聚焦真实开发场景,围绕五大核心能力完成迭代升级,显著强化了 MemOS 在跨会话记忆调度与上下文感知对话方面的综合表现。
此前,记忆获取依赖分页或关键词 query 筛选,难以一次性掌握某用户完整记忆图谱。
本次上线 get/memory 接口,支持按时间倒序分页拉取指定用户的全部事实记忆与偏好记忆。无需 query 参数,即可在前端快速呈现用户全量记忆快照,大幅简化集成逻辑。
功能说明: get/memory 支持无条件获取用户所有类型记忆(含事实类与偏好类),默认返回最新批次,支持分页控制。
云服务调用示例
import osimport requestsimport json# 替换为你的 API Keyos.environ["MEMOS_API_KEY"] = "YOUR_API_KEY"os.environ["MEMOS_BASE_URL"] = "https://memos.memtensor.cn/api/openmem/v1"data = { "user_id": "memos_user_123", "page": 2, # 可选,默认为1 "size": 3, # 可选,默认为10 "include_preference": "true" # 可选,默认为true}headers = {"Content-Type": "application/json","Authorization": f"Token {os.environ['MEMOS_API_KEY']}"}url = f"{os.environ['MEMOS_BASE_URL']}/get/memory"res = requests.post(url=url, headers=headers, data=json.dumps(data))print(f"result: {res.json()}")
开源本地调用示例
curl --location --request POST 'http://0.0.0.0:8001/product/get_memory' \--header 'Content-Type: application/json' \--data-raw '{ "user_id": "test_1", "mem_cube_id": "test_1", "include_preference": "true", "page":2, "page_size":3}'
全新 chat 接口将记忆检索与对话生成深度融合:系统自动召回与当前 query 相关的历史记忆,并将其与会话上下文融合构建 Prompt,交由大模型生成响应,全程无需开发者手动拼接上下文。
真正实现多轮自然对话与个性化交互体验,让 AI 应用更懂用户、更富连续性。
典型交互流程:
add/message 将其写入 MemOS;chat 接口;功能说明: chat 接口内置记忆感知能力,支持开箱即用的记忆增强型对话。
调用示例
import osimport requestsimport json# 替换为你的 API Keyos.environ["MEMOS_API_KEY"] = "YOUR_API_KEY"os.environ["MEMOS_BASE_URL"] = "https://memos.memtensor.cn/api/openmem/v1"data = {"user_id": "memos_user_123","conversation_id": "memos_chat_conv","query": "你好,给我推荐美食。"}headers = {"Content-Type": "application/json","Authorization": f"Token {os.environ['MEMOS_API_KEY']}"}url = f"{os.environ['MEMOS_BASE_URL']}/chat"res = requests.post(url=url, headers=headers, data=json.dumps(data))print(f"result: {res.json()}")
为提升多用户环境下的记忆治理效率与偏好调整精度,本次对 delete/memory 与 add/feedback 接口进行关键增强:
delete/memory 支持跨用户批量删除任意类型记忆(包括用户记忆、知识库记忆等),不再强制绑定 user_id;add/feedback 新增偏好记忆直接修正能力,仅需提供反馈文本即可触发记忆更新,降低使用门槛。开发者可在复杂业务场景中更灵活地实施记忆生命周期管控,并获得更透明、可追溯的调试数据。
功能说明: delete/memory 接口解耦用户维度,支持基于 memory_ids 的全局精准删除。
云服务示例
import osimport requestsimport json# 替换为你的 API Keyos.environ["MEMOS_API_KEY"] = "YOUR_API_KEY"os.environ["MEMOS_BASE_URL"] = "https://memos.memtensor.cn/api/openmem/v1"data = {"memory_ids": ["6b23b583-f4c4-4a8f-b345-58d0c48fea04"] # 替换为实际 memory ID}headers = {"Content-Type": "application/json","Authorization": f"Token {os.environ['MEMOS_API_KEY']}"}url = f"{os.environ['MEMOS_BASE_URL']}/delete/memory"res = requests.post(url=url, headers=headers, data=json
功能说明: add/feedback 接口支持语义化偏好修正,系统自动解析反馈内容并更新对应偏好记忆,无需额外配置参数。
云服务示例
import osimport requestsimport json# 替换为你的 MemOS API Keyos.environ["MEMOS_API_KEY"] = "YOUR_API_KEY"os.environ["MEMOS_BASE_URL"] = "https://memos.memtensor.cn/api/openmem/v1"data = { "user_id": "memos_user_123", "conversation_id": "0108", "feedback_content": "错啦,实际上我喜欢的是山竹", "feedback_time": "2025-12-02 10:10:10", "allow_knowledgebase_ids": [ "basebXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" ] }headers = {"Content-Type": "application/json","Authorization": f"Token {os.environ['MEMOS_API_KEY']}"}url = f"{os.environ['MEMOS_BASE_URL']}/add/feedback"res = requests.post(url=url, headers=headers, data=json.dumps(data))print(json.dumps(res.json(), indent=2, ensure_ascii=False))
开源项目示例
curl --location --request POST 'http://0.0.0.0:8001/product/feedback' \--header 'Content-Type: application/json' \--data-raw '{ "user_id": "memos_user_123", "writable_cube_ids": [ "demo_cube_001" ], "history": [ {"role": "user", "content": "我喜欢什么水果,不喜欢什么水果"}, {"role": "assistant", "content": "你喜欢苹果,不喜欢香蕉"} ], "feedback_content": "错了,实际上我喜欢的是山竹"}'
旧版 Playground 中,记忆清理必须依赖接口调用,缺乏直观性。
v2.0.1 在 Playground 控制台新增「记忆管理页」,支持开发者直接勾选并一键删除过期或冗余记忆,适用于快速验证、教学演示及现场调试。
此举显著降低记忆调试门槛,减少重复编码与接口往返,提升整体开发体验。
v2.0.1 为 search 接口新增 dedup 参数,启用后可自动合并语义相近的记忆条目,避免同一事实因表述差异重复返回。
该能力有效规避展示层与统计环节的数据冗余处理,提升结果的信息密度与工程可用性。
开源项目示例
import jsonimport requestsBASE_URL = "http://127.0.0.1:8001"headers = {"Content-Type": "application/json"}data = {"user_id": "memos_user_123","query": "我喜欢吃什么?","top_k": 10,"dedup": "sim"}res = requests.post(url=f"{BASE_URL}/product/search", headers=headers, data=json.dumps(data))print(res.status_code, res.json())
get/memory 支持全量拉取与分页查询; delete/memory 与 add/feedback 已接入 MCP 工具链,支持低代码调用; search 接口新增 dedup 去重策略; ✨ 惯例不变!
? 即刻体验云平台
前往 MemOS 云平台,亲测毫秒级记忆召回与偏好感知能力。
memos-dashboard.openmem.net/quickstart/?entrance=wechat
? 如果认可我们的努力,请慷慨支持:
⭐️ Star ? Fork ? Watch
也欢迎通过 Issue 提交使用心得、改进建议或问题反馈。
github.com/MemTensor/MemOS/issues
关于 MemOS
MemOS 是面向 AI 应用打造的一站式记忆操作系统,赋予智能体类脑式的长期记忆与即时记忆管理能力。
作为全球首个提出“记忆调度”架构的记忆张量平台,MemOS 致力于重构模型记忆资源的全生命周期管理范式,为下一代智能系统提供高可靠、高弹性、可协同的记忆基础设施。
源码地址:点击下载