CreateMemoryStore 创建记忆库-表格存储 Tablestore(Tablestore)-阿里云帮助中心

使用 CreateMemoryStore 接口在当前 AgentStorage 实例中创建一个记忆库。

前提条件

已创建 AgentStorage 实例且状态为 normal，并获取实例访问地址（endpoint）和实例名。
已创建 API Key。
创建前应规划记忆库的输入输出类型组合，inputType 创建后不可修改。

请求参数

字段	类型	必填	说明
`memoryStoreName`	string	是	记忆库名称，只能包含字母、数字和下划线，最长 32 个字符。
`description`	string	否	记忆库描述，最长 1024 字节（UTF-8）。
`extractInstructions`	string	否	自定义记忆抽取指令，最长 4096 个字符。
`inputType`	string	条件必填	输入类型：`messages` 或 `file`。使用新类型字段时，必须与 `outputTypes` 同时提供。创建后不可修改。
`outputTypes`	array	条件必填	输出类型集合，元素为 `structured` 或 `file`。使用新类型字段时，必须与 `inputType` 同时提供。
`storageMode`	string	否	兼容字段：`ots`、`file+ots` 或 `filemem`。不能与 `inputType`、`outputTypes` 同时提供；新请求建议使用新类型字段。

支持的输入输出组合如下。

`inputType`	`outputTypes`	说明
`messages`	`["structured"]`	从消息生成结构化记忆。
`messages`	`["file"]`	从消息生成只读记忆文件。
`messages`	`["structured", "file"]`	同时生成结构化记忆和只读记忆文件。
`file`	`["file"]`	由应用直接管理记忆文件。

未提供任何类型字段时，为兼容已有调用，默认创建 messages 输入、structured 输出的记忆库。

请求示例

使用 API Key 认证时，通过 x-ots-instancename 和 x-ots-apikey 请求头传入实例名和 API Key。

curl -X POST https://<endpoint>/CreateMemoryStore \
  -H "x-ots-instancename: <instance-name>" \
  -H "x-ots-apikey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "memoryStoreName": "agent_memory",
  "description": "Agent 对话记忆库",
  "extractInstructions": "重点关注用户的饮食偏好与出行习惯",
  "inputType": "messages",
  "outputTypes": ["structured", "file"]
}'

创建由应用直接管理文件的记忆库：

{
  "memoryStoreName": "agent_files",
  "inputType": "file",
  "outputTypes": ["file"]
}

响应

{
  "otsInstance": "your-instance-name",
  "memoryStoreName": "agent_memory",
  "description": "Agent 对话记忆库",
  "extractInstructions": "重点关注用户的饮食偏好与出行习惯",
  "inputType": "messages",
  "outputTypes": ["structured", "file"],
  "createdAt": "2026-08-31T07:19:48.935Z",
  "updatedAt": "2026-08-31T07:19:48.935Z"
}

使用新类型字段创建的记忆库，响应不返回 storageMode。使用兼容字段创建时，响应同时返回归一化后的 inputType、outputTypes 和 storageMode。