Skip to main content
PATCH
更新记忆

路径参数

id
string
必填

记忆库 ID。

Pattern: ^mstr_[0-9a-hjkmnp-tv-z]{26}$
memory_id
string
必填

记忆文件 ID。

Pattern: ^mem_[0-9a-hjkmnp-tv-z]{26}$

请求体

application/json

更新记忆文件的部分更新请求体:可更新内容、路径或两者。 content_sha256 是针对当前文件正文的乐观并发检查。

path
string

新路径,最长 900 UTF-8 字节。校验规则与创建相同。

Required string length: 1 - 900
content
string

替换后的内容,base64 编码,解码后不超过 20 MiB。

content_sha256
string

可选的乐观并发检查:回显该记忆当前的 content_sha256。 不匹配时更新将失败并返回 409。

Pattern: ^[0-9a-f]{64}$

响应

更新后的文件,携带其内容与新哈希。

记忆库中的一个文件。

id 在重命名后保持不变。删除文件后,其 ID 和版本历史仍可读取。

id
string
必填

记忆文件 ID。文件重命名时保持不变。

Pattern: ^mem_[0-9a-hjkmnp-tv-z]{26}$
memory_store_id
string
必填

所属记忆库的 ID。

Pattern: ^mstr_[0-9a-hjkmnp-tv-z]{26}$
path
string
必填

相对于记忆库根目录的路径。

content_sha256
string
必填

解码后内容的 SHA-256 哈希。更新时回传用作乐观并发检查。

content_size_bytes
integer<int64>
必填

解码后内容的大小,单位为字节。

created_at
string<date-time>
必填

创建时间戳。

updated_at
string<date-time>
必填

最近一次内容或路径更新的时间戳。

content
string

文件内容,经 base64 编码。在创建/获取/更新响应中存在。列表响应中省略。该字段存在与否可区分空文件与内容未加载两种情况。