コンテキストエンジニアリング：AIエージェントが目にする情報の設計

コンテキストエンジニアリングとは？

コンテキストエンジニアリングは、エージェントの実行プロセスにおいて、各ステップでモデルが受け取る情報の全体を設計する学問です。エージェントのランタイムにおいて、コンテキストとはモデルが特定のステップで認識するすべての情報を指します。これにはシステム指示、スコープ内のスキル、利用可能なツールの定義、会話履歴、そしてツールから返される結果が含まれます。

これは単一のプロンプトよりもはるかに広範な領域です。しかも動的であり、ツールが呼び出されるたびにその結果が次のステップのコンテキストに追加されるため、エージェントの動作に伴って情報環境は常に変化し続けます。コンテキストエンジニアリングは、ノイズで溢れさせることなく、この環境を的確かつ関連性の高い状態に保ち、コストを最適化するための手法です。

エージェントのコンテキストに含まれるもの

• システム指示 エージェントがどのように振る舞うべきかを示す恒久的なガイダンス。
• スキル すべての手順をシステムプロンプトに詰め込むのではなく、特定のタスクに応じてエージェントが呼び出せる再利用可能な手順。
• ツール定義 MCPなどを通じて提供される、エージェントが呼び出しを許可されているツールとそのスキーマ。
• 会話履歴 進行中の対話と、エージェント自身による中間ステップの記録。
• ツール実行結果 各呼び出しの出力。これがコンテキストに再入力され、次のステップを形作る。

コンテキストエンジニアリングとプロンプトエンジニアリングの違い

両者は関連していますが、対象とする範囲が異なります。これらを混同することが、多くのチームが成長の壁に突き当たる原因となっています。プロンプトエンジニアリングが「このリクエストをどう表現するか」を問うのに対し、コンテキストエンジニアリングは「この仕事をうまく遂行するために、各ステップでモデルにどのような情報を提示すべきか」を問います。

どちらか一方がもう一方に取って代わるものではありません。指示を慎重に言葉にする必要は依然としてありますが、エージェント開発においては、それはより大きな設計課題のほんの一部に過ぎません。コンテキストウィンドウが拡大するにつれ、すべてを詰め込みたくなる誘惑に駆られますが、それこそがコンテキストエンジニアリングで回避すべき罠です。コンテキストの量は質を保証するものではなく、過負荷なウィンドウは情報の想起能力を低下させ、コストを増大させます。

成果に直結するテクニック

エージェントのコンテキストを設計する際、価値の大部分は少数のプラクティスによって決まります。

• 手順はシステムプロンプトではなく、スキルとして実装しましょう。 ワークフローやプレイブックのようなものは、関連する際にエージェントが読み込む「スキル」として定義し、ベースとなるコンテキストを軽量に保つのが鉄則です。スタイルガイドや安全ポリシーといった、常に必要となる短いガイダンスは積極的に読み込み、長文の手順や特定の状況でしか使わない手順は必要に応じて読み込むようにします。
• ツールのスコープを厳格に制限しましょう。 公開するツールが増えるほど、定義が消費するトークン量が増え、エージェントが誤作動を起こす可能性も高まります。エージェントには、その機能に必要なツールのみを与えてください。
• 履歴を計画的に管理しましょう。 古いやり取りは要約または切り捨てを行い、すべてのステップを逐一保持するのではなく、今重要な情報に焦点を当てたコンテキストウィンドウを維持します。
• ツールの実行結果は、信頼できないコンテキストとして扱いましょう。 結果は次のステップでモデルのコンテキストに再入力されるため、入力データと同様に、関連性と安全性の両面から検証する必要があります。

TrueFoundryによるコンテキストエンジニアリングの支援

コンテキストエンジニアリングは、各要素がエージェントごとに手作業で組み立てられるのではなく、適切に管理されて初めて持続可能なものとなります。TrueFoundryは、コンテキストの各パーツを制御するためのポイントを提供します。

In the Agent Harnessでは、エージェント構築時にシステムプロンプト、スコープ内のスキル、利用可能なMCPサーバーといったコンテキストを設定します。これにより、コンテキストはコード内に埋め込まれたものではなく、明示的かつレビュー可能な構成として管理されます。

• スキル。 スキルは中央の「スキルレジストリ」から提供されるため、エージェントのコンテキストに含まれる手順はバージョン管理やアクセス制御が可能になり、コピー＆ペーストではなく再利用できるようになります。常に必要な短いスキルはプリロードし、長いスキルは必要に応じて読み込むという、軽量コンテキストの核心的な手法を設定として実現できます。スキルフォーマットの仕組みについては、以下を参照してください。 Claude Skills for how the skill format works.
• ツール。 MCP Gatewayは、エージェントがアクセス可能なツールを制御し、個々のツール単位でアクセス範囲を制限できるため、コンテキスト内のツール定義をエージェントが必要とするものだけに絞り込むことができます。
• ツール実行結果の安全性。 ツール実行結果はコンテキストに再入力されるため、 AIエージェントのガードレールが 次のステップに影響を与える前に、ツール実行後のフックでインジェクションや機密データの有無を検査します。
• 可観測性。 すべてのステップがトレースされるため、エージェントが判断を下した際にコンテキストに何が含まれていたかを正確に把握できます。これにより、コンテキストエンジニアリングは推測による作業ではなく、反復可能なプロセスとなります。

その基盤となる AI Gateway は、1,000種類以上のモデルへの各呼び出しをわずか3〜4ミリ秒のオーバーヘッドでルーティングします。そのため、特定のステップに最適なモデルを選択することは、コードの書き直しではなく、ルーティング設定の変更だけで済みます。その結果、コンテキストは各エージェントのコーディング方法に依存する副産物ではなく、一元的に設計・管理できるものとなります。

結論

コンテキストエンジニアリングとは、単一のプロンプトを調整することから、エージェントの実行全体を通じてモデルが目にするすべての情報を設計することへの転換です。指示、スキル、ツール、履歴、そしてツール実行結果を適切に管理すれば、エージェントは高い集中力とコスト効率を維持できます。逆にこれらが不適切であれば、どれほどプロンプトを調整しても改善は望めません。TrueFoundryは、Agent Harness、Skills Registry、MCP Gateway、そして完全なトレーシング機能を通じて、これらの要素を管理可能な構成へと変えます。これにより、コンテキストは「成り行き任せ」のものではなく、あなたが設計し管理するものとなります。

TrueFoundryがどのようにして単一のコントロールプレーンからエージェントのコンテキストを制御できるかをご確認ください。 デモを予約する または 無料で始める。