BIbigmodel
Managed Agents - Memory

创建 Memory Store

Changed on

创建一个用于跨 Session 保存长期记忆的 Memory Store。可设置名称、说明和自定义元数据。

post/agent/managed/v1/memory_stores

Request

  • Base URL
    https://agent-api.bigmodel.cn/api
  • Auth
    HTTP bearer

Query parameters

beta'true'

SDK 兼容参数；提供时必须为 true。

Headers

zai-version'2026-05-26' required
Example:2026-05-26

Managed Agents API 入口要求的基础协议标识，当前只接受 2026-05-26；响应兼容形态由 zai-beta 选择。两个头均需携带。

zai-betastring required
Example:managed-agents-2026-09-22

声明 Managed Agents Beta 协议并选择响应字段与兼容行为。新接入使用 managed-agents-2026-09-22；旧客户端仍可使用 managed-agents-2026-05-26。必须同时携带 zai-version: 2026-05-26。字段差异见 /cn/managed-agents/protocol-versions。

Request body

namestring required

Memory Store 名称，1–255 个 Unicode 字符；不能包含控制字符或格式字符。

descriptionstring nullable

用途说明；省略或传 null 时不设置。

metadataManagedMetadata

客户端自定义元数据；省略时默认为空对象。最多 16 个键，键名长度不超过 64 字符，值必须是长度不超过 512 字符的字符串。

Response

创建成功。当前推荐协议返回 200；旧协议返回 201。

idstring required

Memory Store ID。

type'memory_store' required
namestring required
descriptionstring required
metadataManagedMetadata required

客户端自定义元数据；省略时默认为空对象。最多 16 个键，键名长度不超过 64 字符，值必须是长度不超过 512 字符的字符串。

archived_atstring nullable required

归档时间。

created_atstring date-time required

创建时间。

updated_atstring date-time required

更新时间。

Example response

{
  "id": "memstore_01J..."
}

Changes