添加记忆

curl --request POST \ --url 'https://dashscope.aliyuncs.com/api/v2/apps/memory/add' \ --header 'Authorization: Bearer <YOUR_API_KEY>' \ --header 'Content-Type: application/json' \ --data ' { "user_id": "<string>", "messages": [ { "role": "user", "content": "<string>" } ], "custom_content": "<string>", "profile_schema": "<string>", "memory_library_id": "<string>", "meta_data": {} } '

将用户对话存储为记忆片段，自动提取关键信息。也支持直接指定自定义内容存储。若需同时提取用户画像，需传入 profile_schema。

调用前请确保已获取 API Key，详见鉴权。

请求参数

参数	类型	必填	说明
`user_id`	string	是	记忆实体 ID，用于标识归属对象，最大 64 字符
`messages`	array	是*	对话消息列表，最多 50 条。每条含 `role`（user/assistant）和 `content`
`custom_content`	string	是*	自定义内容，最大 512 字符。与 `messages` 互斥
`profile_schema`	string	否	画像模板 ID。不传则不提取用户画像，仅写入记忆片段
`memory_library_id`	string	否	记忆库 ID，不传则使用默认记忆库
`project_id`	string	否	记忆片段规则 ID，不传则使用默认规则
`meta_data`	object	否	用户自定义信息

messages 和 custom_content 互斥，填 custom_content 后会忽略 messages。

调用成功但用户画像属性为空？ 记忆片段与用户画像是两条独立的提取链路。不传 profile_schema 时，接口只会返回 memory_nodes，画像属性保持为空。请传入画像模板 ID 后重新调用，ID 可通过 ListProfileSchemas 获取，或在控制台记忆库详情页的记忆规则 > 用户画像规则中查看。

返回结果

字段	类型	说明
`request_id`	string	请求 ID
`memory_nodes`	array	变更的记忆片段列表
`memory_nodes[].memory_node_id`	string	记忆片段 ID
`memory_nodes[].content`	string	提取的记忆内容
`memory_nodes[].event`	string	操作类型：ADD / UPDATE / DELETE
`memory_nodes[].old_content`	string	更新前内容，仅 event 为 UPDATE 时有效

代码示例

curl -X POST https://dashscope.aliyuncs.com/api/v2/apps/memory/add \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "messages": [
      {"role": "user", "content": "每天上午9点提醒我喝水"},
      {"role": "assistant", "content": "好的，已记录"},
      {"role": "user", "content": "明天10点提醒我整理会议纪要。"}
    ],
    "user_id": "user_001"
  }'

# response
{
  "memory_nodes": [
    {"content": "用户每天上午9点需要喝水提醒", "event": "ADD", "memory_node_id": "50b46e97..."},
    {"content": "用户明天10点需要整理会议纪要", "event": "ADD", "memory_node_id": "381cc694..."}
  ],
  "request_id": "bec69131-627c-..."
}

写入后，使用 SearchMemory 检索记忆。

请求参数

返回结果

代码示例

Authorizations

Body

Response

​请求参数

​返回结果

​代码示例

Authorizations

Body

Response

请求参数

返回结果

代码示例