コンテキストエンジニアリング
コンテキストエンジニアリングは、LLMタスクのために高シグナルの最小トークンセットを厳選します。目標は、トークン使用量を最小限に抑えながら推論品質を最大化することです。
アクティブ化するタイミング
- エージェントシステムの設計/デバッグ
- コンテキスト制限がパフォーマンスを制約する場合
- コスト/レイテンシの最適化
- マルチエージェント連携の構築
- メモリシステムの実装
- エージェントパフォーマンスの評価
- LLMパイプラインの開発
中核原則
- コンテキストの質 > 量 - 高シグナルトークンが網羅的なコンテンツに勝る
- 注意は有限 - U字曲線により先頭/末尾の位置が有利
- 段階的な開示 - 情報をジャストインタイムで読み込む
- 分離による劣化防止 - 作業をサブエージェントに分割する
- 最適化前に測定 - ベースラインを把握する
重要:
- 簡潔さのために文法を犠牲にする。
- 高品質を維持しつつトークン効率を確保する。
- これらのルールをサブエージェントに渡す。
クイックリファレンス
| トピック | いつ使うか | リファレンス |
|---|---|---|
| 基礎 | コンテキストの構造、アテンションの仕組みを理解する | context-fundamentals.md |
| 劣化 | 障害のデバッグ、Lost-in-the-Middle、ポイズニング | context-degradation.md |
| 最適化 | 圧縮、マスキング、キャッシング、分割 | context-optimization.md |
| 圧縮 | 長いセッション、要約戦略 | context-compression.md |
| メモリ | セッション間の永続化、ナレッジグラフ | memory-systems.md |
| マルチエージェント | 連携パターン、コンテキスト分離 | multi-agent-patterns.md |
| 評価 | エージェントのテスト、LLM-as-Judge、メトリクス | evaluation.md |
| ツール設計 | ツールの統合、説明文エンジニアリング | tool-design.md |
| パイプライン | プロジェクト開発、バッチ処理 | project-development.md |
| ランタイム認識 | 使用制限、コンテキストウィンドウの監視 | runtime-awareness.md |
主要メトリクス
- トークン使用率: 70%で警告、80%で最適化をトリガー
- トークン分散: エージェントパフォーマンスのばらつきの80%を説明
- マルチエージェントコスト: シングルエージェントの約15倍
- 圧縮目標: 50~70%削減、品質低下5%未満
- キャッシュヒット目標: 安定したワークロードで70%以上
4バケット戦略
- 書き出し: コンテキストを外部に保存(スクラッチパッド、ファイル)
- 選択: 関連コンテキストのみを取得(検索、フィルタリング)
- 圧縮: 情報を保持しつつトークンを削減(要約)
- 分離: サブエージェント間で分割(パーティショニング)
アンチパターン
- 厳選されたコンテキストよりも網羅的なコンテキスト
- 中間位置に重要な情報を配置
- 制限前に圧縮トリガーがない
- 並列化可能なタスクにシングルエージェントを使用
- 明確な説明のないツール
ガイドライン
- 重要な情報をコンテキストの先頭/末尾に配置する
- 70~80%の使用率で圧縮を実装する
- コンテキスト分離にはサブエージェントを使用し、ロールプレイには使用しない
- ツールは4つの質問フレームワーク(何を、いつ、入力、戻り値)で設計する
- リクエストあたりのトークンではなく、タスクあたりのトークンを最適化する
- プローブベースの評価で検証する
- 本番環境でKVキャッシュヒット率を監視する
- 最小限から始め、必要な場合にのみ複雑性を追加する
ランタイム認識
システムはPostToolUseフックを介して使用状況認識を自動的に注入します。
<usage-awareness>
Claude Usage Limits: 5h=45%, 7d=32%
Context Window Usage: 67%
</usage-awareness>
しきい値:
- 70%: WARNING - 最適化/圧縮を検討
- 90%: CRITICAL - 即座に対応が必要
データソース:
- 使用制限: Anthropic OAuth API (
https://api.anthropic.com/api/oauth/usage) - コンテキストウィンドウ: ステータスラインテンポラリファイル (
/tmp/ck-context-{session_id}.json)
スクリプト
- context_analyzer.py - コンテキスト健全性分析、劣化検出
- compression_evaluator.py - 圧縮品質評価