创建一个记忆库,用于保存智能体的长期工作笔记。
前提
已完成 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"
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 记忆库 ID,格式 memstore_xxx |
type | string | 固定为 memory_store |
name | string | 记忆库名称,1-255 字符 |
description | string | 用途说明;未填写时为空字符串 |
metadata | object | 业务自定义键值对元数据 |
archived_at | string | null | 归档时间,未归档时省略或为 null |
created_at | string | 创建时间,ISO 8601 UTC |
updated_at | string | 最近更新时间,ISO 8601 UTC |
错误码
| 状态码 | 错误码 | 说明 |
|---|---|---|
| 400 | invalid_request_error | 参数、路径、limit 或分页游标非法 |
| 401 | InvalidApiKey | API Key 缺失、错误或失效 |
| 403 | permission_error | 身份或资源访问权限不足 |
该文章对您有帮助吗?