19 ноября 2026 г.
Tool Retrieval: Gemini находит и загружает нужную схему инструмента за 1 API-вызов
Google добавила в Gemini API поиск инструментов по запросу: модель загружает схемы по мере работы.

Модель получает имена и описания инструментов, а полную схему загружает после поиска. Поиск, загрузка и function_call проходят за 1 API-вызов.
Раньше разработчик передавал модели все схемы заранее. С Tool Retrieval в Gemini можно отложить их загрузку до момента, когда модели понадобится конкретная функция. Google запустила возможность в превью 19 ноября 2026 года. Собственный поисковый индекс для неё не требуется.
Не хотите разбираться сами? Внедряем ИИ в ваш бизнес: задачи без лимита, одна цена в месяц, отмена в любой момент.
Как включить поиск инструментов
Подключение через API. Добавьте `{"type":"tool_search"}` в `tools`, у нужных `function` задайте `defer_loading: true` и вызовите `client.interactions.create()`. Потребуется API `v1beta` и Interactions API: через `generateContent` поиск не работает. В документации Google есть примеры для Python, JavaScript и REST.
На старте документация перечисляет 4 поддерживаемые модели:
- `gemini-4-hydrogen`; - `gemini-4-argon`; - `gemini-3.8-flash`; - `gemini-3.6-flash`.
Для remote MCP достаточно задать `defer_loading: true` у `mcp_server`. Модель будет загружать инструменты сервера по запросу, без поштучного объявления.
Разработчик может подключить собственный реестр инструментов: задать `execution: "client"` у `tool_search` и возвращать найденные схемы в `function_result`. При таком варианте каждый поиск добавляет 1 сетевой цикл, зато инструменты можно подключать посреди разговора.
Что оплачивается и остаётся в кеше
Оплата по токенам. Google не берёт отдельную плату за Tool Retrieval, действуют тарифы выбранной модели. Каждый `tool_search` добавляет фиксированный блок входных токенов. Загруженные схемы оплачиваются как входные токены до конца разговора.
Tool Retrieval сохраняет prefix caching. Отложенные схемы добавляются позже в разговоре, поэтому кешированный префикс не меняется между ходами.
Полный массив `tools` нужно отправлять при каждом запросе, включая запросы с `previous_interaction_id` и возвратом `function_result`: API не сохраняет объявления инструментов между запросами.
Первоисточник