ホームへ戻る

代理工具

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

Claude Managed Agentsのメモリ一覧取得には7月22日付で新ルールが適用され、安定した並び順、ディレクトリ形式のプレフィックス照合、クエリ深度の制限などが導入された。これは単なるSDKのヘッダー変更ではなく、既存の同期プログラムで400エラー、項目の取りこぼし、カーソルの無効化が発生する可能性がある。

Прикли · CC0 · Image source
zh-Hant

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に影響を及ぼす可能性があり、攻撃成功率はモデル、標的、インタラクションの順序によって大きく変化することが示されている。したがって、新しい決定論的な列挙方式は監査と同期には有用だが、コンテンツの信頼性に関する問題は解決しない。デプロイ担当者は次のステップとして、メモリへの書き込みを権限を伴う状態変更として扱い、出所ラベル、バージョンレビュー、読み取り専用マウント、異常な変更に対するアラートを導入すべきである。

出典

  1. Claude Platform release notes
  2. Bad Memory: Evaluating Prompt Injection Risks from Memory in Agentic Systems