Gemini APIのTool Retrieval公開 ツールの定義は使う分だけ読む
Googleは19日(米国時間)に、Gemini APIで「Tool Retrieval」のプレビュー提供を始めました。AIエージェントにつないだツールのうち、使うものの定義だけを読み込む機能です。
これまではツールを多くつなぐほど、毎回すべての定義を読み込む必要がありました。そのぶん入力トークンと処理時間が増え、ツール選びの精度も落ちるとImpress Watchは伝えています。
公式ドキュメントによると、Geminiが最初に見るのは各ツールの名前と説明だけです。使うと決めたときに引数の定義を読み込み、関数の呼び出しまで1回のリクエストで進めます。
- ツールの一覧に tool_search を1つ足す
- 後回しにしたいツールに defer_loading を付ける
- リモートMCPサーバーに付けると、そのサーバーのツールがまとめて後回しになる

- 19日(米国時間)GoogleがTool Retrievalのプレビュー提供を開始
- 11/20AInformationが関数60本で試した
対象は4モデルだけ generateContentでは使えない
Tool Retrievalが動くのは、Interactions APIを通したときだけです。generateContentの呼び方には対応していないと公式は書いています。対応モデルにはGemini 4 Argonも入っています。
| 項目 | 内容(Google公式ドキュメント) |
|---|---|
| 対応モデル | gemini-4-hydrogen・gemini-4-argon・gemini-3.8-flash・gemini-3.6-flash |
| 使えるAPI | Interactions API(v1beta) |
| 提供の段階 | プレビュー |
| 追加料金 | なし(通常の単価で請求) |
料金は別にかかりません。後回しにしたツールは1行の一覧として入力に数えられます。引数の定義は読み込むまで請求されないと公式は説明しています。
一方で検索のたびに費用が足されます。対応していないモデルで defer_loading を付けると、400エラーが返ります。

関数60本で試した結果 入力とツール使用の合計は70%減った
AInformationは11月20日に、gemini-3.6-flashで実際に試しました。請求・顧客管理・人事・在庫・予定・問い合わせの6部門に10本ずつ、計60本の関数を用意しています。
日本語の依頼5本を、全部渡す方式とTool Retrievalで1回ずつ投げました。結果は次のとおりです。
| 項目(AInformation独自検証・11月20日・各5回) | 全部渡す | Tool Retrieval |
|---|---|---|
| 入力トークン(平均) | 10,499 | 1,454 |
| ツール使用トークン(平均) | 0 | 1,736 |
| 入力とツール使用の合計(平均) | 10,499 | 3,190 |
| 返答までの秒数(中央値) | 6.13秒 | 5.66秒 |
| 依頼どおりの関数を最初に呼んだ数 | 3本中3本 | 3本中1本 |
入力とツール使用を足すと、平均10,499トークンが3,190トークンになりました。70%減った計算です。検索1回で読み込んだ関数は、60本のうち1〜3本でした。
気になったのは最初に呼ぶ関数です。更新・要約・削除のように操作がはっきりした3本で、依頼どおりの関数を先に呼んだのは削除の1本だけでした。更新と要約は、先に読み取りの関数を呼んでいます。
検索の段階では更新の関数も読み込まれていました。中身を確かめてから書き換える動きとも読めます。ただ今回の試験は最初の呼び出しまでで、その先は確かめていません。
導入前に確かめる3つ ツールが少ないと逆に増えることがある
公式の試算では、ツールが少ないと逆にトークンが増えます。数字は実測ではなく、説明用に丸めた値だと公式は断っています。
| 場面(Google公式の試算) | 全部渡す | Tool Retrieval |
|---|---|---|
| ツール200本(1本400トークン) | 164,000 | 約23,650 |
| ツール10本・会話30,000トークン | 68,000 | 約92,830 |
会話が長いうえに毎回検索すると、そのたびに会話の中身が送り直されるためです。切り替える前に、次の3つを見ておくと安心です。
- ほぼ毎回使う数本は defer_loading を付けずに残す
- 指示文やほかのツールの出力に名前が出るツールは後回しにしない
- 自分の処理で本当に減るかを usage の数字で測る
会話の履歴を自前で積む場合は、検索の手順を署名ごと送り返す必要があります。抜けると2回目のリクエストが400エラーで止まります。
ツールが数十本を超えた社内エージェントなら、まず1部門ぶんだけ切り替えて数字を比べるのが近道です。
- defer_loading
- ツールの引数の定義を最初は渡さず、Geminiが必要と判断したときに読み込ませるための指定。
※記事の事実とは分けて、筆者の考えを書いています。
分析・考察社内の業務システムをAIエージェントにつなぐ情報システム部門には、待っていた機能だと思います。部門ごとに関数を増やすたびに毎回の入力が膨らむ悩みは、かなり軽くなりそうです。
ただ試した範囲では、書き換えの依頼でも先に読み取りを挟む動きが出ました。承認の流れを組んでいる会社は、往復が増える前提で呼び出しの上限回数を決めておく必要がありそうです。
- Gemini APIのTool Retrievalに追加料金はかかる?
- 追加料金はかかりません。通常の入力・キャッシュ・出力の単価で請求されます。後回しにしたツールは1行の一覧として入力に数えられ、引数の定義は読み込むまで請求されません。ただし検索のたびに費用が足されます。公式の試算ではツール10本と30,000トークンの会話で、68,000トークンが約92,830トークンに増えています。
- Tool RetrievalはgenerateContentでも使える?
- 使えません。Tool RetrievalはInteractions API(v1beta)だけで動きます。対応モデルもgemini-4-hydrogen・gemini-4-argon・gemini-3.8-flash・gemini-3.6-flashの4つです。対応していないモデルで defer_loading を付けると400エラーが返ります。
- 検索で合うツールが見つからないとどうなる?
- 専用のエラーは返りません。合うツールが無い問い合わせには、Geminiが文章で答えると公式ドキュメントは書いています。公式は tool_search_result の有無で外れを見分けないよう勧めています。返ってきた手順の中身を見て次の動きを決める作りにしておくと安心です。
【この記事の出典】
- Impress Watch(この記事の元にした報道)補助資料・2026年11月20日に確認
