2026年11月19日、Googleは公式ブログで、Gemini APIにTool Retrieval(ツール検索)がプレビューとして登場すると発表した。対象はInteractions APIだ。エージェントが接続するツールが増えるほど、毎回のリクエストで運ばなければならないツールのパラメータ説明は長くなり、トークン消費も遅延も、誤ったツールを選ぶ確率も一緒に上がっていく。新しいやり方の考え方はシンプルだ。ツールライブラリは待機させておき、パラメータスキーマはタスクが本当に必要としたときだけ読み込む。
有効化するには、リクエストにtool_searchツールを追加し、後回しにしたいツールにdefer_loading: trueを設定する。モデルは引き続きすべてのツールの名前と説明を見るので、何が使えるかは把握できるが、パラメータスキーマはコンテキストに入らない。ツールが必要になれば、モデルが名前で指定して要求し、APIは検索、スキーマの読み込み、関数呼び出しを同じリクエストの中で完了させ、その全過程はinteraction.stepsで1件ずつ確認できる。リモートのMCPサーバーも、公開するツールを1つずつ列挙することなく、ツール一式をまとめて後回しにできる。自前のツールレジストリを持つ開発者は、tool_searchをクライアント側で実行するよう設定し、会話の途中で新しいツールを接続することもできる。後回しにしたスキーマはプロンプトの先頭に入らないため、プレフィックスキャッシュとも相性が良い。
料金は別途かからない。入出力トークンは呼び出すモデルの標準料金で課金され、tool_search自体は小さな固定量の入力トークンを占めるだけで、モデルが読み込んだスキーマはその会話の残りの間、入力として課金される。節約になるかどうかは計算次第だ。読み込まなかったスキーマで節約したトークンが、実際に読み込んだ分を上回れば得になり、ライブラリが大きいほどお得になる。対応するのはGemini 3.6以降で、すべてのGemini 4モデルを含む。これも、トークンを必要なところにだけ使うという最近のGemini APIの流れの続きだ。先日もOfficeファイルの必要な部分だけを読む機能が追加されたばかりだ。
公式ドキュメントにはすでに完全なセットアップガイドが載っている。ツールが数十個にのぼるエージェントの開発者なら、今こそ自分のトラフィックで試す好機だ。よく使うツールは先に読み込ませ、残りのロングテールはすべて後回しにして、トークン請求額とツールの選択ミス率を比べてから、全面的に展開するかどうか決めればよい。