AIエージェント導入・運用

Gemini APIのTool Retrievalを導入前に確認する。ツール選択と承認を分ける

公開日 ・更新日

AIエージェントへ接続するツールが増えると、毎回すべてのパラメータ定義を送る設計は確認しにくくなります。Googleが2026年11月19日に発表したGemini APIのTool Retrievalは、必要なときだけツールのスキーマを読み込むプレビュー機能です。導入時は入力コストだけでなく、選択と実行の承認を分けて考えます。

一覧を見せ、詳細を遅延させる

Tool RetrievalはInteractions APIで使い、リクエストにtool_searchを追加し、後から読み込むツールへdefer_loadingを設定します。モデルにはツール名と説明を見せたまま、パラメータスキーマを最初の文脈から外せます。必要になったツールの詳細を読み込んでから、通常の関数呼び出しへ進む流れです。

ツールが数十、数百へ増えると、全定義を毎回送ることで入力トークン、待ち時間、選択の精度に影響が出ます。よく使う読み取りツールは最初から置き、利用頻度が低いものだけを遅延させるなど、仕事の種類で分けます。仕組みを有効にするだけで効果が決まるわけではありません。

権限と副作用をツールごとに分ける

顧客情報を読むツール、在庫を確認するツール、返金や送信を実行するツールを同じ権限にしません。読み取りは自動で試しても、書き込み、送信、予約変更は人の確認を必須にします。ツール名と説明が正しくても、実行先の権限や入力値まで安全になるわけではないためです。

リモートMCPサーバーをつなぐ場合も、公開してよいツールだけを登録し、個人情報や外部送信を扱う機能には停止条件を置きます。プレビュー機能であることを前提に、失敗時に接続を切る担当者と手順を決めておきます。

ログに選択と結果を残す

一回の実行ごとに、依頼、選ばれたツール、読み込んだスキーマの版、入力の確認者、関数の結果、エラーを記録します。本文や秘密情報をそのまま保存せず、識別子と確認結果だけを残します。選択を間違えた場合に、説明文の問題か権限設計の問題かを後から分けられます。

小さな業務で切替条件を試す

まずは社内の読み取り作業を一つ選び、全ツールを読み込む場合とTool Retrievalを使う場合を同じ入力で比べます。入力トークン、待ち時間、誤選択、確認にかかった時間を記録し、改善しなければ元の構成へ戻します。外部へ影響する操作は、読み取りの結果を人が確認してから次へ進む形にします。

ツールの数を減らすだけでなく、選択、権限、承認、ログが一続きになるAIエージェントを設計したい方は、COZITOへご相談ください。

著者: 松井 勇樹