2026年11月19日、Google は Gemini Interactions API のプレビュー機能として「Tool Retrieval(ツールオンデマンド読み込み)」を公開した。数十〜数百の関数を扱うエージェントにおいて、毎回すべてのパラメータ定義を送信することによる入力トークン増大・遅延・選択精度低下を抑える仕組みで、Gemini 3.6 以降(全 Gemini 4 モデルを含む)で利用できる。
サーバー側/クライアント側検索とリモート MCP 対応
ツール名と説明文は維持し、スキーマのみ同一リクエスト内で動的取得:tools 配列に tool_search を追加し、遅延読み込みしたい関数や mcp_server(リモート MCP サーバー)に defer_loading: true を指定すると、name と description だけが初期コンテキストに残り、詳細な parameters スキーマはモデルが必要と判断したタイミングで同一リクエスト内にロードされる(一連の流れは interaction.steps で確認可能)。また独自レジストリやユーザー別権限制御を使う場合は execution: client を指定して独自検索結果を返すこともできる(検索ごとに1往復追加)。
トークンが節約される条件とプレフィックスキャッシュとの相性
追加機能料なし・標準トークン課金下での損益分岐点:Tool Retrieval に専用の追加料金はなく標準の入力・出力トークン料金が適用されるが、tool_search 有効化に伴う少量の固定入力トークンと、一度読み込まれたスキーマの継続的な入力トークン課金が発生する。そのため「読み込まれずに済んだロングテールツールのスキーマ量」が「固定検索コスト+実際に読み込んだスキーマ量」を上回る大規模ツール環境でコスト削減効果を発揮する。遅延スキーマは会話後半に追加されるため、プロンプト先頭のプレフィックスキャッシュも維持される。
