`POST https:///v1/memories/` 用于向记忆库添加一条或多条记忆，支持从对话消息中自动提取和直接传入已提取好的记忆。支持同步、异步两种模式，默认为异步。 ## 鉴权本接口采用 API Key 鉴权。具体操作，请参见[请求说明 - 鉴权](https://docs.volcengine.com/docs/86722/2608601?lang=zh#1B2lwyqC)。 ## 请求参数 ### 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` 记忆操作。 ## 错误码更多详情，请参见[公共错误码](https://docs.volcengine.com/docs/86722/2608582)。

记忆库 Mem0