文档中心

记忆库 Mem0

记忆管理

添加记忆

POST https://<your_mem0_host>/v1/memories/

用于向记忆库添加一条或多条记忆，支持从对话消息中自动提取和直接传入已提取好的记忆。支持同步、异步两种模式，默认为异步。

鉴权

本接口采用 API Key 鉴权。具体操作，请参见请求说明 - 鉴权。

请求参数

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

这个页面对您有帮助吗？

有用

无用