核心操作

Add Feedback

添加用户自然语言反馈,MemOS 将自动更新记忆。

1. 何时添加反馈?

MemOS 反馈机制用于接收用户对模型回答、知识内容或历史记忆的自然语言反馈,并自动完成记忆校正与更新。你不需要手动定位具体记忆条目,只需要把用户反馈传入 add/feedback

对比维度自然语言反馈定点修改记忆
使用方式用自然语言描述问题或修正信息直接指定某条 memory 进行编辑
用户门槛低,适合非技术用户较高,通常由开发者或管理员操作
系统参与度系统自动解析、定位、关联更新人工主导更新
适用场景对话纠错、知识过期、业务规则变更精确修订、结构化维护

2. 关键参数

  • 反馈内容(feedback_content):用户对模型回答、知识内容或记忆结果的自然语言反馈。
  • 用户标识(user_id):反馈内容所关联的用户唯一标识符。
  • 会话标识(conversation_id):反馈内容所关联的会话唯一标识符,用于补充上下文。
  • 知识库范围(allow_knowledgebase_ids):反馈产生的新记忆允许写入的知识库列表。

3. 工作原理

以 Chatbot 场景为例,用户可以在模型回答下方点击“反馈错漏”,填写对本次回答的反馈并提交。

根据反馈内容,后端完成一次 MemOS add/feedback 接口调用,触发记忆更新。

  • 有效性分析:结合当前会话上下文解析反馈内容,判断是否为有效信息、是否与对话内容相关。
  • 更新类型识别:将反馈更新请求分类为关键词替换或语义更新。
  • 更新记忆:写入新记忆,并对存在冲突、过时或被纠正的已有记忆进行更新或覆盖。

4. 快速上手

语义更新知识库记忆

当企业政策、知识库内容或业务规则发生变化时,可以直接把用户的自然语言反馈传入 MemOS,让系统生成新的高权重记忆。

提交自然语言反馈

财务主管在会话中反馈:办公类软件的采购上限应为 600 元,而不是 800 元。

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://memos.memtensor.cn/api/openmem/v1"

data = {
  "user_id": "memos_user_123",
  "conversation_id": "memos_feedback_conv",
  "feedback_content": "办公类软件的采购上限是600元,而不是800元。",
  "allow_knowledgebase_ids": ["basee5ec9050-c964-484f-abf1-ce3e8e2aa5b7"]
}

res = requests.post(
  f"{BASE_URL}/add/feedback",
  headers={"Authorization": f"Token {API_KEY}"},
  json=data
)

print(res.json())

检索验证更新结果

反馈处理完成后,任意其他用户搜索【软件报销制度】时,获取一条新增高权重记忆【办公类软件的采购上限为600元,而不是800元】。

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://memos.memtensor.cn/api/openmem/v1"

data = {
  "user_id": "memos_user_123",
  "conversation_id": "memos_feedback_check",
  "query": "帮我查一下软件采购报销额度。",
  "knowledgebase_ids": ["basee5ec9050-c964-484f-abf1-ce3e8e2aa5b7"]
}

res = requests.post(
  f"{BASE_URL}/search/memory",
  headers={"Authorization": f"Token {API_KEY}"},
  json=data
)

print(res.json())
输出结果
"memory_detail_list": [
  {
    "id": "8a4f3d2e-c417-4e53-bc25-54451abd5ac8",
    "memory_key": "软件采购报销制度(试行版)",
    "memory_value": "该制度要求办公类软件的采购上限为800元,适用于文档编辑和表格处理。",
    "memory_type": "LongTermMemory",
    "conversation_id": "default_session",
    "relativity": 0.8931847
  },
  {
    "id": "a72a04d1-d7ba-4ebd-9410-0097bfa6c20d",
    "memory_key": "办公软件采购上限",
    "memory_value": "用户确认办公类软件的采购上限是600元,而不是800元。",
    "memory_type": "WorkingMemory",
    "conversation_id": "memos_feedback_conv",
    "relativity": 0.7196722
  }
]

控制台-知识库中也会展示通过自然语言交互更正或补全的知识库记忆。


关键词替换记忆

如果用户明确指出某个名称、规则或字段需要整体替换,也可以直接用自然语言描述替换意图。

data = {
  "user_id": "memos_user_123",
  "conversation_id": "memos_feedback_conv",
  "feedback_content": "从现在开始我改名了,把用户1号统一替换为用户2号",
  "allow_knowledgebase_ids": ["basee5ec9050-c964-484f-abf1-ce3e8e2aa5b7"]
}

需要查看完整字段、请求格式和响应格式?详见 Add Feedback 接口文档