创建记忆

通过 OMA API 创建记忆。

POST /v1/memory_stores/{memory_store_id}/memories

创建记忆

cURL

curl --request POST \
  --url http://localhost:38080/v1/memory_stores/{memory_store_id}/memories \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "path": "<string>",
  "content": "<string>"
}
'

200

{
  "type": "memory",
  "id": "<string>",
  "memory_store_id": "<string>",
  "path": "<string>",
  "content_size_bytes": 123,
  "content_sha256": "<string>",
  "memory_version_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "content": "<string>"
}

每个请求都必须发送 ?beta=true。

授权

omaApiKeyomaBearer

X-Api-Key · string · header · 默认值: sk-ant-local-default · 必填

OMA 工作区 API 密钥。

请求头

anthropic-version · string

anthropic-beta · string

路径参数

memory_store_id · string · 必填

记忆存储标识符。

查询参数

beta · enum<boolean> · 必填

为此接口启用 Beta API 合同，必须为 true。

可用选项: true

view · enum<string>

view 的查询参数 选择服务器返回 memory 或 memory_version 的哪种投影。basic 返回 content 置为 null 的对象；full 会填充 content。省略时默认值因端点而异：检索操作默认为 full；列表、创建和更新操作默认为 basic。使用 view=full 进行列表查询时，limit 上限为 20。

可用选项: basic, full

请求体

application/json

创建记忆的请求参数。路径必须未被占用：如果该路径上已存在记忆，或该路径是现有记忆路径的祖先或后代，请求将返回 memory_path_conflict_error（HTTP 409）。创建从不覆盖；要修改现有记忆，请使用更新记忆。

path · string · 必填

新记忆的层级路径，例如 /projects/foo/notes.md。必须以 / 开头，至少包含一个非空段，且不超过 1,024 字节。不得包含空段、. 或 .. 段、控制字符或格式字符，并且必须为 NFC 规范化形式。路径区分大小写。

Required string length: 2 - 1024

content · string | null · 必填

新记忆的 UTF-8 文本内容。最大 100 kB（102,400 字节）。必填；显式传入 "" 可创建空记忆。

响应

200

application/json

请求成功。

memory 对象：记忆存储中位于层级路径上的单个文本文档。view=full 时填充 content 字段，view=basic 时为 null；content_size_bytes 和 content_sha256 字段始终填充，以便同步客户端无需拉取内容即可比对差异。记忆以其 mem_... ID 寻址；路径是创建时的键，可通过更新修改。

type · enum<string> · 必填

可用选项: memory

id · string · 必填

此记忆的唯一标识符（mem_... 格式的值）。重命名后保持不变；读取、更新或删除该记忆时应使用此 ID 而非路径。

memory_store_id · string · 必填

该记忆所属的记忆存储的 ID（memstore_... 格式的值）。

path · string · 必填

该记忆在存储内的层级路径，例如 /projects/foo/notes.md。始终以 / 开头。路径区分大小写，且在同一存储内唯一。最大 1,024 字节。

content_size_bytes · integer<int32> · 必填

content 的字节大小（UTF-8 明文长度）。无论 view 为何值，始终填充。

content_sha256 · string · 必填

UTF-8 content 字节的小写十六进制 SHA-256 摘要（64 个字符）。服务端不做任何规范化处理，因此客户端可在本地计算相同的哈希，用于过期检查，并作为更新时 content_sha256 前置条件的值。无论 view 如何，此字段始终填充。

memory_version_id · string · 必填

表示此记忆当前内容的 memory_version 的 ID（memver_... 值）。这是权威的头部指针；memory_version 对象不携带 is_latest 标志，因此请改为与此字段比较。可通过列出记忆版本枚举完整历史。

created_at · string<date-time> · 必填

此记忆的创建时间，采用 RFC 3339 格式。

updated_at · string<date-time> · 必填

该记忆最近一次修改的时间，采用 RFC 3339 格式。可将其用作低成本的时效性信号；如需了解是谁做出的修改，请通过列出记忆版本查询 head 版本的 created_by。

content · string | null

记忆的 UTF-8 文本内容。view=full 时填充；view=basic 时为 null。最大 100 kB（102,400 字节）。