https://platform.claude.com/docs/en/managed-agents/memory
- Managed Agentsのセッションはデフォルトで毎回まっさらなコンテキストから始まり、セッション終了で状態は消える。memory store を使うとセッションをまたいで情報(ユーザーの好み、プロジェクト規約、過去のミス、ドメイン知識)を引き継げる
- memory store
- ワークスペース単位のテキストドキュメント集。セッションに紐付けると、サンドボックス内の
/mnt/memory/配下にディレクトリとしてマウントされる - エージェントは通常のファイルツールで読み書きでき、書き込みはstoreに永続化されて共有セッション間で同期される
- 個々のmemoryは最大100kB(約25kトークン)、1 storeあたり最大2,000件。小さく焦点を絞ったファイルを多数置く構成が推奨
- ワークスペース単位のテキストドキュメント集。セッションに紐付けると、サンドボックス内の
- 利用の流れ
memory_stores.createでstoreを作成(nameと、エージェントに渡されるdescriptionを指定)。事前にコンテンツをseedすることも可能- セッション作成時の
resources[]でアタッチする(実行中のセッションへの追加・削除は不可、1セッション最大8 store) accessはread_write(デフォルト)かread_only。プロンプトインジェクション対策として、変更不要な参照用storeはread_onlyにするのが安全
- 管理・監査
- API/ConsoleからmemoryをCRUD可能。更新時に
content_sha256をpreconditionに渡せば楽観的並行制御で上書き衝突を防げる - 変更ごとにimmutableな memory version が作られ、監査証跡・特定時点へのロールバック・redact(機密情報の除去)ができる(バージョンは原則30日保持)
- API/ConsoleからmemoryをCRUD可能。更新時に
- memoryの更新は誰がやる?
read_writeでアタッチすれば、エージェントが自分で読み書きする(開発者がAPIを叩かなくてよい)。ただしagent toolsetの有効化が前提で、いつ読み書きするかはinstructionsで誘導するread_onlyなら書き込み不可(参照専用)。APIから手動でCRUDすることも可能