Memory stores (メモリストア)

メモリストアはワークスペース単位のテキスト文書の集まりで、セッションに接続するとサンドボックス内のディレクトリとしてマウントされます。エージェントは、ほかのファイルと同じファイルツールでこのディレクトリを読み書きします。

メモリストアは Claude 向けに最適化されたテキスト文書の集まりで、ワークスペース単位で管理します。エージェントからの見え方は次のとおりです。

• 各マウントを説明する注記がシステムプロンプトに自動で追加され、エージェントにどこを見ればよいかを伝えます。
• エージェントがストアを扱うには agent toolset が必要で、エージェント作成時に有効にしておきます。
• 接続した各ストアは /mnt/memory/ 配下のディレクトリにマウントされます。正確なパスはセッションのメモリストアリソースの mount_path フィールドで返されるため、自分で組み立てずにそこから読み取ります。
• マウントパス配下への書き込みはストアに保存され、同じストアを共有するセッション間で同期されます。/mnt/memory/ 配下のそれ以外のパスへの書き込みは、親ディレクトリが読み取り専用でマウントされるため失敗します。
• エージェントによるメモリの読み書きは、イベントストリーム上で通常の agent.tool_use と agent.tool_result イベントとして現れます。

• 任意の instructions で、そのセッションでストアをどう使うかの指示を与えられます。ストアの name・description と並んでエージェントに示され、上限は 4,096 文字です。
• access の既定値は read_write で、read_only も指定できます。アクセスはファイルシステムのレベルで強制され、read_only のマウントは書き込みを拒否し、read_write のマウントへの書き込みはそのセッションに紐づくメモリバージョンを作ります。
• 参考資料、共有の参照データ、エージェントが変更する必要のないストアには read_only を使うのが推奨です。信頼できない入力を経由したプロンプトインジェクションによって、read_write のストアに悪意ある内容が書き込まれる場合があるためです。
• メモリの部分ごとに所有者やアクセスルールが異なる場合は、複数のストアを接続できます。

• メモリストアは API で直接管理でき、レビューのワークフロー構築、誤ったメモリの修正、セッション実行前のストアへの事前投入に使えます。ストア内の各メモリはパスで指定し、API または Claude Console から直接読み取り・編集できます。
• 一覧取得は path_prefix でディレクトリに絞り込めます。depth を省略するか 0 を渡すとサブツリー全体、1 を渡すと直下の項目だけを返します。
• メモリの作成は既存のメモリを上書きしません。既存のメモリを ID で更新すると、content、path (名前の変更)、またはその両方を変更できます。
• 同時に行われた書き込みを上書きしないよう、content_sha256 の前提条件を渡せます。保存されている内容のハッシュが読み取ったときのものと一致する場合だけ更新が適用され、一致しない場合はメモリを読み直して最新の状態に対して再試行します。
• 専用の復元エンドポイントはありません。元に戻すには、目的のバージョンを取得し、その content を POST /v1/memory_stores/{memory_store_id}/memories/{memory_id} で書き戻します。
• redact は、監査証跡 (誰がいつ何をしたか) を残したまま過去のバージョンから内容を除去します。現在のメモリの最新版 (head) にあたるバージョンは redact できません。
• バージョンは個々のメモリではなくストアに属し、メモリを削除しても消えません。そのため、監査証跡は保持期間の範囲内で削除済みのメモリも対象にします。

セルフホストのサンドボックスで実行する Claude Managed Agents のセッションでも、メモリストアを接続できます。Python・TypeScript・Go の SDK ワーカーが、接続された各ストアをサンドボックス内の mount_path にダウンロードし、エージェントの変更をストアに同期し戻します。

この場合、各ストアのディレクトリはライブマウントではなく、ワーカーが管理するローカルのコピーです。ワーカーはツール呼び出しの後と、セッション終了時にもう一度、このコピーをストアと突き合わせます。

• Memory for Claude Managed Agents はベータ提供です。対象プランや提供地域は、公式のリリースノートには記載がありません。
• メモリストアは create・retrieve・update・list・archive・delete の各操作に対応しています。
• アーカイブするとストアは読み取り専用になり、新しいセッションに接続できなくなります。アーカイブは一方向で、元に戻す操作はありません。
• DELETE /v1/memory_stores/{memory_store_id} を呼ぶと、ストアとそのすべてのメモリ・バージョンが完全に削除されます。

1. name と description を指定してメモリストアを作成します。description はエージェントに渡され、ストアに何が入っているかを伝えます。
2. 必要に応じて、エージェントを実行する前に参考資料をストアに入れておきます。
3. セッション作成時に、セッションの resources 配列にメモリストアの id (memstore_...) を含めて接続します。接続できるのはセッション作成時だけで、実行中のセッションへの追加・取り外しには対応していません。