「Gemini API」でツールの定義を必要時に読む「Tool Retrieval」 別料金なし

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

暗い台の上に並ぶ、すりガラスの小さな引き出しの棚と、少しだけ開いて紫に光る1つの引き出し

この記事の要点

  • 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月の終わりから並べる。

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 で使えるようになるか。
  • 後回しにできるツールの数の上限。
年表で見ると:Gemini の節目と更新年表を見る
1日同日1日同日2026.11.17 Gemini のタスク機能を無料で提供2026.11.17Gemini のタスク機能を無…Gemini のタスク機能を無…2026.11.18 Genie 4 を Ultra と Gemini API で提供2026.11.18Genie 4 をUltra と G…Genie 4 を Ultra と Ge…2026.11.18 Gemini 4 Neon を公開2026.11.18Gemini 4Neon を公開Gemini 4 Neon を公開2026.11.19 API に Tool Retrieval をプレビュー公開2026.11.19API に ToolRetrieval…API に Tool Retrieval…2026.11.19 Mac 版アプリでコンピュータ操作2026.11.19Mac 版アプリでコンピュー…Mac 版アプリでコンピュー…

TRAIL の年表(重要度2以上)から作成。2026.11.19 まで。

出典

この記事に出てくるツール

  • Gemini

    Google

    Google の対話型AI。文章・画像・動画・調査に対応

    • 無料プランあり
    • 画面の日本語あり
    • APIあり

    有料Google AI Plus ¥725/月

    年表
    112件
    最新の更新
    2026.11.20
  • Gemini の開発環境と、文章からアプリを作る Build モード

    • 無料プランあり
    • 画面の日本語なし
    • APIあり

    有料Google AI Pro / Ultra Google AI プランに含まれる

    年表
    9件
    最新の更新
    2026.11.17
  • DeepSeek

    DeepSeek

    低価格で使える中国発の対話AIとAPI

    • 無料プランあり
    • 画面の日本語なし
    • APIあり

    有料API deepseek-flash 入力(キャッシュなし)$0.15〜0.30、出力 $0.6〜1.2(100万トークンあたり)

    年表
    33件
    最新の更新
    2026.11.18
  • Claude

    Anthropic

    文章作成・コーディング・調査に使えるAIアシスタント

    • 無料プランあり
    • 画面の日本語あり
    • APIあり

    有料Pro $20/月(年払いは月$17、$200一括)

    年表
    124件
    最新の更新
    2026.11.20
  • Mistral Le Chat

    Mistral AI

    フランスの Mistral AI が提供するAIアシスタント。2026年5月から Vibe の名前で仕事とコーディングを1つのエージェントにまとめた

    • 無料プランあり
    • 画面の日本語なし
    • APIあり

    有料Pro $14.99/月(税別)

    年表
    14件
    最新の更新
    2026.11.20
  • ChatGPT

    OpenAI

    文章、画像、調査、開発を会話で任せられるAIアシスタント

    • 無料プランあり
    • 画面の日本語あり
    • APIあり

    有料Go ¥1,400/月

    年表
    111件
    最新の更新
    2026.11.17
  • Muse

    Meta

    Meta のパーソナルAIエージェントとAIモデル群

    • 無料プランあり
    • 画面の日本語あり
    • APIあり

    有料Powerプラン $20/月

    年表
    26件
    最新の更新
    2026.11.20

関連テーマの動向

Timeline

関連する出来事

  1. API に Tool Retrieval をプレビュー公開

    Gemini・機能 最終確認 2026年11月20日

  2. コマンドラインの Gemini API CLI をベータ公開

    Gemini・機能 最終確認 2026年10月28日

  3. Computer Use ツールを一般提供

    Gemini・機能 最終確認 2026年10月30日

  4. 判定用の Gemini Decisions API を公開

    Gemini・モデル 最終確認 2026年11月20日

  5. Genie 4 を Ultra と Gemini API で提供

    Gemini・モデル 最終確認 2026年11月20日

  6. Gemini 4 Hydrogen を公開

    Gemini・モデル 最終確認 2026年11月20日