Перейти к содержанию
ERITKOM
ИИНовость

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

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

Ноутбук MacBook Pro на рабочем столе на архивной фотографии 2014 года
Архивное фото Ed Gregory / www.Pixel.la, Wikimedia Commons, CC0 1.0. Изменены размер и формат JPEG → WebP.

Зачем отделять каталог от параметров

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 и сравнивать одинаковые запросы. Для диагностики важно отдельно учитывать время поиска, вызова функции и получения итогового ответа.

Источники

Принципы журнала и исправления.

ERITKOM / НОВЫЙ ПРОЕКТ

Расскажите о задаче и оставьте контакты. Мы свяжемся с вами, чтобы обсудить проект.

  1. 01 Контакты
  2. 02 Ваша задача