Cache Diagnostics Beta公開 — プロンプトキャッシュミスの原因特定でエージェントループのAPIコストを最適化

Summary

Claude APIのCache Diagnostics機能がパブリックベータとして利用可能に（ベータヘッダー: `cache-diagnosis-2026-04-07`）。プロンプトキャッシュの予期しないミスの原因を特定し、キャッシュヒット率を最適化するための診断ツール。仕組み: (1)APIがリクエストごとに軽量フィンガープリントを保存、(2)次のリクエストで`diagnostics.previous_message_id`に前回レスポンスIDを指定、(3)APIがプレフィックスの最初の乖離点を検出し`diagnostics`オブジェクトとして返却。エージェントループ・マルチターン会話でのキャッシュミスが可視化され、キャッシュヒット率改善によるAPIコスト削減が可能。Opus 4.8のプロンプトキャッシュ最小長1,024トークンへの短縮と合わせ、短いプロンプトでもキャッシュ活用が可能に。現在Claude API直接接続のみで利用可能（Bedrock・Vertex AI非対応）。mid-conversation system messagesと組み合わせることでキャッシュヒット率を維持しつつ動的指示更新が実現できる。