パターンを読み込んでいます…
コンテキスト編集とツール結果のクリア(CETC)
トークンのしきい値を超えると、アクティブなコンテキストウィンドウから古くなった内容を自動的に退避させる、ハーネスまたは API レベルのプリミティブ。多くの場合、対応する tool_use のレコードはそのまま残しつつ、古い tool_result ブロックを短いプレースホルダーに外科的に置き換えることで実現する。ファイルの読み取り、検索ヒット、API のダンプは再取得できるため、推論コストゼロで破棄され、後のターンで実際に必要になった場合にのみ再取得される。これにより KV キャッシュのプレフィックスが安定し、長いループでのコンテキストの劣化(context rot)を抑えられる。Anthropic はこれを clear_tool_uses_20250919 および compact_20260112 として提供しており、100 ターンのウェブ検索評価で約 84% のトークン削減と 29〜39% の性能向上が報告されている。`context-compress-patterns` とは区別される:クリアは再取得可能な生の結果を可逆的に退避させるのであって、非可逆に要約するのではない。`filesystem-as-context` とは異なり明示的なディスクへの書き出し(オフロード)ステップを必要とせず、`memory-forgetting-policies` とは異なり長期記憶を減衰させることではなく、作業ウィンドウを剪定することを目的とする。
30秒でわかる概要
- 概要
- トークン上限が近づくと、古いツール結果の中身をコンテキストから自動的に取り除いてプレースホルダーに置き換え、ツール呼び出しの記録自体は残します。
- 使いどころ
- ツールの結果が消費される速さを上回ってたまっていき、その結果を外部のソースから取り直せる、長時間動き続けるエージェントのループで。
- 注意点
- 消した結果がツールを再実行せずに必要になった場合、プレースホルダーが記録の一貫性を損ない、取り直しを強いることになります。
このパターンについてAIエキスパートに質問
質問が入力済みの状態でアシスタントが開きます。送信前に内容を確認できます。
コンテキスト編集とツール結果のクリア: 概要
トークンのしきい値を超えると、アクティブなコンテキストウィンドウから古くなった内容を自動的に退避させる、ハーネスまたは API レベルのプリミティブ。多くの場合、対応する tool_use のレコードはそのまま残しつつ、古い tool_result ブロックを短いプレースホルダーに外科的に置き換えることで実現する。ファイルの読み取り、検索ヒット、API のダンプは再取得できるため、推論コストゼロで破棄され、後のターンで実際に必要になった場合にのみ再取得される。これにより KV キャッシュのプレフィックスが安定し、長いループでのコンテキストの劣化(context rot)を抑えられる。Anthropic はこれを clear_tool_uses_20250919 および compact_20260112 として提供しており、100 ターンのウェブ検索評価で約 84% のトークン削減と 29〜39% の性能向上が報告されている。`context-compress-patterns` とは区別される:クリアは再取得可能な生の結果を可逆的に退避させるのであって、非可逆に要約するのではない。`filesystem-as-context` とは異なり明示的なディスクへの書き出し(オフロード)ステップを必要とせず、`memory-forgetting-policies` とは異なり長期記憶を減衰させることではなく、作業ウィンドウを剪定することを目的とする。
- Threshold-triggered eviction fires automatically at a configured input-token budget
- Surgically clears the oldest tool_result blocks, replacing payloads with a short placeholder
- Keeps the tool_use call record so the transcript stays coherent and re-callable
- Zero inference cost: eviction is a harness edit, not a model summarization pass
- Re-fetchable by design, the agent re-runs the tool only when the data is needed again
- Preserves the KV-cache prefix on prior turns so cached tokens stay cheap
The Agent Architect
1つのパターン、1つのトレードオフ、1つの本番障害事例。エージェントシステムを構築する人のための短い週刊ブリーフィング。
週1回のメール、ワンクリックで購読解除できます。アドレスはブリーフィングの送信のみに使用します。
参考文献
このパターンの根拠となる論文、仕様、リポジトリです。
このカタログを作ったエンジニアが担当
エージェント構成をレビューします
このページが扱うのは1つのパターンです。実際のシステムは数十を組み合わせて動き、障害の多くはその繋ぎ目で起きます。カタログの288パターンに照らして設計全体をレビューします。アーキテクチャ、信頼性、評価、コストまで、指摘ごとに対応するパターンを示します。
€750(通常€1,500)・1週間・文書レポートとウォークスルーコール・9月30日まで