道具の名前は先に伝える
AIには、使える道具の名前と説明を先に渡します。詳しい設定は、必要になったときに読み込みます。
機能自体の追加料金はありません。ただし、AIに送った情報やAIの回答には通常の料金がかかります。実際に費用が減るかは、アプリの使い方によって変わります。
開発者は、よく使う道具を先に読み込み、使う機会が少ない道具だけを後から読み込む設定もできます。

画像:Google(公式発表より)
Gemini APIのTool Retrievalは、必要な道具の詳細だけを読み込むプレビュー機能です。
なるほど
要約版:専門用語を控えて説明しています
AIには、使える道具の名前と説明を先に渡します。詳しい設定は、必要になったときに読み込みます。
機能自体の追加料金はありません。ただし、AIに送った情報やAIの回答には通常の料金がかかります。実際に費用が減るかは、アプリの使い方によって変わります。
開発者は、よく使う道具を先に読み込み、使う機会が少ない道具だけを後から読み込む設定もできます。
Gemini APIを使い、多数の道具を扱うAIアプリを開発する人が対象です。道具の詳しい情報を毎回すべて送る代わりに、必要な分だけを渡せます。
API(アプリから呼び出す仕組み)は、アプリにAIの機能を組み込むための窓口です。Tool Retrievalは、そのAIが外部の道具を選んで使う際の情報量を抑える機能です。
Googleの公式ブログによると、道具の数が増えると、すべての詳細を毎回送る方法では入力が増えます。応答に時間がかかり、道具の選択精度も下がるといいます。
新機能では、後から読み込む道具についても、名前と説明は先にモデルへ渡します。一方、引数の定義(道具に渡す情報の形式)は、必要になるまで読み込みません。
モデルが道具を指定すると、APIが定義を読み込みます。その後、モデルは同じリクエストの中で呼び出しを指示します。
Googleの例では、破損した注文の返金に使う関数を検索し、必要な定義を読み込んで呼び出しを指示します。実際の返金処理は、アプリ側のコードが実行します。

多数の道具を扱い、使わない定義が多いアプリなら、Tool Retrievalを試す価値があると考えられます。一方、読み込む定義が多いアプリなら、設定前後の通信量を比べて判断するのがよさそうです。
頻繁に使う道具が決まっているなら、その道具は先に読み込み、残りを必要に応じて読み込む方法が考えられます。
料金の詳しい比較は Geminiの料金は無料から、有料プランの違いと無料でできること へ
判断ガイド
状況ごとのおすすめと理由です。どれを選ぶかは、ご自身の状況で決めてください。
不安Q&A
Tool Retrieval自体に別料金はありません。ただし、tool_searchを有効にすると少量の入力トークンが固定で追加され、読み込んだ定義も会話の残りで入力として課金されます。入力量と出力量には、利用モデルの通常料金がかかります。
出典・blog.google今できること実際の利用状況で入力トークンを測り、読み込まずに済む定義量と追加分を比べる。
後回しにした道具も、名前と説明はモデルに渡され、何が利用可能か分かります。一方、引数の定義は文脈に含まれず、モデルがその道具を必要としたときにAPIが読み込みます。
出典・blog.google今できること設定例を見て、後回しにする道具にdefer_loading: trueを指定する。
Tool Retrievalが読み込んで呼び出しを指示するのは関数の定義です。実際の関数呼び出し後の処理は通常の関数呼び出しと同じで、返金の例ではアプリ側のコードが返金を実行します。
出典・blog.google今できること返金などの処理を組み込む場合は、関数呼び出し後にアプリ側のコードが実行する設計を確認する。
Tool Retrievalは、Gemini Interactions APIのプレビュー版として提供されています。Gemini 3.6以降のモデルが対象で、Gemini 4の全モデルも含みます。
機能を使う場合、リクエストにtool_searchを追加します。読み込みを後に回す道具には、defer_loading: trueを設定します。
検索はGoogle側で行うため、検索用の索引を作って管理する必要はありません。よく使う道具は先に読み込み、残りだけを後回しにする設定もできます。
検索と呼び出しの各段階はinteraction.stepsで確認できます。道具の名前や説明を調整するときに、どの道具が検討されたかを調べられます。
MCP(AIと外部の道具をつなぐ仕組み)の外部サーバーにも対応します。サーバー側の設定を指定すると、そのサーバーが提供する道具を個別に列挙せず、必要に応じて読み込めます。
独自の道具一覧や利用者ごとの権限管理を使う場合は、アプリ側で検索する設定も選べます。この方法では、検索ごとにアプリとの追加の通信が発生します。道具を最初にすべて宣言する必要はなく、会話の途中で追加することもできます。
機能自体に別料金はありません。ただし、入力と出力には利用するモデルの通常料金がかかります。
tool_searchを有効にすると、少量の入力が固定で追加されます。読み込んだ定義も、その後の会話で入力として課金されます。費用が減るかは、読み込まずに済んだ定義の量によって変わるため、Googleは実際の利用状況での測定を勧めています。
料金の一例として、Gemini 3.8 Flashは入力100万トークン(AIが文字を数える単位)あたり0.75ドル、出力は3.75ドルです。(Google公式の料金ページ、11/19確認)
詳しい設定例は、Googleが案内するTool Retrievalの公式ドキュメントで確認できます。
よく読まれている記事
背景
道具が数十から数百に増えると、すべての引数定義を毎回送ることで入力トークンが増え、応答が遅くなり、候補が増えるほど道具の選択精度も下がるとGoogleは説明しています。
出典・blog.googleすぐにできること
公式ドキュメントでTool Retrievalの設定例を確認し、試す道具を選ぶ。
実際の利用状況で入力トークン量を測り、導入前後の差を比べる。
公式窓口
SMSやメールに書かれた連絡先ではなく、ここにある公式の窓口を使ってください。
発表内容をもとにした一般的な情報です。導入や契約の判断は、公式情報を確かめたうえでご自身で行ってください。
多数の道具を使う開発者は、通常のAPI料金と実際の通信量を比べて導入を検討できます。
11/20時点の判定。発表内容をもとにAIで判定しています。最新の提供状況は公式情報をご確認ください。
毎朝7時、暮らしとお金のニュースの要点を5本
前日に出た記事から、給付・税・料金・値上げなど暮らしとお金に関わる話を中心に選び、1本2行でまとめてメールで届けます。無料・いつでも解除できます。
主要企業の大きな発表だけ、1日4回まで。夜22時〜朝7時は鳴らしません。いつでも解除できます。
本記事は公式発表の文章をもとにAIが要約・解説して自動生成したものです。誤りが含まれる可能性があるため、正確な仕様・料金は公式発表をご確認ください。元記事を読む制作方法と事実確認の手順は編集方針をご覧ください。誤りのご指摘はお問い合わせから受け付けています。