メッセージコンテキスト管理

コンパクションの概要

Copy page



コンパクションの機能、オンデマンドコンパクションとトークンしきい値でのコンパクションの違い、そしてタスクに応じて参照すべきページについて説明します。

「compaction」（コンパクション）は、会話の古いターンを、Claudeがサーバー上で作成した要約に置き換えます。そのため、独自の要約コードは必要ありません。コンパクションにより、長い会話やエージェントタスクを「context window」（コンテキストウィンドウ）内に収められます。また、会話が長くなるにつれて応答品質が低下するため、アクティブなコンテキストを小さく保つ役割も果たします。

この概要を読み飛ばしたい場合は、オンデマンドのコンパクションから始めて、アプリケーションにコンパクションを追加してください。これとトークンしきい値でのコンパクションはどちらもベータ版ですが、オンデマンドのコンパクションの方がより一般的なユースケースをカバーしています。古いツール結果や古い思考ブロックを要約するのではなくルールに基づいてクリアするには、コンテキスト編集を参照してください。

コンパクション方法の選択

オンデマンドコンパクションが利用可能な場合は、常にそちらを使用してください。

オンデマンドコンパクションのオプション

オンデマンドコンパクションでは、アプリケーションが待機している間に会話全体を要約するループを紹介しています。このリストの最初の2つのページは、そのループの実行方法を変更するもので、組み合わせて使用できます。3つ目のページは、思考ブロックを送り返し、かつそのいずれかを行う場合に該当します。

• 直近のターンを保持するコンパクション：最後の数ターンを一字一句そのままClaudeに渡す必要がある場合。要約の対象は古いターンのみになります。
• バックグラウンドでのコンパクション：要約のために会話を一時停止できない場合。作業を続けている間にリクエストが実行され、ブロックが届いた時点で差し替えます。
• コンパクションと思考の保持：思考の保持に対応したモデルで思考ブロックを送り返し、かつ直近のターンを保持するか、バックグラウンドでコンパクションを行う場合。それ以外の場合は読み飛ばしてください。
• 独自の要約プロンプトを作成する：デフォルトの要約では、後のターンで必要な情報が失われる場合。独自のプロンプトがデフォルトのプロンプトに置き換わります。
• 再度コンパクションする：すでにコンパクションブロックで始まっている会話が、再び長くなった場合。

以下のトピックは他のページにあります：

• 要約をリクエストするは、オンデマンドのコンパクションのページにあります。
• 要約から続行するは、オンデマンドのコンパクションのページにあります。保持するターンで思考を有効に保つための条件は、コンパクションと思考の保持にあります。
• 要約が返されない場合：オンデマンドのコンパクションのページにある要約の欠落またはエラーへの対処を参照してください。
• API の他の部分との関係：オンデマンドのコンパクションのページにある制限と他の機能との相互作用を参照してください。
• 使用量の理解：オンデマンドのコンパクションについてはコンパクションの使用量のカウントを、しきい値コンパクションについては使用量の理解を参照してください。
• 互換性：それぞれの種類に独自のベータヘッダーがあるため、各ページにそれぞれのセクションがあります：オンデマンドのコンパクションのAPIサポートおよびしきい値コンパクションのAPIサポート。

しきい値コンパクションには専用のページがあります：トークンしきい値でのコンパクション。