Skip to main content
Memory Store

创建 Memory Store

创建一个记忆库，用于保存智能体的长期工作笔记。

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

接口

POST /memory_stores

请求体

字段必填类型说明
name是string记忆库名称，1-255 字符
description否string用途说明，缺省返回空字符串
metadata否object业务自定义键值对元数据，缺省为空对象

请求示例 

curl -X POST "$AGENTSTUDIO_URL/memory_stores" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"name": "项目知识库","description": "项目约定、决策记录与排查笔记"}'

响应 

{
  "id": "memstore_xxx",
  "type": "memory_store",
  "name": "项目知识库",
  "description": "项目约定、决策记录与排查笔记",
  "metadata": {
    "team": "data"
  },
  "created_at": "2026-09-17T08:00:00Z",
  "updated_at": "2026-09-17T08:00:00Z"
}

响应字段

字段类型说明
idstring记忆库 ID，格式 memstore_xxx
typestring固定为 memory_store
namestring记忆库名称，1-255 字符
descriptionstring用途说明；未填写时为空字符串
metadataobject业务自定义键值对元数据
archived_atstring | null归档时间，未归档时省略或为 null
created_atstring创建时间，ISO 8601 UTC
updated_atstring最近更新时间，ISO 8601 UTC

错误码

状态码错误码说明
400invalid_request_error参数、路径、limit 或分页游标非法
401InvalidApiKeyAPI Key 缺失、错误或失效
403permission_error身份或资源访问权限不足
Managed Agents
Sandbox
Security
RAG
应用调用
应用组件
长期记忆
ParseX
框架
Assistant API（下线中）
更多