Skip to main content

概览

服务地址、协议约定、请求格式与通用响应

通过记忆库 API，你可以以编程方式写入记忆、检索记忆、管理画像模板。所有接口通过业务空间专属域名提供服务。

服务地址

https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v2/apps/memory/
{workspaceId} 是业务空间 ID，格式如 llm-xxxxxxxxxxxx，在控制台业务空间管理页面查看，详见获取 Workspace ID。业务空间专属域名仅支持该业务空间所属的 API Key 调用。 所有接口使用统一的服务地址，路径前缀为 /memory/。 使用 Python SDK（agentscope-runtime）时，将环境变量 MEMORY_SERVICE_ENDPOINT 设置为服务地址（末尾不带 /）： 
export MEMORY_SERVICE_ENDPOINT="https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v2/apps/memory"

协议约定

  • 所有接口均通过 HTTPS 访问，不支持 HTTP
  • 请求体和响应体均为 JSON 格式，字符集 UTF-8
  • 写入和检索接口使用 POST 方法；列表查询使用 GET 方法；更新使用 PATCH；删除使用 DELETE

通用请求头

Header必填说明
Authorization是Bearer $DASHSCOPE_API_KEY，获取方式见鉴权
Content-Type是application/json

通用响应格式

所有接口返回统一的 JSON 结构。 成功响应： 
{
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "memory_nodes": [
    {
      "memory_node_id": "node_xxx",
      "content": "用户每天上午9点需要喝水提醒"
    }
  ]
}
失败响应： 
{
  "code": "InvalidParameter",
  "message": "user_id is required",
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
排查问题时，请提供 request_id，以便快速定位。完整错误码见错误码参考。

分页

列表接口支持分页查询：
参数说明
page_size每页数量
page_num页码，从 1 开始
记忆库将于 2026 年 8 月 20 日 正式商业化计费。Add 和 Search 调用区分 Pro 和 Lite 两个策略版本。详见计费说明。
准备好凭证后，查看 AddMemory 接口。