Memory Store データ構造

Memory Store オブジェクト

create、get、list、archive エンドポイントで Memory Store オブジェクトが返却されます。

フィールド	型	説明
`id`	string	`memstore_` プレフィックス付きの Memory Store ID
`type`	string	固定値 `"memory_store"`
`name`	string	ストア名。サーバーによりトリミングされます。最大 64 文字
`description`	string	ストアの説明。サーバーによりトリミングされます。最大 1024 文字
`status`	string	ストアのステータス。Memory Store ステータスを参照
`entry_count`	integer	ストア内のアクティブな Memory エントリ数
`total_size`	integer	アクティブな Memory エントリの合計サイズ（バイト）
`metadata`	メタデータオブジェクト	カスタムメタデータ。デフォルトは `{}`
`archived_at`	string	UTC でのアーカイブ時刻、ストアがアーカイブされている場合のみ返却
`created_at`	string	UTC での作成時刻
`updated_at`	string	UTC での最終更新時刻

値	説明
`active`	ストアは新しい Memory エントリの追加とエントリの更新を受け付けます
`archived`	ストアはアーカイブ済み。エントリとバージョンは読み取り可能ですが、エントリの作成や更新はできません

create entry、get entry、list entries、update entry エンドポイントで Memory エントリオブジェクトが返却されます。

フィールド	型	説明
`id`	string	`mem_` プレフィックス付きの Memory エントリ ID
`type`	string	固定値 `"memory"`
`store_id`	string	所有する Memory Store の ID
`path`	string	相対メモリパス。最大 1024 バイト。`/` で始めることはできず、`..` を含めることはできません
`size`	integer	コンテンツサイズ（バイト）
`content_sha256`	string	現在のコンテンツの SHA-256 ダイジェスト
`version`	integer	現在のエントリバージョン。最初のバージョンは `1` で、更新ごとにインクリメントされます
`metadata`	メタデータオブジェクト	カスタムメタデータ。デフォルトは `{}`
`content`	string	create、get、update レスポンスでコンテンツが利用可能な場合に返却。list レスポンスでは省略
`created_at`	string	UTC での作成時刻
`updated_at`	string	UTC での最終更新時刻

エントリの content は作成時と更新時に必須です。トリミング後に非空でなければならず、最大 100 KB です。

list versions および get version エンドポイントで Memory バージョンオブジェクトが返却されます。

フィールド	型	説明
`id`	string	`memver_` プレフィックス付きの Memory バージョン ID
`type`	string	固定値 `"memory_version"`
`store_id`	string	所有する Memory Store の ID
`entry_id`	string	Memory エントリ ID
`entry_path`	string	このバージョンが記録された時点でのエントリパス
`size`	integer	バージョンコンテンツのサイズ（バイト）
`content_sha256`	string	バージョンコンテンツの SHA-256 ダイジェスト
`action`	string	バージョンアクション。Memory バージョンアクションを参照
`redacted`	boolean	バージョンコンテンツが墨消しされているかどうか
`redacted_at`	string	UTC での墨消し時刻、`redacted` が `true` の場合のみ返却
`content`	string	get version でのみ返却。バージョンが墨消しされておらず、コンテンツが利用可能な場合
`created_at`	string	UTC での作成時刻

値	説明
`created`	エントリが作成された
`updated`	エントリのコンテンツが更新された
`deleted`	エントリが削除された。履歴バージョンレコードにこのアクションが含まれる場合があります

Memory Store と Memory エントリの metadata フィールドは共通のメタデータオブジェクトを使用します: 最大 16 個のキーバリューペア、キーは最大 64 文字、文字列値は最大 512 文字です。

Agent に Session をまたいだ永続メモリを与える。