本文へ移動
NEWS
Gemini

Gemini APIの新機能を試すと入力とツール使用70%減 正確さは落ちた

読了 約6分
入力とツール使用70%減で判明。Tool Retrievalは正確さ低下

この記事の要点

  • GoogleがGemini APIに、使うツールの定義だけを読み込むTool Retrievalをプレビューで追加しました。
  • AInformationが関数60本で試すと、入力とツール使用の合計は平均70%減りました。
  • ただし依頼どおりの関数を最初に呼ぶ回数は減っています。

Gemini APIのTool Retrieval公開 ツールの定義は使う分だけ読む

Googleは19日(米国時間)に、Gemini APIで「Tool Retrieval」のプレビュー提供を始めました。AIエージェントにつないだツールのうち、使うものの定義だけを読み込む機能です。

これまではツールを多くつなぐほど、毎回すべての定義を読み込む必要がありました。そのぶん入力トークンと処理時間が増え、ツール選びの精度も落ちるとImpress Watchは伝えています。

公式ドキュメントによると、Geminiが最初に見るのは各ツールの名前と説明だけです。使うと決めたときに引数の定義を読み込み、関数の呼び出しまで1回のリクエストで進めます。

  • ツールの一覧に tool_search を1つ足す
  • 後回しにしたいツールに defer_loading を付ける
  • リモートMCPサーバーに付けると、そのサーバーのツールがまとめて後回しになる
Gemini APIのTool Retrievalの公式ドキュメント
Gemini APIのTool Retrievalの公式ドキュメント / 出典:ai.google.dev / 制作:AInformation
これまでの流れ
  1. 19日(米国時間)GoogleがTool Retrievalのプレビュー提供を開始
  2. 11/20AInformationが関数60本で試した

対象は4モデルだけ generateContentでは使えない

Tool Retrievalが動くのは、Interactions APIを通したときだけです。generateContentの呼び方には対応していないと公式は書いています。対応モデルにはGemini 4 Argonも入っています。

項目 内容(Google公式ドキュメント)
対応モデル gemini-4-hydrogen・gemini-4-argon・gemini-3.8-flash・gemini-3.6-flash
使えるAPI Interactions API(v1beta)
提供の段階 プレビュー
追加料金 なし(通常の単価で請求)

料金は別にかかりません。後回しにしたツールは1行の一覧として入力に数えられます。引数の定義は読み込むまで請求されないと公式は説明しています。

一方で検索のたびに費用が足されます。対応していないモデルで defer_loading を付けると、400エラーが返ります。

Tool Retrievalでできること。Gemini。プレビュー版。できる。使う関数の定義だけ読む。MCPサーバーごと後回し。追加料金はかからない。できない。generateContentでは不可。読んだツールは外せない。外れても専用エラーなし。対応は4モデルとInteractions APIだけ。AInformation編集部が作ったイラスト図解(1本のできる/できない)
Tool Retrievalでできること / データ:Google Gemini API 公式ドキュメント / 制作:AInformation

関数60本で試した結果 入力とツール使用の合計は70%減った

AInformationは11月20日に、gemini-3.6-flashで実際に試しました。請求・顧客管理・人事・在庫・予定・問い合わせの6部門に10本ずつ、計60本の関数を用意しています。

日本語の依頼5本を、全部渡す方式とTool Retrievalで1回ずつ投げました。結果は次のとおりです。

項目(AInformation独自検証・11月20日・各5回) 全部渡す Tool Retrieval
入力トークン(平均) 10,499 1,454
ツール使用トークン(平均) 0 1,736
入力とツール使用の合計(平均) 10,499 3,190
返答までの秒数(中央値) 6.13秒 5.66秒
依頼どおりの関数を最初に呼んだ数 3本中3本 3本中1本

入力とツール使用を足すと、平均10,499トークンが3,190トークンになりました。70%減った計算です。検索1回で読み込んだ関数は、60本のうち1〜3本でした。

気になったのは最初に呼ぶ関数です。更新・要約・削除のように操作がはっきりした3本で、依頼どおりの関数を先に呼んだのは削除の1本だけでした。更新と要約は、先に読み取りの関数を呼んでいます。

検索の段階では更新の関数も読み込まれていました。中身を確かめてから書き換える動きとも読めます。ただ今回の試験は最初の呼び出しまでで、その先は確かめていません。

導入前に確かめる3つ ツールが少ないと逆に増えることがある

公式の試算では、ツールが少ないと逆にトークンが増えます。数字は実測ではなく、説明用に丸めた値だと公式は断っています。

場面(Google公式の試算) 全部渡す Tool Retrieval
ツール200本(1本400トークン) 164,000 約23,650
ツール10本・会話30,000トークン 68,000 約92,830

会話が長いうえに毎回検索すると、そのたびに会話の中身が送り直されるためです。切り替える前に、次の3つを見ておくと安心です。

  • ほぼ毎回使う数本は defer_loading を付けずに残す
  • 指示文やほかのツールの出力に名前が出るツールは後回しにしない
  • 自分の処理で本当に減るかを usage の数字で測る

会話の履歴を自前で積む場合は、検索の手順を署名ごと送り返す必要があります。抜けると2回目のリクエストが400エラーで止まります。

ツールが数十本を超えた社内エージェントなら、まず1部門ぶんだけ切り替えて数字を比べるのが近道です。

この記事に出てくることば
defer_loading
ツールの引数の定義を最初は渡さず、Geminiが必要と判断したときに読み込ませるための指定。
導入の現場から考える

※記事の事実とは分けて、筆者の考えを書いています。

藤井俊太AI導入コンサルタント

分析・考察社内の業務システムをAIエージェントにつなぐ情報システム部門には、待っていた機能だと思います。部門ごとに関数を増やすたびに毎回の入力が膨らむ悩みは、かなり軽くなりそうです。

ただ試した範囲では、書き換えの依頼でも先に読み取りを挟む動きが出ました。承認の流れを組んでいる会社は、往復が増える前提で呼び出しの上限回数を決めておく必要がありそうです。

よくある質問
Gemini APIのTool Retrievalに追加料金はかかる?
追加料金はかかりません。通常の入力・キャッシュ・出力の単価で請求されます。後回しにしたツールは1行の一覧として入力に数えられ、引数の定義は読み込むまで請求されません。ただし検索のたびに費用が足されます。公式の試算ではツール10本と30,000トークンの会話で、68,000トークンが約92,830トークンに増えています。
Tool RetrievalはgenerateContentでも使える?
使えません。Tool RetrievalはInteractions API(v1beta)だけで動きます。対応モデルもgemini-4-hydrogen・gemini-4-argon・gemini-3.8-flash・gemini-3.6-flashの4つです。対応していないモデルで defer_loading を付けると400エラーが返ります。
検索で合うツールが見つからないとどうなる?
専用のエラーは返りません。合うツールが無い問い合わせには、Geminiが文章で答えると公式ドキュメントは書いています。公式は tool_search_result の有無で外れを見分けないよう勧めています。返ってきた手順の中身を見て次の動きを決める作りにしておくと安心です。

【この記事の出典】

次に読む記事

広告を載せており、そこから申し込みがあると紹介料を受け取ることがあります。

この記事に出てくるAIも、まとめて比べられます 509本のAIツールを、やりたいこと・料金・日本語対応で絞り込めるデータベースです。5日ごとに料金を取り直しています。 AIツールを探す

あわせて読みたいRELATED