长期记忆的完整 API 接口目录:公共请求信息、全部接口一览与使用限制,各接口的请求参数、返回结果和示例代码见对应分页。
本文档是长期记忆(记忆库)全部 API 的目录总览。功能介绍和使用指南参见记忆库与长期记忆 API。
协议约定、通用请求/响应格式与分页说明参见 API 概览,鉴权细节参见鉴权,错误响应参见错误码。
事实记忆:
用户画像:
限流(阿里云账号级别):
生成的记忆片段与用户画像暂无失效日期。如需扩容限流额度,请提交工单申请,详见限流说明。
公共请求信息
| 参数 | 说明 |
|---|---|
| Base URL | https://dashscope.aliyuncs.com/api/v2/apps/memory/ |
| 认证方式 | 在请求 Header 中添加 Authorization: Bearer $DASHSCOPE_API_KEY。API Key 的获取方式请参见获取 API Key |
| Content-Type | application/json |
接口概览
事实记忆:
| 接口名称 | HTTP 方法 | 路径 | 说明 |
|---|---|---|---|
| AddMemory | POST | /add | 添加事实记忆 |
| AddMemoryAsync | POST | /add-async | 异步提交记忆抽取任务 |
| GetEvent | GET | /events/{event_id} | 查询异步任务事件详情 |
| ListMemory | GET | /memory_nodes | 列出事实记忆 |
| SearchMemory | POST | /memory_nodes/search | 搜索事实记忆 |
| GetMemoryNode | GET | /memory_nodes/{memory_node_id} | 获取单个记忆节点详情 |
| GetSkillExport | GET | /skill/export/{memory_node_id} | 导出技能记忆节点 |
| UpdateMemory | PATCH | /memory_nodes/{memory_node_id} | 更新事实记忆 |
| DeleteMemory | DELETE | /memory_nodes/{memory_node_id} | 删除事实记忆 |
| 接口名称 | HTTP 方法 | 路径 | 说明 |
|---|---|---|---|
| CreateProfileSchema | POST | /profile_schemas | 创建画像模板 |
| ListProfileSchemas | GET | /profile_schemas | 获取画像模板列表 |
| GetProfileSchema | GET | /profile_schemas/{profile_schema_id} | 获取画像模板详情 |
| UpdateProfileSchema | PATCH | /profile_schemas/{profile_schema_id} | 更新画像模板 |
| GetUserProfile | GET | /profile_schemas/{profile_schema_id}/user_profile | 获取用户画像 |
使用限制
限流(阿里云账号级别):
| API 接口 | 限流 |
|---|---|
| 全部接口 | 总计不超过 3000 QPM |
| 事实记忆 add 接口 | 120 QPM |
| 事实记忆 search 接口 | 300 QPM |