Gemini API が Tool Retrieval をプレビュー公開:ツールのスキーマをオンデマンドで読み込み、Gemini 3.6 以降に対応

Google は Gemini Interactions API の Tool Retrieval をプレビューとして発表。エージェントが必要なときだけツールのパラメータスキーマを読み込み、入力トークンと遅延を抑えられる。Gemini 3.6 以降が対象で、追加料金はない。

ニュース日: 読了目安 8 分

LINEで送る
目次
  1. 1. Tool Retrieval で何が変わるのか
  2. 2. 有効化の方法と、サーバー側・クライアント側検索の違い
  3. 3. 対応モデルと料金
  4. 4. 開発フローへの実際の影響
  5. 5. 始めるには

Google は 2026 年 11 月 19 日、Gemini API の Interactions API に Tool Retrieval を導入したと発表した。現在はプレビュー(preview)で、一般提供ではない。対象は「AI エージェント」、つまり外部の機能(注文の照会や返金など)を自ら呼び出してタスクを進める AI プログラムである。呼び出せる機能にはそれぞれ「パラメータスキーマ」(schema)を付け、必要な入力項目を示す必要がある。ツールが増えると、この説明が大量のトークン(モデルが文章量を数え、課金する単位)を占める。Google は、Tool Retrieval の狙いはリクエストごとのトークン負担と遅延を減らし、ツールが増えても選択ミスを避けることだと説明している。

Tool Retrieval で何が変わるのか

Google によると、エージェントが数十から数百のツールに接続すると、毎回すべてのパラメータスキーマを送ることで入力トークンが増え、遅延が大きくなり、候補リストが長くなるほどツール選択の精度も下がる。Tool Retrieval では、エージェントはツールライブラリ全体を待機させておき、現在のタスクに必要なスキーマだけを読み込む。

Google の説明では、モデルは読み込みを遅らせた各ツールの名前と説明を引き続き見られるため、どのツールが使えるかを把握している。必要になると、モデルが名前で要求し、API が完全なスキーマを読み込み、モデルは同じリクエスト内で関数呼び出しを行う。この 3 つのステップはすべて interaction.steps に表示されるので、デバッグ時にモデルがどのツールを検討したかを確認できる。

有効化の方法と、サーバー側・クライアント側検索の違い

Google によると、有効化するにはリクエストに tool_search ツールを追加し、読み込みを遅らせたいツールに defer_loading: true を設定する。最もよく使うツールは事前読み込みのままにし、利用頻度の低いツールだけを遅延させることもできる。MCP サーバーとは、一連のツールをまとめて AI モデルに提供する接続方式である。リモート MCP サーバーを使う場合は、mcp_server ツールに defer_loading: true を設定すれば、そのサーバーが公開するすべてのツールがオンデマンドで読み込まれ、一つずつ列挙する必要はない。

Google が説明する 2 つの検索モードの比較
項目サーバー側検索クライアント側検索
設定方法tool_search を追加し、ツールに defer_loading: true を設定tool_search を宣言して "execution": "client" を設定し、検索パラメータを自分で定義
インデックスGoogle によると、インデックスの作成や運用は不要で、検索は Gemini がサーバー側で実行独自のツールレジストリ、埋め込みインデックス、ユーザーごとの権限フィルターを運用する場合に適する
追加の往復Google によると、検索と関数呼び出しは同一リクエスト内で完結アプリがクエリを実行するため、検索のたびに往復が 1 回増える
ツールの宣言遅延読み込みのツールも宣言が必要(名前と説明を含む)ツールを事前に宣言する必要はなく、会話の途中で追加できる

対応モデルと料金

Google によると、Interactions API の Tool Retrieval は Gemini 3.6 以降のモデル(Gemini 4 の全モデルを含む)で利用できる。この機能に単独の料金はなく、入力・出力トークンは呼び出したモデルの標準料金で課金される。

Google は同時に、tool_search を有効にすると固定の入力トークンが少し増え、モデルが読み込んだ各スキーマは会話の残りの部分で、事前宣言したツールと同様に入力として課金されると説明している。トークンが節約できるのは、読み込まれないスキーマが読み込まれるスキーマより多い場合に限られる。Google は自分のトラフィックで実際に評価することを勧めている。

開発フローへの実際の影響

すでに大規模なツールライブラリを持つチームにとって、主な変更はリクエストにツールを 1 つとフラグを 1 つ加えることで、検索システムを作り直す必要はない。プレフィックスキャッシュとは、プロンプトの先頭で変わらない部分を再利用して重複処理を省く仕組みである。Google によると、遅延されたスキーマはプロンプトの先頭にはなく、読み込まれたスキーマは会話の後段に追加されるため、プレフィックスキャッシュと両立し、キャッシュされたプレフィックスはターンをまたいでも変わらない。

始めるには

  1. リクエストの tools に tool_search ツールを追加する。
  2. 読み込みを遅らせたいツールに defer_loading: true を設定する(リモート MCP サーバーの場合は mcp_server ツールに設定)。
  3. 独自の検索を構築する場合は、tool_search の宣言時に "execution": "client" を設定し、検索パラメータを定義する。
  4. Google が提供する詳細な設定ドキュメントとモデル比較を参照し、Discord でチームにフィードバックを送る。

よくある質問

Tool Retrieval は現在、正式版ですか?

いいえ。Google によると、Gemini Interactions API ではプレビュー版です。

どのくらいコードを変更する必要がありますか?

サーバー側検索では、Google によると tool_search ツールを追加し、遅延させるツールに defer_loading フラグを付けるだけで、インデックスの作成や運用は不要です。独自のツールレジストリや権限フィルターを使いたい場合はクライアント側検索を選べますが、検索のたびに往復が 1 回増えます。

有効にすれば必ず節約になりますか?

必ずしもそうではありません。Google によると単独の料金はありませんが、tool_search で固定の入力トークンが少し増え、読み込まれたスキーマも入力として課金されます。読み込まれないスキーマが読み込まれるスキーマより多い場合にのみトークンを節約できます。

モデルがどのツールを選んだかはどう確認できますか?

Google によると、ツールの検索、スキーマの読み込み、関数呼び出しの 3 つのステップが interaction.steps に表示されます。モデルが検討したツールを確認し、ツール名や説明の調整に役立てられます。

MCP サーバーと組み合わせられますか?

はい。Google によると、mcp_server ツールに defer_loading: true を設定すると、そのサーバーのすべてのツールがオンデマンドで読み込まれます。

このトピックの最新ニュースを見る

この記事が役に立ったら、必要な方にシェアしてください

LINEで送る

出典

上記の参考資料および記載の確認日時点の情報をもとに整理しています。料金・時刻・機能・利用規約は変更される場合があるため、ご旅行や予約・購入の前には該当する公式サイトで最新情報をご確認ください。

ライフスタイル