パターンを読み込んでいます…
ツール利用
外部ツールの統合と関数呼び出しのパターン
30秒でわかる概要
- 概要
- AI システムを外部のツール、API、データベース、サービスに接続し、エージェントが計算、データ取得、ファイル操作、システムとのやり取りなど、テキスト生成を超えた行動を実行できるようにする。
- 使いどころ
- 学習データに含まれないリアルタイム情報が必要なタスク、テキストでは扱えない正確な計算、API やデータベースとのやり取り、あるいはファイルやシステムの操作。
- 注意点
- ツールが失敗したり利用できなくなったりしたときのエラー処理が不十分だと、それが連鎖してシステム障害やワークフローの破綻につながる。
これらのパターンについてAIエキスパートに聞く
質問が入力済みの状態でアシスタントが開きます。送信前に内容を確認できます。
概要
ツール利用パターンにより、AIシステムは外部のツール、API、データベース、サービスと連携して能力を拡張できます。これらのパターンによって、AIエージェントはテキスト生成にとどまらない行動、たとえば計算の実行、リアルタイムデータへのアクセス、コードの実行、ファイルの操作、外部システムとの連携などを行えるようになり、自律的に遂行できるタスクの範囲が飛躍的に広がります。
実践的な応用とユースケース
データ分析
分析ツールやデータベースと連携し、複雑なデータ処理と可視化を行います。
コード実行
さまざまなプログラミング言語のコードを実行・テストして機能を検証し、結果を提供します。
API 連携
天気データや金融情報、サードパーティ機能を得るために外部サービスと接続します。
ファイル管理
さまざまな形式やストレージシステムにまたがって、ファイルや文書の読み取り・書き込み・操作を行います。
数学的計算
複雑な数学演算や科学計算のために専用の計算ツールを利用します。
ウェブ自動化
ウェブサービスとの連携、データのスクレイピング、ブラウザ上のタスクの自動化を行います。
システム管理
システム操作の実行、リソースの監視、インフラの管理を行います。
コンテンツ制作
画像生成、動画編集、文書のフォーマットのために専用ツールを活用します。
なぜ重要か
ツール利用パターンは、実世界のシステムと連携して具体的な行動を実行できる、実用的なAIエージェントを作るうえで根幹をなします。AIの推論能力と実用的な有用性との隔たりを埋め、エージェントが最新の情報にアクセスし、精密な計算を行い、外部システムとの連携が必要なタスクを実行できるようにします。この能力は、AIを単なるテキスト生成ツールから、多用途な自動化プラットフォームへと変えます。
実装ガイド
使用する場面
- 学習データに含まれない、リアルタイムまたは最新の情報を必要とするタスク
- テキスト生成の枠を超えた精密な計算やデータ分析を必要とするアプリケーション
- 外部の API やデータベースと連携する必要があるシステム
- ファイル操作やシステム操作を必要とするワークフロー
- 生成されたコードの検証や実行が必要となるシナリオ
- 既存の業務システムとの統合を必要とするアプリケーション
ベストプラクティス
- ツールの障害やネットワークの問題に備えた堅牢なエラー処理を設計する
- ツールへのアクセスに対して適切な認証とセキュリティ対策を実装する
- 統合と保守を簡素化するためにツールの抽象化レイヤーを用いる
- セキュリティ上の問題を防ぐために、ツールの入力を検証し出力をサニタイズする
- ツールの利用に対してレート制限とリソース管理を実装する
- 利用可能な各ツールについて明確なドキュメントと例を提供する
- 最適化の機会を見つけるためにツールの利用状況とパフォーマンスを監視する
よくある落とし穴
- エラー処理が不十分なため、ツールが利用できないときにシステム障害を招くこと
- 不適切な入力検証や過剰な権限に起因するセキュリティの脆弱性
- AI の能力だけで対応できるタスクに対してもツールに過度に依存すること
- ツールの選択を誤り、非効率または不正確なタスク実行を招くこと
- 外部ツールの利用がもたらすレイテンシとコストへの影響を考慮しないこと
- デバッグのためのツールとのやり取りの監視やログ記録が不十分であること
利用できる技術
関数呼び出し
AIが外部の関数やAPIを呼び出すための構造化されたインターフェースです
コード実行
LLMが生成したコードを隔離された環境で安全に実行し、計算やデータ処理を行います
Model Context Protocol(MCP)
AIモデルとツールの間でコンテキストと機能を共有するための標準化されたプロトコルです
ツールとしてのコントロールプレーン(CPT)
エージェントには単一の統合されたツールインターフェースを公開し、内部のコントロールプレーンが各リクエストをその背後にある適切なツール、サービス、モデルへとルーティングします。ツールカタログが進化してもエージェントのプロンプトは安定したまま保たれ、認証、ポリシー、レート制限、可観測性が一箇所で強制されます。
コンピュータ操作(CU)
エージェントは、APIを呼び出す代わりにスクリーンショットを読み取ってマウスやキーボードの操作を発行することで、人間と同じようにグラフィカルユーザーインターフェース(デスクトップ、ブラウザ、モバイル)を操作します。中核となる課題はGUIグラウンディング、すなわち意図を画面上の正確なピクセル座標に対応づけることです。エージェントは、タスクが完了するまでスクリーンショット、推論、行動、観察のループを繰り返します。
エージェントスキル(AS)
自己完結型のフォルダとしてパッケージ化された機能です。各スキルは、YAMLフロントマター(名前と説明)に加えて任意のスクリプトやリソースを含むSKILL.mdファイルです。エージェントはメタデータによってスキルを発見し、3段階の段階的開示を通じてそれらを読み込みます。すなわち、名前と説明を読んで関連性を判断し、有効化されると完全なSKILL.mdを読み込み、その後、必要に応じてバンドルされたスクリプトやリソースを実行します。これによりコンテキストを小さく保ちながら多数の機能を利用でき、このフォーマットはベンダーを問わず採用されているオープンな標準です。
ツールリトリーバル(Tool RAG)(TR)
エージェントが数百から数千のツールやMCPサーバーにアクセスできる場合、すべてのスキーマをプロンプトに読み込むのはコストが高く、選択精度を低下させます。ツールリトリーバルはツール定義をインデックス化し、モデルが選択する前に、クエリごとに意味的に関連するものだけを取得します(埋め込み検索、アクティブディスカバリー、リランキング)。RAG-MCPは、ツール選択の精度が約13パーセントから43パーセントへ向上し、プロンプトのトークン数を半分以上削減したと報告しています。
構造化出力(SO)
デコードを制約することで、モデルの出力がスキーマに準拠することを保証します。JSON Schema、正規表現、または文法が有限状態機械にコンパイルされ、各デコードステップでスキーマに違反するトークンがマスクされるため、有効な継続のみがサンプリングされます。厳格モードでは、これにより不正な形式のJSONや無効なツール引数が発生し得なくなります。この機能はOpenAI、Google、Anthropicでネイティブに利用でき、OutlinesやvLLMといったオープンなライブラリでも利用できます。
アクションとしてのコード(CodeAct)(CA)
1ターンごとに1つのJSONツール呼び出しを出力する代わりに、エージェントの行動空間は、ループ、条件分岐、変数を用いてツールをオーケストレーションする実行可能なコードになります。1つのコードブロックで多数のツールを呼び出し、結果に応じて分岐し、あらゆる結果をコンテキストウィンドウ経由で返す代わりに中間データをランタイム内に保持できます。Anthropicは、MCP経由でコードからツールを呼び出す場合、一部のマルチツールワークフローでトークンを約98パーセント削減できたと報告しています。
構造化リフレクション(Think Tool)
エージェントのツールスキーマに宣言される、専用で副作用のない「think」ツール(Anthropic)です。モデルは軌道の途中でこれを呼び出し、ツールの結果と次の行動との間に構造化された推論を追加します。この呼び出しは外部への影響を持たず、有用な値も返しません。つまり、長いツール呼び出しの連鎖の中で行動する前に、ポリシーを読み直し、制約を検証し、計画を立てるためのチェックポイントをモデルに与えるだけです。Anthropicは、このツールを使い方を示すプロンプトと組み合わせた場合、tau-benchのpass^1 airlineメトリクスで54%の相対的改善(ベースラインの0.370に対して0.570)が得られたと報告しています。これは`metacognitive-monitoring`とは異なります。すなわち、あの項目は自らの推論を監視する一般的な能力を指すのに対し、think toolはそのための具体的なツールスキーマ上の仕組みであり、最初の応答の前に行われる拡張思考や推論時の思考とは別物です。
MCPゲートウェイ(ツールのフェデレーションとガバナンス)(MCPG)
多数のバックエンドMCPサーバーの前段にリバースプロキシとして配置される、単一の統制されたMCPエントリポイント。各サーバーのツールを、エージェントが接続する一つの精選・管理されたツール面へと集約(フェデレーション)する。すべてのツール呼び出しはこのゲートウェイを経由し、集中認証、呼び出し元のアイデンティティを下流サーバーの権限から分離するツール単位の認可、ポリシー検査、レート制限、監査ログ、テレメトリを適用する。これにより、独立してデプロイされたサーバーの雑然とした集まりが、単一の統制された統合契約へと変わり、各エージェントに手を加えることなくツールを精選・バージョン管理・失効できる。`control-plane` とは区別される。コントロールプレーンは、単一のインターフェースを公開しつつ内部的に任意のツール・サービス・モデルへルーティングするという一般的なパターンであるのに対し、MCPゲートウェイは、多数のMCPサーバーの集約と共有されるツールアクセス面の統制に焦点を当てた、MCPエコシステム固有の実装である。
Patterns Pack
カタログ全体を持ち歩く:MCPサーバー、エディタ用のルールとスキル、データ。
The Agent Architect
1つのパターン、1つのトレードオフ、1つの本番障害事例。エージェントシステムを構築する人のための短い週刊ブリーフィング。
週1回のメール、ワンクリックで購読解除できます。アドレスはブリーフィングの送信のみに使用します。
このカタログを作ったエンジニアが担当
エージェント構成をレビューします
このページが扱うのは1つのパターンです。実際のシステムは数十を組み合わせて動き、障害の多くはその繋ぎ目で起きます。カタログの288パターンに照らして設計全体をレビューします。アーキテクチャ、信頼性、評価、コストまで、指摘ごとに対応するパターンを示します。
€750(通常€1,500)・1週間・文書レポートとウォークスルーコール・9月30日まで