ツールは Gemini モデルの機能を拡張し、現実世界でのアクション、リアルタイムの情報へのアクセス、複雑な計算タスクの実行を可能にします。モデルは、Live API を使用して、標準のリクエストとレスポンスのやり取りとリアルタイム ストリーミング セッションの両方でツールを使用できます。
ツールは、モデルがクエリへの回答に使用できる特定の機能（Google 検索やコード実行など）です。Gemini API は、フルマネージドの組み込みツール スイートを提供します。また、関数呼び出しを使用してカスタムツールを定義することもできます。
マルチステップの目標指向システムを構築するには、エージェントの概要をご覧ください。
利用可能な組み込みツール
| ツール | 説明 | ユースケース |
|---|---|---|
| Google 検索 | ウェブ上の最新の出来事や事実に基づいて回答を生成し、ハルシネーションを減らします。 | \- 最近の出来事に関する質問に答える \- さまざまなソースで事実を確認する |
| Google マップ | 場所の検索、ルートの取得、豊富なローカル コンテキストの提供が可能な位置認識アシスタントを構築します。 | - 複数の立ち寄り先を含む旅行プランの作成 - ユーザーの条件に基づくローカル ビジネスの検索 |
| コードの実行 | モデルが Python コードを記述して実行し、数学の問題を解決したり、データを正確に処理したりできるようにします。 | \- 複雑な数式を解く \- テキストデータを正確に処理、分析する |
| URL コンテキスト | 特定のウェブページやドキュメントのコンテンツを読み取って分析するようにモデルに指示します。 | \- 特定の URL またはドキュメントに基づいて質問に回答する \- さまざまなウェブページから情報を取得する |
| コンピュータ使用（プレビュー） | Gemini が画面を表示し、ウェブブラウザの UI を操作するアクションを生成できるようにします（クライアント サイド実行）。 | \- ウェブベースの反復的なワークフローの自動化 \- ウェブ アプリケーションのユーザー インターフェースのテスト |
| ファイル検索 | 独自のドキュメントをインデックス登録して検索し、検索拡張生成（RAG）を有効にします。 | - 技術マニュアルの検索 - 独自データに関する質問応答 |
特定のツールに関連する費用の詳細については、料金ページをご覧ください。
ツールの実行の仕組み
ツールを使用すると、モデルは会話中にアクションをリクエストできます。ツールが組み込み（Google が管理）かカスタム（ユーザーが管理）かによって、フローは異なります。
組み込みツールのフロー
組み込みツール（Google 検索、Google マップ、URL コンテキスト、ファイル検索、コード実行）の場合、プロセス全体が 1 回の API 呼び出しで行われます。
- ユーザーが「GOOG の最新の株価の平方根は？」というプロンプトを送信します。
- Gemini はツールが必要であると判断し、Google のサーバーでツールを実行します（株価を検索してから、Python コードを実行して平方根を計算するなど）。
- Gemini は、ツールの結果に基づいて最終的な回答を返します。
カスタムツールフロー（関数呼び出し）
カスタムツールとコンピュータ使用の場合、アプリケーションが実行を処理します。
- ユーザーは、関数（ツール）宣言とともにプロンプトを送信します。
- Gemini は、常に一意の
idを使用して、特定の関数（{"name": "get_order_status", "args": {"order_id": "123"}}など）を呼び出すために構造化された JSON を返送することがあります。 - ユーザーがアプリケーションまたは環境で関数を実行します。
- 関数呼び出しと同じ
idを使用して、関数の結果を Gemini に送り返します。 - Gemini は、結果を使用して最終的なレスポンスまたは別のツール呼び出しを生成します。
詳しくは、関数呼び出しガイドをご覧ください。
組み込みツールとカスタムツールのフローを組み合わせる
組み込みツールとカスタムツール（関数呼び出し）を組み合わせたリクエストの場合、モデルはツール コンテキストの循環を使用して、さまざまな環境での実行を調整します。
- ユーザーは、プロンプトを送信し、有効にする組み込みツールとカスタム関数を宣言して、組み合わせサポートをオンにするフラグを設定します。
- Gemini は、組み込みツールを実行し、クライアントサイドの関数呼び出しが生成された場合はユーザーに譲ります（最初に実行されるのは、プロンプトとモデルの判断によって異なります）。次のようなレスポンスが返されます。
- ツール呼び出しの確認
- ツール レスポンスの結果（モデルが 2 つの並列関数呼び出しを生成した場合、JSON の後に続くことがあります）
- 関数を呼び出す構造化 JSON
- コンテキストを保持するための暗号化された思考シグネチャ
- ユーザーがアプリケーションまたは環境で関数を実行します。
- ユーザーは、Gemini のレスポンスのすべての部分と、関数呼び出しの結果を返します。
- Gemini は、結合されたすべてのコンテキストを使用して最終的な回答を生成します。
ツールの組み合わせガイドで、組み込みツールとカスタムツールの組み合わせのサポートを有効にする方法と、コンテキストの循環の例をご覧ください。
構造化出力と関数呼び出し
Gemini には、構造化された出力を生成する 2 つの方法があります。モデルが独自のツールやデータシステムに接続して中間ステップを実行する必要がある場合は、関数呼び出しを使用します。カスタム UI のレンダリングなど、モデルの最終的なレスポンスが特定のスキーマに厳密に準拠する必要がある場合は、構造化出力を使用します。
ツールを使用した構造化出力
構造化出力と組み込みツールを組み合わせることで、外部データまたは計算に基づいてグラウンディングされたモデルのレスポンスが厳密なスキーマに準拠するようにできます。
コード例については、ツールを使用した構造化出力をご覧ください。