Memory Store 数据结构

更新时间:
复制 MD 格式

Memory Store、Memory 和 Memory Version 的对象结构。

Memory Store 对象

字段

类型

说明

id

string

Memory Store ID,前缀为 memstore_

type

string

固定值 "memory_store"

name

string

Store 名称

description

string

Store 描述,未设置时为空字符串

status

string

Store 状态,见 Memory Store status

entry_count

integer

Store 内活跃 memory 数量

total_size

integer

Store 内活跃 memory 内容总大小,单位 byte

metadata

object

自定义键值元数据

archived_at

string | null

UTC 归档时间,未归档时为 null

created_at

string

RFC 3339 创建时间

updated_at

string

RFC 3339 最后更新时间

Memory Store status

说明

active

可以创建和更新 memory

archived

memory 与 version 可读取,但不能创建或更新 memory

Memory 对象

字段

类型

说明

id

string

Memory ID,前缀为 mem_

type

string

固定值 "memory"

memory_store_id

string

所属 Memory Store ID

path

string

Memory 路径

content_size_bytes

integer

内容大小,单位 byte

content_sha256

string

内容的 SHA-256 摘要

version

integer

当前版本,初始为 1,每次更新自动递增

metadata

object

自定义键值元数据

content

string

完整内容,仅在创建、更新和单条查询时返回,列表响应不返回

created_at

string

RFC 3339 创建时间

updated_at

string

RFC 3339 最后更新时间

Memory Version 对象

字段

类型

说明

id

string

Memory Version ID,前缀为 memver_

type

string

固定值 "memory_version"

memory_store_id

string

所属 Memory Store ID

memory_id

string

所属 Memory ID

path

string

记录该版本时的 memory 路径

content_size_bytes

integer

版本内容大小,单位 byte

content_sha256

string

版本内容的 SHA-256 摘要

operation

string

版本动作,见 Memory Version operation

redacted

boolean

版本内容是否已 redact

redacted_at

string

RFC 3339 redact 时间,仅 redacted 为 true 时返回

content

string

版本内容,仅在单条查询且未 redact 时返回

created_at

string

RFC 3339 创建时间

Memory Version operation

说明

created

memory 被创建

updated

memory 内容被更新

deleted

memory 被删除(记录为 tombstone 版本)