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 版本) |