冒頭の画像・動画は、必要な道具の説明だけを開く仕組みを表した生成イメージです。Gemini APIの操作画面でも、実行結果の記録でもありません。

通販サイトの問い合わせAIに「モバイルバッテリーは何日で届く?」と聞く。使うのは配送予定の照会だけなのに、モデルには在庫検索、商品仕様、返品ルールなど、関係のない機能の詳しい説明も渡しているかもしれない。機能を増やすほど、ひとつの質問に付き添う説明も長くなる。

Googleは11月19日、Gemini APIの「Tool Retrieval」を発表した。Googleが紹介したサーバー側の方式では、アプリはツールの定義をAPIに送る。そのうち、モデルが詳しく読む定義を必要なものに絞る仕組みだ。Geminiのチャットアプリにボタンが増えた話ではない。AIがアプリの機能を呼び出すように作っている開発者向けで、Gemini 3.6以降の対応モデルが対象で、Interactions APIで使えるプレビュー機能だ。APIバージョンはv1betaが必要で、従来のgenerateContentでは使えない。

棚には名前を並べ、使う機能だけ説明を開く

AIに機能を使わせるには、普通は機能の名前、役割、渡す値の形式を教える。配送予定の照会なら、商品番号と郵便番号が必要で、郵便番号は先頭にゼロが付くこともあるので文字列として渡す、といった取り決めだ。この項目名や型、必須項目をまとめた定義を「スキーマ」と呼ぶ。

Googleが紹介したサーバー側の方式では、開発者はリクエストにツールの定義を渡し、tool_searchを加える。減らすのは通信で送る定義そのものではなく、モデルが最初に読む定義だ。ただし、defer_loadingで後から読み込むよう指定した機能については、モデルが最初に見るのは名前と説明だけ。Geminiは必要と判断した機能を名前で探し、APIが詳しいスキーマを読み込んだあとで、引数を付けた呼び出しの要求を出す。ここまでは同じAPIリクエスト内で進む。この例のような自作の関数では、アプリが実際に照会し、その結果を返す処理は別だ。

たとえば架空の問い合わせAIなら、配送予定を聞かれた時点では配送照会の定義だけを開き、商品サイズや返品ルールの定義は読ませない。逆に「この商品は届いてから何日なら返品できる?」なら、探す先が変わる。これは仕組みを説明するための例で、RINKAKUでAPIを実行した結果ではない。

アプリは配送照会・在庫検索・返品照会の定義をAPIに送る。モデルは遅延対象の名前と説明を先に見て、この例では配送照会だけ詳しい定義を読み、呼び出しを要求。照会の実行前にアプリが引数と権限を確認する。
「いつ届く?」と聞かれた架空例。アプリがAPIへ送る定義と、モデルが詳しく読む定義は同じではない。配送照会の実行前には、アプリが引数と権限を確かめる。RINKAKU作図、実測ではない。

見つかることと、実行してよいことは別

読み込みを後回しにしても、その機能の名前と説明はモデルに見えている。だから、利用者に許可していない機能を一覧に入れたまま、遅延読み込みをアクセス制御の代わりにはできない。アプリは利用者に合わせて候補を絞り、実行時にも権限と引数を確かめる。配送予定を答えるだけなら、注文の変更や決済を行う機能を、そもそも検証に入れる必要はない。

頻繁に使う少数の機能は、最初から詳しい定義を読み込ませたままにもできる。GoogleはTool Retrievalそのものに別料金はないとしているが、モデルの通常の入出力料金はかかる。検索用の固定分が入力に加わる。検索が起きると、その時点の文脈と新たに開いた定義を処理する追加分もかかり、開いた定義はその後の会話に残る。道具の数が少ない、または会話のたびに多くの定義を開くなら、減る分が増える分を上回るとは限らない。

試すなら、まず書き込みのない機能だけで、同じモデルに同じ質問を渡して比べたい。毎回すべての定義を読ませる版と、よく使うものだけを先に読み込ませる版で、通常の入力と検索時の追加トークン(total_tool_use_tokens)、回答までの待ち時間、正しい機能と引数を選べたかを別々に記録する。キャッシュの条件もそろえる。とくに、似た名前の機能を取り違えないか。入力処理が軽くなっても問い合わせに違う答えを返すなら、切り替える理由にはならない。

全定義を先に読む版と一部を後から読む版を、同じモデル・質問・キャッシュ条件で比較する。通常入力トークン、検索の追加トークン、回答までの時間、選んだ機能と引数の正誤を別々に記録する。
切り替えるか判断するための比較表。モデル・質問・キャッシュ条件をそろえて、処理量、待ち時間、機能と引数の正誤を別々に記録する。記録項目の一覧で、比較結果ではない。RINKAKU作図。

出典:GoogleのTool Retrieval発表(2026年11月19日)/Tool Retrievalの対応・制限・課金/関数呼び出しガイド