面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/create-memory-api.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

创建记忆

POST https://ark.cn-beijing.volces.com/api/v3/memory_stores/{memory_store_id}/memories

在指定记忆库中创建一条文本记忆。创建后可将该记忆库挂载到会话,供智能体读取或更新其中的记忆。调用前需先创建记忆库,并使用创建或查询记忆库接口返回的 ID。

鉴权#

本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。

  • API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。

请求参数#

Path 参数#

memory_store_id string 必选  |  记忆库 ID

用于指定目标记忆库,以 memstore- 开头。传入创建或查询记忆库接口返回的完整 ID,不要自行拼接。

Body 参数#

content string 必选  |  记忆内容

写入记忆文件的正文。

path string 必选  |  记忆路径

记忆在记忆库中的文件路径。

响应参数#

content_sha256 string  |  内容摘要

记忆正文的 SHA-256 摘要,以小写十六进制字符串表示,可用于校验内容完整性。

content_size_bytes integer  |  内容字节数

记忆正文采用 UTF-8 编码后的字节数。

created_at string  |  创建时间

记忆创建时间,采用 RFC 3339 UTC 格式。

created_by object  |  创建者

创建该记忆的操作者信息。

type string  |  操作者类型

created_by.type

操作者类型,固定为 user_actor,表示该 Memory 由当前 API 调用方创建。

user_id string  |  用户 ID

created_by.user_id

写入该记忆的用户 ID。

id string  |  记忆 ID

服务端生成的记忆 ID,以 mem- 开头。后续查询、更新或删除记忆时,作为 memory_id 路径参数传入。

memory_store_id string  |  记忆库 ID

该记忆所属的记忆库 ID。

memory_version_id string  |  版本 ID

记忆条目的当前版本标识。内容或路径成功更新后,该值会变化。

path string  |  记忆路径

记忆在记忆库中的文件路径。

type string  |  对象类型

对象类型,固定为 memory。

updated_at string  |  更新时间

记忆最后更新时间,采用 RFC 3339 UTC 格式。