Claude API

Managed Agents Agent Memory APIに新ベータヘッダー（agent-memory-2026-07-22）— メモリリスト挙動の安定化・パスプレフィックス検証強化でメモリストア操作の信頼性が向上

元記事を読む(platform.claude.com) ↗

Summary

Managed Agents APIのメモリストアエンドポイントに新しいベータヘッダー`agent-memory-2026-07-22`が導入。主要変更: (1)メモリリスト（GET /v1/memory_stores/{id}/memories）の結果がサーバー定義の安定した順序で返却され、order_by・orderパラメータが無視される。(2)depthパラメータが0・1・省略のみ受け付け、他の値は400エラーを返却。(3)path_prefixが末尾に/を要求し、部分文字列ではなくパスセグメント全体でマッチ。メモリストアエンドポイントでは`agent-memory-2026-07-22`が`managed-agents-2026-04-01`を置換し、両方を同時に送信すると400エラー。7月22日以降は`managed-agents-2026-04-01`も同一のリスト挙動を採用予定。

Key Takeaways

  • ▸ メモリリストの安定した順序保証でページネーション・増分同期の信頼性が向上 — order_by無視は破壊的変更のため既存コードの確認が必要
  • ▸ depthの厳格化（0/1/省略のみ）でメモリツリーの浅い探索に限定 — 深いネスト構造の一括取得パターンは設計変更が必要
  • ▸ path_prefixのセグメントマッチ強制で意図しないメモリの部分一致取得を防止 — セキュリティとデータ整合性が向上
  • ▸ 7月22日に旧ヘッダーの自動移行があるため早期移行が推奨

Best Practice Updates

  • ✓ Managed Agents APIのメモリストアエンドポイントは`agent-memory-2026-07-22`ヘッダーに移行すべき — 7月22日の自動移行前に動作確認を完了推奨
  • ✓ メモリリストのorder_by依存コードは安定順序への適応が必要 — カスタムソートはクライアント側で実装すべき

Same Day Signals

すべて見る →

元記事の著作権は各著作者に帰属します。