「Gemini API」でツールの定義を必要時に読む「Tool Retrieval」 別料金なし
Google が2026年11月19日、Gemini API で Tool Retrieval をプレビュー公開した。ツールの引数の定義を必要なときだけ読み込み、入力トークンを減らす。別料金はない。提供地域は書かれていない。

この記事の要点
- Google は2026年11月19日、Gemini API に「Tool Retrieval」をプレビューとして公開した。AI が使うツールの細かな定義を、必要になったときだけ読み込む機能である。
- 数十から数百のツールをつないだ AI エージェントを作る開発者に関係する。入力トークンを減らし、ツールを選ぶ正確さを保つための機能だと Google は説明している。
- Gemini API の Interactions API で、Gemini 3.6 以降のモデルに使える。Tool Retrieval そのものに別の料金はかからない。
目次5
何が発表されたか
Google は2026年11月19日、Gemini の API で Tool Retrieval をプレビューとして公開した。プレビューは正式な提供の前の段階を指す。
AI エージェントは作業を進めるために外部の関数を呼び出す。この関数をツールと呼ぶ。発表の例では、注文の代金を元の支払い方法に返す issue_refund がツールにあたる。
発表によると、エージェントが数十から数百のツールにつながると、依頼のたびにすべてのツールの引数の定義(パラメータのスキーマ)を送ることになる。その分だけ入力トークンが増え、応答も遅くなる。トークンは、AI が文章を数える単位だ。候補が増えるほど、ツールを選ぶ正確さも下がるという。
使うには、依頼に tool_search というツールを加え、後回しにしたいツールに defer_loading: true を設定する。モデルは後回しにしたツールの名前と説明だけを見て、何が使えるかを知る。引数の定義は、モデルがそのツールを名前で求めたときに API が読み込む。ツールを探し、定義を読み込み、関数を呼び出すまでが、1回の依頼の中で済む。
この3つの段階は interaction.steps に残る。モデルがどのツールを検討したかを確かめられるので、ツールの名前や説明を直すときの手がかりになると発表は書いている。そのあとは通常の関数呼び出し(function calling)と同じで、開発者のコードが返金を実行し、結果を返す。
検索のための索引を作ったり置いたりする必要はない。検索は Gemini がサーバーの側で行う。コードの変更は新しいツールの追加と、後回しにするツールへの設定だけだという。よく使うツールは最初から読み込み、使う機会の少ないツールだけを後回しにすることもできる。
依頼の先頭部分を使い回すキャッシュ(prefix caching)とも一緒に使える。後回しにした定義は依頼の先頭に入らず、読み込んだ定義は会話の後ろに足される。そのため、キャッシュされる先頭部分は会話のやり取りの間で変わらない。
Gemini API のリモートの MCP サーバーでも使える。mcp_server のツールに defer_loading: true を設定すると、そのサーバーが出すすべてのツールが必要なときに読み込まれる。ツールを1つずつ書き出さずに、大きなサーバーをつなげるという。
自社でツールの一覧、埋め込みの索引、利用者ごとの権限の絞り込みを持っている場合は、検索をアプリの側で行う方法もある。tool_search に "execution": "client" を指定する。検索をアプリが行うので、検索1回ごとにやり取りが1往復増える。ツールを前もって宣言しなくてよいので、利用者が連携をつないだときに、会話の途中で新しいツールを出すこともできる。
年表で見ると
TRAIL の年表で、Gemini API の開発者向けの主な出来事を2026年10月の終わりから並べる。
- 2026年10月27日:コマンドラインの Gemini API CLI をベータ公開。Interactions API の上で動く。
- 2026年10月30日:Computer Use ツールを一般提供。Interactions API と GenerateContent API が対象。
- 2026年11月11日:判定用の Gemini Decisions API を公開。
- 2026年11月18日:Genie 4 を Ultra と Gemini API で提供。11月19日には Gemini API(Interactions API)と Google AI Studio でも開発者向けに公開した。同じ日に Tool Retrieval も出た。
TRAIL の年表では、Gemini の出来事は2026年9月が9件、10月が17件で、11月は20日までで12件ある。Interactions API に関わる出来事は、10月27日の CLI、10月30日の Computer Use ツール、11月19日の Genie 4 と Tool Retrieval と並ぶ。
同じカテゴリで比べると
対話型AIの比較表に並ぶほかのツールについて、2026年10月6日から11月20日までの年表で重要度2以上の出来事のうち、題に API かエージェント(Agents)を含むものを挙げる。
| ツール | 出来事 | 日付 |
|---|---|---|
| DeepSeek | ウェブ検索やファイル入力を API で提供 | 2026年11月13日 |
| Claude | Managed Agents の自社運用版をベータに | 2026年11月12日 |
| Mistral Le Chat | Mistral Studio にマネージドエージェントとアプリを追加 | 2026年11月5日 |
| ChatGPT | 画像モデル GPT-Image-2.6 を API で公開 | 2026年11月4日 |
| Muse | パーソナルAIエージェント Muse を日本で提供開始 | 2026年10月23日 |
| Claude | API 2026-10-21 版と SDK 新メジャー | 2026年10月21日 |
| DeepSeek | 自社の検索エンジンを API として公開 | 2026年10月17日 |
表は年表の出来事の題を並べたもので、機能の中身を比べたものではない。
誰が、いくらで使えるか
Tool Retrieval は Gemini API の Interactions API でプレビューとして使える。Gemini API には Interactions API のほかに GenerateContent API もあるが、発表が挙げるのは Interactions API だけだ。
対応するモデルは Gemini 3.6 以降で、Gemini 4 のすべてのモデルを含む。発表のサンプルコードは、2026年11月12日に公開された Gemini 4 Hydrogen(gemini-4-hydrogen)を指定している。
Tool Retrieval に別の料金はない。入力と出力のトークンは、呼び出すモデルの通常の料金で課金される。ただし tool_search を有効にすると、決まった量の入力トークンが少し加わる。モデルが読み込んだ定義も、その後の会話の間は入力として課金される。最初から宣言したツールと同じ扱いである。
読み込まずに済んだ定義の分が、読み込んだ定義の分より多いときに、トークンが減る。大きなツールの一覧ではそれがふつうだと発表は書き、自分の利用で測るよう求めている。
提供地域と日本語での扱いは、発表に書かれていない。
まだ分からないこと
- 日本を含む提供地域と、ツールの名前や説明を日本語で書いたときの扱い。
tool_searchを有効にしたときに加わる入力トークンの量。発表は「少ない、決まった量」とだけ書いている。- 入力トークンがどれだけ減るか、ツールを選ぶ正確さがどれだけ保たれるかの数字。発表に測定の数字はない。
- 一般提供の時期と、GenerateContent API で使えるようになるか。
- 後回しにできるツールの数の上限。
TRAIL の年表(重要度2以上)から作成。2026.11.19 まで。



