创建一个记忆库,用于保存智能体的长期工作笔记。
前提
已完成 Endpoint 与鉴权配置,详见API 总览与认证。
接口
POST /memory_stores
请求体namestring (必选)记忆库名称,1-255 字符description string (可选)用途说明,缺省返回空字符串metadata object (可选)业务自定义键值对元数据,缺省为空对象 | 请求示例 |
响应字段idstring记忆库 ID,格式 memstore_xxxtype string固定为 memory_storename string记忆库名称,1-255 字符description string用途说明;未填写时为空字符串metadata object业务自定义键值对元数据archived_at string | null归档时间,未归档时省略或为 nullcreated_at string创建时间,ISO 8601 UTCupdated_at string最近更新时间,ISO 8601 UTC | 响应 |
错误码
| 状态码 | 错误码 | 说明 |
|---|---|---|
| 400 | invalid_request_error | 参数、路径、limit 或分页游标非法 |
| 401 | InvalidApiKey | API Key 缺失、错误或失效 |
| 403 | permission_error | 身份或资源访问权限不足 |