AnthropicのメモリストアAPI、ページネーションとパスのセマンティクスを変更—旧カーソルやクエリパラメータが無効になる可能性

Anthropicは、Claude Managed Agentsのメモリストアエンドポイントに`agent-memory-2026-07-22`の挙動を適用した。主な変更点は`GET /v1/memory_stores/{id}/memories`に集中している。サーバーは、ユーザーが指定できないものの安定した順序で結果を返すようになり、`order_by`と`order`は無視される。`depth`は省略するか、0または1に設定する必要がある。`path_prefix`はスラッシュで終わらなければならず、任意の部分文字列検索ではなく、完全なパスセグメント単位で照合される。

これらの制限は、メモリ同期処理に直接影響する。旧バージョンのカーソルは新しいセマンティクスでは再利用できないため、移行時には最初のページから再スキャンする必要がある。アプリケーションが新旧両方のbetaヘッダーを同時に送信すると、APIは400を返す。AnthropicのPython、TypeScript、Go、Java、Ruby、PHP、C#、CLI SDKはすでに新しいヘッダーを送信するよう変更されているが、`betas`を独自に上書きしているシステム、独自実装のHTTPクライアント、プロキシゲートウェイ経由で呼び出すシステムについては、引き続き手動での確認が必要だ。エンジニアリングチームはリクエストの成功だけを確認するのではなく、ディレクトリ列挙、増分同期、削除検出、再試行後の重複排除も検証すべきである。

メモリストア自体は、ワークスペーススコープのテキストファイル集合であり、sessionの作成時に`/mnt/memory/`へマウントし、読み取り専用または読み書き可能な権限を設定できる。これによりagentはsessionをまたいでユーザー設定やプロジェクト知識を保持できる一方、信頼境界も拡大する。最近の研究では、メモリファイルに仕込まれたプロンプトインジェクションが後続のsessionに影響を及ぼす可能性があり、攻撃成功率はモデル、標的、インタラクションの順序によって大きく変化することが示されている。したがって、新しい決定論的な列挙方式は監査と同期には有用だが、コンテンツの信頼性に関する問題は解決しない。デプロイ担当者は次のステップとして、メモリへの書き込みを権限を伴う状態変更として扱い、出所ラベル、バージョンレビュー、読み取り専用マウント、異常な変更に対するアラートを導入すべきである。