
Gemini API、ツール定義を必要時に読み込む「Tool Retrieval」提供
Gemini APIGoogleAIエージェントMCPAPI
Googleは11月19日、Gemini APIのInteractions APIで「Tool Retrieval」のプレビュー提供を開始した。多数のツールを登録しても、タスクに必要なツールのパラメータスキーマだけを実行時に読み込む仕組みで、入力トークン量とレイテンシ、ツール選択ミスの削減を狙う。tool_searchツールを追加し、遅延させたいツールにdefer_loading: trueを設定して使う。追加料金はかからない。
何が発表されたか
Googleは2026年11月19日、Gemini APIに「Tool Retrieval」をプレビュー提供すると発表した。Interactions APIで利用できる。
エージェントに大量のツールを登録すると、すべてのツール定義(パラメータスキーマ)が毎回プロンプトに載り、入力トークンとレイテンシが膨らみ、ツール選択の誤りも増える。Tool Retrievalはこれを、ツールを待機状態で保持し、タスクに必要になったものだけスキーマを読み込む方式に変える。
使い方と仕様は以下の通り。
tool_searchツールを追加し、遅延読み込みしたいツールにdefer_loading: trueを設定する。- 遅延中のツールについても、モデルは 名前と説明は参照できる。読み込まれないのはパラメータスキーマである。
- 検索処理はGoogleのサーバー側で動く。インデックスを自前で構築・ホストする必要はない。
- 実行の過程は
interaction.stepsにtool_search_call/tool_search_result/function_callとして現れる。 mcp_serverツールにdefer_loading: trueを設定すると、そのリモートMCPサーバーのツールをオンデマンドで読み込める。"execution": "client"を指定すれば、自前のレジストリや埋め込み検索をクライアント側で動かすこともできる。この場合は検索1回につき1往復のラウンドトリップが増える。- 対応モデルはGemini 3.6以降で、Gemini 4系の全モデルを含む。サンプルコードでは
gemini-4-hydrogenが使われている。
開発者への影響
料金については、この機能自体への追加課金はない。通常のモデル単価が適用され、tool_search の利用で入力トークンが小さな固定分だけ増える。読み込まれたスキーマは、そのあとの会話が続く間、入力トークンとして課金される。つまりコスト上の利点は「使わないツールのスキーマを払わなくて済む」点にある。
MCPサーバーを複数つないでエージェントを組んでいる場合、接続先が増えるほどツール定義が膨らむという問題に直接効く。mcp_server 単位で遅延読み込みを指定できるため、社内ツールや外部サービスを広くつなぎつつ、1回のやり取りで実際に使うものだけを読み込む構成が取りやすくなる。
現時点ではプレビューであり、Interactions APIでの提供となる。提供地域や一般提供の時期については発表に記載がない。
