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

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