Memory Store 数据结构

Memory Store 对象

创建、查询、列表和归档接口都会返回 Memory Store 对象。

字段	类型	说明
`id`	string	Memory Store ID，前缀为 `memstore_`
`type`	string	固定值 `"memory_store"`
`name`	string	Store 名称。服务端会去除首尾空白，最长 64 字符
`description`	string	Store 描述。服务端会去除首尾空白，最长 1024 字符
`status`	string	Store 状态，见 Memory Store status
`entry_count`	integer	Store 内 active memory entry 数量
`total_size`	integer	Store 内 active memory entry 总大小，单位 byte
`metadata`	Metadata 对象	自定义元数据，省略时为 `{}`
`archived_at`	string	UTC 归档时间，仅已归档时返回
`created_at`	string	UTC 创建时间
`updated_at`	string	UTC 最后更新时间

值	说明
`active`	Store 可以创建新的 memory entry，也可以更新 entry
`archived`	Store 已归档。entry 和 version 可读取，但不能创建或更新 entry

创建 entry、查询 entry、列表 entries 和更新 entry 会返回 Memory entry 对象。

字段	类型	说明
`id`	string	Memory entry ID，前缀为 `mem_`
`type`	string	固定值 `"memory"`
`store_id`	string	所属 Memory Store ID
`path`	string	相对 memory 路径。最长 1024 byte，不能以 `/` 开头，不能包含 `..`
`size`	integer	内容大小，单位 byte
`content_sha256`	string	当前内容的 SHA-256 摘要
`version`	integer	当前 entry 版本。初始版本为 `1`，每次更新自动递增
`metadata`	Metadata 对象	自定义元数据，省略时为 `{}`
`content`	string	创建、查询、更新响应中在内容可用时返回。列表响应不返回
`created_at`	string	UTC 创建时间
`updated_at`	string	UTC 最后更新时间

Entry content 在创建和更新时必填，trim 后不能为空，最大 100 KB。

列表版本和查询版本接口返回 Memory version 对象。

字段	类型	说明
`id`	string	Memory version ID，前缀为 `memver_`
`type`	string	固定值 `"memory_version"`
`store_id`	string	所属 Memory Store ID
`entry_id`	string	Memory entry ID
`entry_path`	string	记录该 version 时的 entry path
`size`	integer	版本内容大小，单位 byte
`content_sha256`	string	版本内容的 SHA-256 摘要
`action`	string	Version 动作，见 Memory version action
`redacted`	boolean	版本内容是否已 redact
`redacted_at`	string	UTC redact 时间，仅 `redacted` 为 `true` 时返回
`content`	string	仅查询未 redacted 且内容可用的单个 version 时返回
`created_at`	string	UTC 创建时间

值	说明
`created`	Entry 被创建
`updated`	Entry 内容被更新
`deleted`	Entry 被删除。历史 version 记录中可能存在该动作

Memory Store 和 memory entry 的 metadata 使用通用 Metadata 对象：最多 16 个键值对，key 最长 64 字符，value 必须是字符串且最长 512 字符。

让 Agent 拥有跨 Session 的持久记忆。