AIニュース

Gemini APIにTool Retrieval|使い方と注意点

Googleは2026年11月19日、Gemini APIの新機能「Tool Retrieval」をプレビュー提供として発表しました。自作のAIエージェントにツールをたくさんつなぐと入力トークンが膨らむという課題に向けた仕組みです。ここではGemini APIのTool Retrievalの使い方として、設定の流れと対応モデル、料金の扱いを発表内容の範囲で整理します。

要点

  • Tool Retrievalは2026年11月19日に発表され、Interactions APIでプレビュー(preview)として提供
  • リクエストにtool_searchというツールを追加し、後回しにしたいツールにdefer_loading: trueを設定する
  • 先送りしたツールも名前と説明はモデルから見えており、parameter schemas(引数の定義)だけが文脈の外に置かれる
  • Tool Retrieval自体に別料金はなく、入力トークンと出力トークンは呼び出したモデルの標準料金で課金される
  • Gemini 3.6以降のモデルに対応し、Gemini 4のすべてのモデルを含む

何が発表されたか

想定している課題

発表では、エージェントが「dozens or even hundreds of tools」(数十、場合によっては数百のツール)につながる場面を挙げています。毎回のリクエストで全ツールの引数定義を送ると入力トークン数が膨らみ、遅延が増え、候補が増えるほどツール選択の精度が落ちると説明されています。Tool Retrievalは、ツール一覧は待機させたまま、いまのタスクに必要な引数定義だけを読み込ませる機能です。

設定の流れ

手順は2つです。リクエストにtool_searchツールを追加し、保留したいツールにdefer_loading: trueを設定します。先送りされたツールも名前と説明はモデルに見えるため、何が使えるかは分かる状態が保たれ、引数定義だけが文脈の外に出ます。モデルがそのツールを必要としたときは名前で要求し、APIが完全なスキーマを読み込み、モデルが関数を呼び出します。この3つが同じ1回のリクエストの中で完結します。

公式のコード例ではmodel="gemini-4-hydrogen"が指定され、defer_loading: trueを付けたissue_refund関数などが並んでいます。やり取りはinteraction.stepsにtool_search_call・tool_search_result・function_callとして現れるため、ツール名や説明を直したいときの確認に役立ちます。そこから先は通常のfunction calling(モデルに関数を呼ばせる仕組み)と同じで、自分のコードが処理を実行してfunction_resultを返します。

索引の用意は不要でキャッシュとも併用できる

自分で索引を作ったり持ったりする必要はなく、検索はサーバー側で実行されます。よく使うツールは先に読み込んだままにして、使用頻度の低い裾の部分だけを先送りする運用もできます。prefix caching(プロンプト前半の使い回し)との相性もよいとされ、先送りしたスキーマはプロンプトの冒頭に入らず、読み込まれたスキーマは会話の後ろ側に追加されるため、キャッシュされた前半はターンをまたいでも同じままだと説明されています。

MCPサーバーと自前のツール検索

Tool Retrievalはremote MCPサーバー(外部のツール群をまとめて提供するサーバー)にも対応します。mcp_serverツールにdefer_loading: trueを設定すると、そのサーバーが公開するすべてのツールが必要に応じて読み込まれるため、ツールを1つずつ列挙せずに大きなサーバーをつなげます。

自分でツール登録簿や埋め込み索引、ユーザーごとの権限フィルタを持っている場合は、tool_searchに"execution": "client"を指定し、検索用のパラメータを自分で定義します。この方式は検索ごとに1往復増えますが、ツールを事前に宣言する必要がないため、ユーザーが連携を追加した時点で会話の途中から新しいツールを出すこともできます。

料金と対応モデル

Tool Retrieval自体に別料金はありません。入力トークンと出力トークンは呼び出したモデルの標準料金で課金されます。tool_searchを有効にすると小さく固定量の入力トークンが加わり、モデルが読み込んだスキーマは、最初から宣言したツールと同じように、その会話の残りの間ずっと入力として課金されます。読み込まないスキーマの分が読み込む分を上回ったときにトークンの節約になり、大きなツール群では通常そうなるとされています。発表では自分のトラフィックで測るよう勧めています。利用できるのはGemini 3.6以降のモデルで、Gemini 4のすべてのモデルを含み、Interactions APIが対象です。

個人の仕事や学びにどう使えるか

まず、フリーランスのエンジニアやWebディレクターが、請求書発行・原稿の下書き・画像の整理などを関数として並べた自作エージェントを育てていく場面です。ツールが増えるたびにプロンプトが重くなっていたなら、使用頻度の高い数個だけ残して残りをdefer_loadingに回す形が検討できます。

次に、営業や事務の担当者が社内システムの照会用の関数を増やしていく場面です。名前と説明はモデルに見えたままなので、「何ができるエージェントか」の見通しを保ちながら本数を増やしていけます。

学び直し中の人は、まず小さなツール2〜3個で通常のfunction callingを動かし、慣れてからtool_searchを足してinteraction.stepsを読む練習をすると、どの段で何が起きているかが追いやすくなります。

会社・チームで使うときのポイント

プレビュー提供の機能なので、業務で常時動かす前に小さな範囲で検証する進め方が無理のない形です。料金は読み込むスキーマの量次第で変わるため、自社の実際のリクエストで入力トークンを測り、どのツールを先送りするかを決めるとよいでしょう。MCPサーバーをまとめてつなぐ場合は、どのツールが呼び出され得るかを社内で共有しておくと運用が安定します。法人での導入や研修を検討するなら、株式会社デジライズに相談できます。同社は法人向けAIリスキリングサービスで導入社数No.1(東京商工リサーチ・2026年3月末時点)で、累計600社超・5万人以上のAI活用を支援しています。

使う前の注意点

現時点での提供はプレビューで、対象はInteractions APIです。対応モデルはGemini 3.6以降(Gemini 4のすべてのモデルを含む)とされているため、手元のコードが別の呼び出し方やモデルを使っている場合は確認が必要です。クライアント側の検索を選ぶと検索ごとに1往復増える点も、応答速度を気にする用途では考慮しておきたいところです。料金や提供範囲は変わることがあるので、使い始める前に公式のドキュメントとヘルプで最新の提供範囲と課金の条件を確かめてください。

まとめ

Tool Retrievalは、ツールの名前と説明は見せたまま引数定義だけを必要なときに読み込む、エージェントの土台に近い機能です。まずは手元の小さなエージェントで入力トークンの変化を測ってみるのが分かりやすい入り口になります。Geminiを体系的に学ぶなら、デジライズAIスクールのコース一覧にある「Google AI Studio活用(上級)」などから自分の段階に合うものを選べます。

出典


この記事は、各社の公式の発表をもとに AI で下書きし、出典の本文との照合とGoogle 検索による事実確認(ファクトチェック)を通ったものだけを公開しています。