Google открыла предварительный доступ к выборочной загрузке схем функций в Gemini API
Tool Retrieval помогает работать с большими каталогами инструментов. Gemini получает полное описание параметров выбранной функции только тогда, когда оно нужно для задачи.

Зачем отделять каталог от параметров
19 ноября Google представила Tool Retrieval в предварительной версии Interactions API. Функция рассчитана на приложения, где модели доступно много инструментов, а конкретный запрос обычно задействует лишь несколько из них. При обычном вызове функций приложение задаёт названия, описания и схемы параметров. Схема сообщает модели, какие поля нужны выбранной функции и в каком формате их передавать. Если в каждый запрос добавлять полное описание всех функций, часть входа займут поля, которые в данной задаче не пригодятся.
Это различие заметно, например, во внутреннем справочнике с функциями поиска по новостям, чтения карточек документа и получения списка отделов. Запрос о времени работы одного подразделения может использовать всего одну функцию. Подключать её к модели можно вместе с соседними, но полные схемы соседних функций в таком ходе необязательны. Понятное назначение каждой функции при этом важно даже в компактном каталоге. Иначе близкие по смыслу операции труднее различать на первом этапе выбора.
Как модель получает нужную схему
При поиске на стороне Google модель видит названия и краткие описания отложенных инструментов. Если требуется один из них, API добавляет его полную схему в ход взаимодействия. После этого в ответе может появиться вызов функции с аргументами. Поиск схемы и формирование вызова происходят в рамках одного запроса к API. Обычная пользовательская функция по-прежнему исполняется кодом приложения, и только он возвращает результат модели.
В ответе Interactions API поиск инструмента, найденная схема и собственно вызов доступны как отдельные шаги. Это позволяет понять, возникла ли ошибка на этапе выбора или уже при формировании параметров. Можно оставить часто используемые функции с полным описанием в начале диалога и отложить только редкие. Google также отмечает, что загруженные позднее схемы не меняют исходную часть контекста, которую можно кешировать между ходами.
Когда поиск остаётся у приложения
Для команд с собственным реестром предусмотрен вариант, при котором поисковый запрос обрабатывает само приложение. Оно возвращает найденные описания и может учитывать роль пользователя, которая уже определена в его системе. Такая схема требует дополнительного обмена с API при каждом поиске. Сервис также поддерживает отложенную загрузку функций удалённого MCP-сервера. В каждом варианте доступ к данным и разрешение выполнить выбранное действие остаются отдельными проверками в приложении.
Предварительная версия работает через Interactions API с Gemini 3.6 и более новыми моделями, включая семейство Gemini 4. Отдельной платы за Tool Retrieval Google не заявляет. Поиск добавляет небольшой фиксированный объём входных токенов, а схемы, которые действительно загрузились, учитываются по обычному тарифу модели. Для небольшого набора функций выигрыш заранее неизвестен. Для сравнения полезно прогнать типовые вопросы с одинаковыми схемами, сопоставить объём входа, проверить число дополнительных обращений и убедиться, что редкие функции по-прежнему выбираются в нужных случаях.
Что учесть при пробном подключении
Документация указывает версию API v1beta и предупреждает, что интерфейс может измениться до общего доступа. В прежнем методе generateContent выборочная загрузка схем недоступна. Если приложение использует этот метод, стоит выделить пробный сценарий на Interactions API и сравнивать одинаковые запросы. Для диагностики важно отдельно учитывать время поиска, вызова функции и получения итогового ответа.


