Gemini APIにTool Retrieval|必要なツールの詳細だけ読み込む仕組みと導入条件

11月19日発表のGemini API Tool Retrievalを解説。Interactions APIのプレビュー条件、tool_searchとdefer_loading、料金と権限確認の違いを整理します。

野村直矢

野村 直矢

KOKORASHI AI / 福岡のAI導入支援・LINE Bot開発

Gemini APIに、必要になったツールの詳しい定義だけを読み込むTool Retrievalがプレビューで加わりました。Googleが11月19日に発表した機能を11月21日に確認した解説です。Geminiアプリの新しいボタンではなく、多数のツールを接続するアプリを作る開発者向けの更新です。

何が変わる?名前と説明を残し、詳細を後読みする

ツールを増やすと、使わない機能のパラメーター定義まで入力へ含める負担が増えます。Tool Retrievalでは、遅延読み込みにしたツールも名前と説明はモデルへ見せ、必要なときに詳しいスキーマを取得します。全部の情報を隠して、何の手がかりもなく探させる仕組みではありません。

例えば予約確認・顧客検索・在庫照会などを扱うアプリで、在庫の質問に必要な定義を選ぶ場面が考えられます。これは利用場面の例で、特定企業が導入して成果を出した事例ではありません。

利用条件:Interactions APIのプレビュー

利用するのはv1betaのInteractions APIです。generateContentでは対応しません。対象はGemini 3.6以降の対応モデルで、Gemini 4系列も含みます。日本はAPIの対応地域一覧にありますが、契約・対象モデル・プロジェクトの設定は利用アカウントで確認します。プレビューのため仕様は正式提供までに変わり得ます。

ツールの全詳細を先に渡す構成と必要な詳細だけ後読みする構成、API・設定・権限確認の項目を比較
定義の読み込みを減らす仕組みと、実際の操作を許可する判断は別に設計します。

まず確認する設定と、実行までの流れ

  • Interactions APIを使っているか、対象モデルとv1betaを確認する
  • toolsへtool_searchを追加する
  • 後読みしたいツールにdefer_loading: trueを設定し、完全なparametersを定義する
  • 検索結果とfunction_callを確認し、アプリ側で権限・引数を検証してから実行する

よく使うツールは先に読み込んだままにし、頻度の低いものを後読みする構成が公式で勧められています。呼び出し履歴のstepsは署名などを保ったまま引き継ぐ必要があり、表示用に加工したログをそのまま会話履歴へ戻す設計は避けます。

無料化ではない:削減幅は実際の処理で比べる

Tool Retrieval自体の別料金はありませんが、通常の入出力トークン料金はかかります。サーバー側の検索では内部で追加のモデル呼び出しが走り、その入力も課金されます。読み込んだスキーマも会話中の入力になります。必ず安く速くなるとは断定せず、未読の定義がどれだけあるかで比較します。

KOKORASHI AIの提案:同じ依頼で移行前後を比べる

最初は、読み取り専用の照会ツールを使った小さな比較が向いています。同じ依頼を従来構成と後読み構成へ渡し、入力トークン、応答時間、選んだツール、失敗した依頼を記録します。導入の成否を料金だけで決めず、必要な機能を見つけられたかも確認する提案です。

また、ツールを発見できることは操作の許可を意味しません。返金・削除・外部送信などは、アプリ側で利用者の権限と確認条件を別に持たせます。機能の候補を効率よく渡しながら、実行の境界は狭く保つ設計を勧めます。

出典・参考情報

無料メルマガ

福岡の中小事業者向け、AI活用のヒントを月数回お届け

今日のような記事の要点と、関心のあるテーマに合わせたおすすめ記事をメールでお送りします。

Free consultation

この業種でも、AIチャットは同じ考え方で作れます

業種ごとの相談例をもとに、小さく始められる形をご提案します。

LINEで無料相談