记忆库全部接口的端点、参数和请求方式
记忆库 API 基础地址：
写入记忆。传入对话消息后，系统自动提取记忆片段和用户画像。也支持直接指定要存储的记忆内容。
检索记忆。基于语义检索返回与当前查询最相关的历史记忆。
列出记忆。分页查看用户的所有记忆。
更新记忆。修改已有记忆的内容。
删除记忆。删除指定的记忆条目。
创建用户画像模板。
获取用户画像。需在添加对话后等待约 3 秒，待画像提取完成。
https://dashscope.aliyuncs.com/api/v2/apps/memory
所有接口需在 Header 中携带 Authorization: Bearer $DASHSCOPE_API_KEY。
接口列表
| API | 方法 | 路径 | 说明 |
|---|---|---|---|
| AddMemory | POST | /add | 添加记忆，自动提取记忆片段和用户画像 |
| SearchMemory | POST | /search | 基于语义检索返回相关历史记忆 |
| ListMemory | GET | /memory_nodes | 分页查看用户的所有记忆 |
| UpdateMemory | PATCH | /memory_nodes/{memory_node_id} | 修改已有记忆内容 |
| DeleteMemory | DELETE | /memory_nodes/{memory_node_id} | 删除指定记忆条目 |
| CreateProfileSchema | POST | /profile_schemas | 创建用户画像模板 |
| GetUserProfile | GET | /profile_schemas/{schema_id}/user_profile | 获取用户画像 |
AddMemory
写入记忆。传入对话消息后，系统自动提取记忆片段和用户画像。也支持直接指定要存储的记忆内容。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
messages | array | 是 | 对话消息列表，每项含 role（user/assistant）和 content |
user_id | string | 是 | 记忆实体 ID，用于记忆隔离 |
profile_schema | string | 否 | 用户画像模板 ID，传入后自动提取画像 |
SearchMemory
检索记忆。基于语义检索返回与当前查询最相关的历史记忆。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
user_id | string | 是 | 记忆实体 ID |
query | string | 是 | 检索查询语句 |
max_results | number | 否 | 最大返回数量（1~100） |
rewrite | boolean | 否 | 是否改写查询以提升准确率 |
rerank | boolean | 否 | 是否对结果重排 |
similarity_threshold | number | 否 | 相似度阈值（0.0 |
ListMemory
列出记忆。分页查看用户的所有记忆。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
user_id | string | 是 | 记忆实体 ID |
page_size | number | 否 | 每页数量 |
page_num | number | 否 | 页码，从 1 开始 |
UpdateMemory
更新记忆。修改已有记忆的内容。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
memory_node_id | string | 是 | 记忆节点 ID（路径参数） |
user_id | string | 是 | 记忆实体 ID |
custom_content | string | 否 | 更新后的记忆内容 |
DeleteMemory
删除记忆。删除指定的记忆条目。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
memory_node_id | string | 是 | 记忆节点 ID（路径参数） |
CreateProfileSchema
创建用户画像模板。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 是 | 画像模板名称 |
description | string | 否 | 模板描述，用于指导智能体调用 |
attributes | array | 是 | 画像字段列表，每项含 name 和 description |
GetUserProfile
获取用户画像。需在添加对话后等待约 3 秒，待画像提取完成。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
schema_id | string | 是 | 画像模板 ID（路径参数） |
user_id | string | 是 | 记忆实体 ID |