Memory Store

列出 Memory

列出记忆库内的记忆文件

GET

/api/v1/agentstudio/memory_stores/{memory_store_id}/memories

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/memory_stores/{memory_store_id}/memories' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "data": [
    {
      "id": "mem_xxx",
      "type": "memory",
      "memory_store_id": "memstore_xxx",
      "path": "/notes/project.md",
      "content": "# 项目约定\n默认开发环境为预发环境。\n",
      "content_sha256": "e3b0c44b98fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "content_size_bytes": 47,
      "memory_version_id": "memver_xxx",
      "created_at": "2026-09-17T08:00:00Z",
      "updated_at": "2026-09-17T08:00:00Z"
    }
  ],
  "prefixes": [],
  "next_page": null
}

Authorizations

string

header

required

DashScope API Key

Path Parameters

string

required

记忆库 ID

Query Parameters

string

目录前缀过滤，以 / 开头和结尾，例如 /notes/；最大 1024 UTF-8 bytes

enum<integer>

0 递归列举全部文件（默认）；1 只列举当前层文件，并通过 prefixes 返回子目录

Available options:0,1

enum<string>

basic 不含正文（默认）；full 含正文

Available options:basic,full

integer

单页条数。basic 为 1-100 默认 20；full 为 1-20

string

分页游标。翻页时保持其余查询参数与 limit 不变

Response

200-application/json

object[]

记忆数组；view=basic 时不含 content

Show child attributes

string

记忆 ID，格式 mem_xxx

string

固定为 memory

string

所属记忆库 ID

string

记忆库内路径，以 / 开头

string

正文，UTF-8 文本；view=full 或单条读取时返回

string

正文的 SHA256 哈希，可用作条件更新的乐观锁

integer

正文的 UTF-8 字节数

string

当前版本 ID，格式 memver_xxx

string

创建时间，ISO 8601 UTC

string

最近更新时间，ISO 8601 UTC

string[]

depth=1 时返回当前层下的子目录前缀

string | null

下一页游标；无更多数据时不含该字段

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/memory_stores/{memory_store_id}/memories' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "data": [
    {
      "id": "mem_xxx",
      "type": "memory",
      "memory_store_id": "memstore_xxx",
      "path": "/notes/project.md",
      "content": "# 项目约定\n默认开发环境为预发环境。\n",
      "content_sha256": "e3b0c44b98fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "content_size_bytes": 47,
      "memory_version_id": "memver_xxx",
      "created_at": "2026-09-17T08:00:00Z",
      "updated_at": "2026-09-17T08:00:00Z"
    }
  ],
  "prefixes": [],
  "next_page": null
}