记忆库 Mem0
记忆库 Mem0
文档指南
请输入
- 文档首页
记忆库 Mem0数据面 API 参考记忆管理添加记忆
复制全文
下载 pdf添加记忆
文档反馈
问问助手POST https://<your_mem0_host>/v1/memories/
用于向记忆库添加一条或多条记忆，支持从对话消息中自动提取和直接传入已提取好的记忆。支持同步、异步两种模式，默认为异步。
鉴权
请求参数
Body 参数
messages Array[Message] 必选
对话消息列表，用于从中提取和生成记忆。
role String 必选示例值：user
消息角色。
content String 必选示例值：我下周要去北京出差，帮我推荐几家特色的烤鸭店。
消息内容。
user_id String 条件必选 示例值：user-12345
用户标识符。
说明
user_id、agent_id、run_id 至少需要提供一个。
agent_id String 条件必选 示例值：agent-001
智能体标识符。
说明
user_id、agent_id、run_id 至少需要提供一个。
run_id String 条件必选 示例值：run-abc123
单次运行标识符。
说明
user_id、agent_id、run_id 至少需要提供一个。
metadata Object[] 可选 示例值：{"source": "trip_planner_chat"}
附加到记忆的元数据，键值对格式，方便后续过滤查询。
说明
键（key）不得以双下划线（__）开头或结尾。
memory_type String 可选 示例值：semantic
记忆类型，用于分类管理。支持native。
infer Boolean 可选 示例值：true
是否需要模型推理生成记忆，默认为 true。
说明
若该字段设为false，则必须同时将 async_mode 设为 false。
async_mode Boolean 可选 示例值：true
是否采用异步模式处理，默认为 true。
说明
- 若该字段设为 true，接口立即返回任务 ID。
- 若该字段设为 false，则同步等待记忆处理完成后返回结果。同步模式下，接口响应时间可能较长，请合理配置超时时间。
prev_job_id String 可选 示例值：evt_previous123456
上一个关联的任务 ID，用于任务关联。
project_id String 可选 示例值：prj_a1b2c3d4e5f67890
项目 ID。
说明
如果提供，将会与 API Key 所属的项目 ID 进行校验。
返回参数
返回参数因请求参数 async_mode 的取值而异，具体如下。
异步模式（async_mode=true）
results Array[AsyncMemoryResultItem]
异步任务结果列表，每个元素对应一个创建任务。
message String 示例值："Task received."
操作信息。
status String 示例值：PENDING
操作状态。枚举值为PENDING、SUCCEEDED、FAILED，提交后通常为 PENDING。
event_id String 示例值：evt_abcdef1234567890
事件/任务唯一标识符，用于查询异步任务状态。
同步模式（async_mode=false）
说明
同步模式用于直接写入记忆本体，适用于手动导入场景，不经过记忆提取流程。
results Array[SyncMemoryResultItem]
同步模式下记忆创建的结果列表。
id String 示例值：mem_0987654321fedcba
成功生成的记忆 ID。
memory String示例值：用户计划下周去北京出差，需要推荐烤鸭店。
成功生成的记忆内容。
event String 示例值：ADD
记忆操作。
错误码
输入示例 1 （异步模式）
输入示例
curl -X POST 'https://<your_mem0_host>/v1/memories/' \
-H 'Content-Type: application/json' \
-H 'Authorization: Token YOUR_PERSONAL_API_KEY' \
-d '{
"messages": [
{
"role": "user",
"content": "我下周要去北京出差，帮我推荐几家特色的烤鸭店。"
},
{
"role": "assistant",
"content": "当然。为您推荐：大董、四季民福和全聚德。大董以其创新的意境菜和酥不腻烤鸭闻名。"
}
],
"user_id": "user-1xxxx",
"async_mode": true,
"metadata": {
"source": "trip_planner_chat"
}
}'
输出示例
{
"results": [
{
"message": "Task received.",
"status": "PENDING",
"event_id": "evt_abcdef123456xxxx"
}
]
}
最近更新时间：2026.09.02 17:15:39
这个页面对您有帮助吗？
有用
有用
无用
无用