Gemini APIに、必要なツールの定義だけを読み込む「Tool Retrieval」が追加(プレビュー)

Gemini APIに、必要なツールの定義だけを読み込む「Tool Retrieval」が追加(プレビュー)
平山 大樹(AB通信 運営責任者)

平山 大樹 AB通信 運営責任者

AB通信 編集部が、企業・行政の公式発表や決算資料などの一次情報を確認して書いています。運営会社・編集方針

目次

この記事のポイント

  • Googleは2026年11月19日、Gemini APIのInteractions APIに「Tool Retrieval」をプレビューで追加したと発表しました。ツールが多いときに、今の作業で必要なツールのパラメータ定義(スキーマ)だけを読み込みます
  • 追加の料金はありません。入出力トークンは、呼び出したモデルの通常料金で計算されます。使わなかったツールのスキーマは、読み込むまで入力トークンに含まれません
  • 使い方は、リクエストに tool_search を足し、後回しにしたいツールへ defer_loading を付けることです。よく使うツールは最初から読み込んだままにできます
  • リモートのMCPサーバーにも対応します。mcp_server に defer_loading を付けると、そのサーバーが公開するツールを、必要なときだけ読み込めます
  • 公式ブログは「Gemini 3.6以降(Gemini 4の各モデルを含む)」と案内しています。公式ドキュメントに名前がある対応モデルは、gemini-4-carbon、gemini-4-neon、gemini-4-hydrogen、gemini-4-argon、gemini-3.8-flash、gemini-3.6-flash です。プレビューのため、一般提供までに仕様が変わる場合があります

何が発表されたか

Googleは2026年11月19日、公式ブログ「Introducing Tool Retrieval in the Gemini API」(Lucia Loher / Product Manager, Gemini API、Nora Kassner / Research Scientist, Google DeepMind)で、Gemini APIにTool Retrievalを追加したと発表しました。提供はプレビューで、対象はInteractions APIです。

Google AI Studio公式X(@GoogleAIStudio)は、日本時間2026年11月20日3:53に投稿し、同じ内容を案内しています。設定の手順や料金の扱いは、Gemini API公式ドキュメント「Tool retrieval」にもまとまっています。Gemini APIのドキュメントは、Google AI Studio(aistudio.google.com)へ移っています。

Google公式ブログ「Introducing Tool Retrieval in the Gemini API」のメイン画像。暗い背景の中央に、青いGeminiの星型アイコンが光っている
公式ブログのメイン画像。出典:Google公式ブログ「Introducing Tool Retrieval in the Gemini API」(2026年11月19日)

公式ブログによると、エージェントが数十、ときには数百のツールにつながるとき、毎回すべてのパラメータ定義を送ると、入力トークンが増え、応答が遅くなり、ツールの選び方も粗くなりがちです。Tool Retrievalは、ツールの一覧を待機させておき、今の作業で必要なスキーマだけを読み込みます。

図:ツールの定義の送り方の違い。毎回すべての定義を送る方法と、Tool Retrievalで必要な定義だけを読み込む方法、トークンが減るときと増えるとき
ツールの定義の送り方の違い。出典:Gemini API公式ドキュメント「Tool retrieval」(2026年11月20日確認)をもとにAB通信が作成。精度の改善幅を示す公式の数字は、同ドキュメントには載っていません。

どう動くか

サーバー側の検索(標準の動き)では、リクエストに tool_search を足し、後回しにしたいツールへ defer_loading: true を付けます。後回しにしたツールについても、名前と説明はモデルに見えるため、何が使えるかは分かります。パラメータのスキーマだけが、最初の文脈から外れます。

モデルがツールを必要とすると、名前で探し、APIがそのスキーマを読み込み、モデルが関数を呼びます。公式ブログによると、この3つは同じリクエストの中で進みます。経過は interaction.steps に残るため、どのツールを検討したかを後から確認できます。関数を実行して結果を返す流れは、通常の関数呼び出しと同じです。

公式の例は、壊れて届いた注文の返金です。注文番号と金額を受け取る issue_refund を後回しにしておき、モデルがこのツールだけを読み込んで呼び出します。検索用の索引を自前で用意したり、置いたりする必要はありません。よく使うツールは最初から読み込んだままにし、あまり使わないツールだけを後回しにできます。

Gemini API公式ドキュメント「Tool retrieval」のPythonの例。tools配列にtool_searchを足し、convert_currencyとget_exchange_rate_historyにdefer_loadingを付けている
公式ドキュメントのPythonの例。リクエストに tool_search を足し、後回しにしたいツールへ defer_loading を付けます。出典:Gemini API公式ドキュメント「Tool retrieval」(2026年11月20日確認)
図:Tool Retrievalが動く流れ。ツールの一覧を渡す、使わないツールは後回しにする、必要なツールを名前で探す、その定義だけを読み込む、いつもどおり実行する、の5段階
Tool Retrievalが動く流れ。出典:Google公式ブログとGemini API公式ドキュメントをもとにAB通信が作成

料金と対応モデル

公式ブログと公式ドキュメントは、Tool Retrievalに別料金はない、と案内しています。入出力トークンは、呼び出したモデルの通常料金で計算されます。詳しい単価は、Gemini APIの料金ページを見てください。

後回しにしたツールは、名前と短い説明(short_description、未設定なら説明の先頭文)だけが入力に入ります。スキーマは、モデルが読み込むまで料金の対象になりません。サーバー側の検索が1回走ると、同じリクエストの中でもう一度、文脈と読み込んだスキーマを含めた入力が発生します。その入力トークンは total_tool_use_tokens に計上され、入力料金で計算されます。読み込んだスキーマは、その後の会話でも入力として計算されます。

公式ドキュメントは、ツールが多く、1回のリクエストで使うものが少ないときにトークンを減らせる、としています。ツールが少ない、または会話が長くて毎回検索が走ると、従来どおりすべての定義を送る方が少なくて済む場合もある、とも書いています。

Gemini API公式ドキュメントの「Pricing and token usage」。別料金はなく、後回しにしたツールは名前と短い説明だけが入力に入ると案内している
公式ドキュメントの料金とトークンの案内。別料金はなく、後回しにしたツールのスキーマは読み込むまで入力に入りません。出典:Gemini API公式ドキュメント「Tool retrieval」(2026年11月20日確認)

公式ブログは、対応を「Gemini 3.6以降のモデル(Gemini 4の各モデルを含む)」と書いています。2026年11月20日時点の公式ドキュメントに名前があるのは、次の6つです。

  • gemini-4-carbon
  • gemini-4-neon
  • gemini-4-hydrogen
  • gemini-4-argon
  • gemini-3.8-flash
  • gemini-3.6-flash
Gemini API公式ドキュメントの対応モデル一覧。gemini-4-carbon、gemini-4-neon、gemini-4-hydrogen、gemini-4-argon、gemini-3.8-flash、gemini-3.6-flash
公式ドキュメントに載っている対応モデルの一覧。出典:Gemini API公式ドキュメント「Tool retrieval」(2026年11月20日確認)

対応していないモデルで defer_loading を付けると、400エラーになります。公式ドキュメントによると、Tool RetrievalはInteractions APIだけで使えます。generateContent には対応していません。プレビューであり、v1beta のAPIが必要です。一般提供までに、インターフェースが変わる場合があります。

リモートMCPと、自前の検索

Tool Retrievalは、Gemini APIのリモートMCPサーバーとも組み合わせられます。mcp_server に defer_loading: true を付けると、そのサーバーが公開するツールを、1つずつ列挙しなくても、必要なときだけ読み込めます。

自前のツール一覧や、部署・担当者ごとの権限に合わせて使えるツールを絞る仕組みを持つ場合は、クライアント側の検索も選べます。tool_search に execution: "client" を付け、検索のパラメータを自分で定義します。検索のたびに、アプリ側で調べて返す分の往復が1回増えます。一方、最初にすべてのツールを宣言する必要はなく、利用者が連携を追加したタイミングで、会話の途中から新しいツールを見せることもできます。

公式ドキュメントは、ツールが約20個より少ないときは、毎回すべての定義を送る従来の方法が向く、としています。関数呼び出しの案内でも、おおよそ20〜30個を超えたらTool Retrievalを検討する、と書かれています。応答の速さを重視するなら、サーバー側の検索が適しています。

Gemini API公式ドキュメントの表。従来どおり毎回定義を送る方法、サーバー側の検索、クライアント側の検索の違い
公式ドキュメントの「Choosing a retrieval mode」。従来の送り方、サーバー側の検索、クライアント側の検索の向きを比較した表です。出典:Gemini API公式ドキュメント「Tool retrieval」(2026年11月20日確認)

日本の企業では、どこで使えるか

公式の発表に、日本向けの提供制限は書かれていません。Gemini APIのInteractions APIを使える環境であれば、この機能も対象になります。プレビューである点と、対応モデルの指定は、導入前に公式ドキュメントで確認してください。

公式の例は、壊れて届いた注文の返金です。同じ考え方は、日本の通販や店舗の問い合わせ対応にも当てはまります。返金、再発送、在庫確認、クーポン発行、配送状況の照会など、関連するツールが多くても、今回の依頼に必要な定義だけを読み込めます。

社内の問い合わせボットでも同様です。勤怠、経費精算、請求、顧客情報、在庫、会議室予約など、業務ツールを多くつなぐほど、毎回すべての定義を渡す負担は大きくなります。よく使う確認は最初から読み込み、たまにしか使わない手続きは後回しにする、という使い方が公式の想定に沿います。

営業やカスタマーサポートのエージェントが、顧客管理、請求、在庫、配送、社内WikiなどをMCPサーバー経由でつなぐ場合も、サーバー単位で後回しにできます。部署や権限ごとに使えるツールが違うときは、クライアント側の検索で、その人に許可されたツールだけを返す方法もあります。

使うときの注意

公式ドキュメントは、次の点も案内しています。

  • 一度読み込んだツールは、その会話のあいだ文脈に残ります。後から外す方法はありません
  • ツールの宣言はリクエストごとに送り直します。前回の内容はサーバーに残りません
  • システム指示や、別のツールの出力に名前が出るツールは、後回しにしないでください。検索せずに呼ばれ、次のリクエストがエラーになる場合があります
  • 後回しにするツールには、完全なパラメータのスキーマを付けて送ってください。名前と短い説明だけだと、検索結果のスキーマが空になり、呼び出せません
  • サーバー側の検索とクライアント側の検索は、同じリクエストでは併用できません

また、Tool Retrievalはコンテキストのキャッシュ(暗黙のキャッシュ)とも併用できます。後回しにしたスキーマはプロンプトの先頭に入らず、読み込んだスキーマは会話の後ろに足されるため、先頭側の文脈はターンをまたいでも変わりにくくなります。一方、スキーマを外した結果、キャッシュの下限を下回ることもある、と公式ドキュメントは注意しています。

関連記事(AB通信)

出典

更新履歴

  • 2026年11月20日:初稿
  • 2026年11月20日:公式ドキュメントの画面と図解を追加し、対応モデルの記載を公式ドキュメントの最新の一覧に合わせて更新

営業メールなし/無料

AI・SEOの動きは、
毎朝7時のメールで追いつける

平山 大樹(AB通信 運営責任者)

毎朝6時に私がピックアップしてます!

平山 大樹|AB通信 運営責任者

AB通信のメール配信イメージ

もうXを追いかけなくていい。前日にAB通信で公開したAI・SEOの新着記事を、朝のうちにまとめてお届けします。

毎朝7時ごろ、前日のAI・SEOの新着記事をメールでお届けします。

営業メールは送りません。無料で、配信はいつでも解除できます。
登録後に届く確認メールの「登録を確定する」ボタンで完了です(迷惑メールフォルダもご確認ください)。

目次