冒頭の画像・動画は、必要な道具の説明だけを開く仕組みを表した生成イメージです。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を実行した結果ではない。
見つかることと、実行してよいことは別
読み込みを後回しにしても、その機能の名前と説明はモデルに見えている。だから、利用者に許可していない機能を一覧に入れたまま、遅延読み込みをアクセス制御の代わりにはできない。アプリは利用者に合わせて候補を絞り、実行時にも権限と引数を確かめる。配送予定を答えるだけなら、注文の変更や決済を行う機能を、そもそも検証に入れる必要はない。
頻繁に使う少数の機能は、最初から詳しい定義を読み込ませたままにもできる。GoogleはTool Retrievalそのものに別料金はないとしているが、モデルの通常の入出力料金はかかる。検索用の固定分が入力に加わる。検索が起きると、その時点の文脈と新たに開いた定義を処理する追加分もかかり、開いた定義はその後の会話に残る。道具の数が少ない、または会話のたびに多くの定義を開くなら、減る分が増える分を上回るとは限らない。
試すなら、まず書き込みのない機能だけで、同じモデルに同じ質問を渡して比べたい。毎回すべての定義を読ませる版と、よく使うものだけを先に読み込ませる版で、通常の入力と検索時の追加トークン(total_tool_use_tokens)、回答までの待ち時間、正しい機能と引数を選べたかを別々に記録する。キャッシュの条件もそろえる。とくに、似た名前の機能を取り違えないか。入力処理が軽くなっても問い合わせに違う答えを返すなら、切り替える理由にはならない。
出典:GoogleのTool Retrieval発表(2026年11月19日)/Tool Retrievalの対応・制限・課金/関数呼び出しガイド


