火山方舟
火山方舟
API参考
请输入
- 文档首页
火山方舟Managed Agents APIMemory Stores查询记忆库详情
复制全文
下载 pdf查询记忆库详情
文档反馈
问问助手GET https://ark.cn-beijing.volces.com/api/v3/memory_stores/{memory_store_id}
按 ID 查询单个记忆库的配置、自定义元数据和当前统计值。需要浏览多个记忆库时，使用查询记忆库列表接口。
鉴权
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数
Path 参数
memory_store_id string 必选 | 记忆库 ID
用于定位要查询的记忆库，以 memstore- 开头。传入创建或列表接口返回的完整 ID，不要自行拼接。
响应参数
created_at string | 创建时间
记忆库创建时间，采用 RFC 3339 UTC 格式。
created_by object | 创建者
创建该记忆库的操作者信息。
type string | 操作者类型
created_by.type
创建者类型，固定为 user_actor。
user_id string | 用户 ID
created_by.user_id
创建该记忆库的用户 ID，由服务端根据当前请求的身份自动记录，可用于按创建者筛选记忆库。
id string | 记忆库 ID
服务端生成的记忆库 ID，以 memstore- 开头。后续查询、更新或删除记忆库时，作为 memory_store_id 路径参数传入。
memory_count integer | 记忆条目数量
记忆库当前包含的记忆条目数量。
metadata object | 自定义元数据
创建或更新记忆库时设置的自定义元数据。
name string | 记忆库名称
记忆库名称，用于识别和管理该记忆库。
session_count integer | 活跃会话数
当前挂载该记忆库的活跃会话数量。
storage_bytes integer | 内容总字节数
记忆库当前所有记忆正文的总字节数。
type string | 对象类型
对象类型，固定为 memory_store。
updated_at string | 更新时间
记忆库更新时间，采用 RFC 3339 UTC 格式。
description string | 记忆库描述
记忆库的用途和存储内容说明。
dream_id string | Dream 任务 ID
仅 Dream 输出记忆库返回，表示创建该输出 Memory Store 的 Dream ID；普通 Memory Store 不返回该字段。
dream_status string | Dream 任务状态
仅 Dream 输出记忆库返回，表示创建该输出 Memory Store 的 Dream 当前状态；普通 Memory Store 不返回该字段。可选值：pending、running、completed、failed、canceled。
mountable boolean | 是否可挂载
表示当前是否可以挂载、读取或修改该 Memory Store。普通 Memory Store 返回 true；Dream 输出记忆库在 pending 或 running 状态时返回 false，在 completed、failed 或 canceled 状态时返回 true。
project_name string | 项目名称
记忆库实际所属的项目名称。
usage_ready boolean | 用量是否就绪
表示 memory_count 和 storage_bytes 是否已可作为准确统计值。普通 Memory Store 返回 true；Dream 输出记忆库在 pending 或 running 状态时返回 false，在 completed、failed 或 canceled 状态时返回 true。
查询记忆库详情
发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！
Request
cURL
curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/memory_stores/<MEMORY_STORE_ID>" \
-H "Authorization: Bearer $ARK_API_KEY"Response
{
"id": "<MEMORY_STORE_ID>",
"type": "memory_store",
"name": "<MEMORY_STORE_NAME>",
"description": "用于存放团队常用规范和历史决策的长期记忆库",
"memory_count": 12,
"storage_bytes": 34567,
"session_count": 2,
"created_by": {"type": "user_actor", "user_id": "<USER_ID>"},
"created_at": "2026-09-17T16:02:42Z",
"updated_at": "2026-09-17T16:02:48Z",
"metadata": {}
}最近更新时间：2026.10.17 12:33:26
这个页面对您有帮助吗？
有用
有用
无用
无用