Модели и платформы ИИ
Google представляет предварительную версию подгрузки инструментов по запросу для агентов Gemini API

Ключевые моментыИзвлечение инструментов откладывает полные схемы, поэтому большие библиотеки…
Показать больше
- Извлечение инструментов откладывает полные схемы, поэтому большие библиотеки инструментов больше не увеличивают входные токены каждого запроса.
- Серверный поиск добавляет вызов модели с полным контекстом, что может перевесить экономию для небольших библиотек инструментов.
- Извлечённые схемы невозможно выгрузить, и полный массив инструментов необходимо отправлять заново при каждом запросе.
19 ноября 2026 года Google объявила о подгрузке инструментов и открыла доступ к этой функции в предварительной версии API взаимодействий Gemini. Она позволяет агентам держать большие библиотеки инструментов наготове и загружать полные схемы параметров только тогда, когда этого требует текущая задача.
По словам Google, традиционный подход становится неудобным, когда агенты подключаются к десяткам или сотням инструментов: отправка каждой полной схемы увеличивает число входных токенов, повышает задержку и снижает точность выбора инструментов по мере роста списка кандидатов. Изначально подгрузка инструментов оставляет в контексте только название и описание каждого отложенного инструмента, не включая схему, которая определяет аргументы функции, пока модель не запросит ее.
Интерфейс Interactions API стал общедоступен в июне 2026 года и рекомендован Google для новых проектов. Функция Tool Retrieval работает только через этот интерфейс; более старый метод её не поддерживает. generateContent метод эту функцию не поддерживает.
Подгрузка инструментов на стороне сервера и клиента
В режиме по умолчанию, с обработкой на стороне сервера, разработчики добавляют tool_search инструмент и задают defer_loading: true для выбранных инструментов-функций. Часто используемые функции можно загрузить полностью, тогда как специализированные изначально представлены только своими названиями и описаниями. Когда модели нужен отложенный инструмент, один вызов API может содержать tool_search_call, а tool_search_result , содержащий полную схему, и полученный function_call, благодаря чему эти этапы выполнения можно отслеживать при отладке. Если используется пользовательская функция, код разработчика по-прежнему выполняет ее и возвращает function_result.
Разработчикам не нужно создавать или размещать индекс для поиска: поиск на стороне сервера выполняет Gemini. Если задать defer_loading для удаленного сервера MCP, будут отложены все инструменты, предоставляемые этим сервером, поэтому для большого сервера не требуется перечислять каждый инструмент отдельно. Загруженные схемы вставляются в то место, где они подгружаются, а не в начало запроса, благодаря чему предшествующий префикс остается неизменным и может кэшироваться автоматически.
При подгрузке на стороне клиента поиск, ранжирование и фильтрацию выполняет приложение разработчика. Для каждого поиска требуется дополнительный обмен данными, но инструменты можно добавлять прямо во время разговора, не объявляя их заранее, например, когда пользователь подключает новую интеграцию. Подгрузку на стороне сервера и клиента нельзя совмещать в одном запросе; допускается ровно одно tool_search определение.
Расход токенов и поддержка моделей
За подгрузку инструментов не взимается отдельная плата, однако она меняет порядок тарификации токенов, а не устраняет расходы на использование инструментов. Инструкции для поиска на стороне сервера добавляют к каждому запросу небольшой блок входных данных фиксированного размера; согласно руководству по настройке, на ранних испытаниях компактная запись с названием и описанием требовала около 26 токенов на каждый отложенный инструмент. Схема каждого инструмента, загруженная моделью, продолжает тарифицироваться как входные данные в последующих вызовах и ходах диалога. Каждый поиск на стороне сервера также запускает дополнительный вызов модели с полным контекстом и вновь загруженными схемами. Использование токенов для этого запроса учитывается отдельно и оплачивается по тарифу на входные данные.
В явно обозначенном как иллюстративный примере руководства с двумя запросами используются округленные числа, а выходные токены и кэширование не учитываются. При 200 инструментах по 400 токенов каждый и двух загруженных инструментах статическая загрузка, согласно примеру, составляет 164 000 входных токенов, тогда как при подгрузке используется около 23 650 входных токенов и токенов на вызов инструментов. Во втором сценарии с 10 инструментами того же размера и контекстом в 30 000 токенов общий объем составляет 68 000 токенов при статической загрузке и около 92 830 при подгрузке. Этот второй пример показывает, как повторная передача большого контекста для поиска может свести на нет экономию от небольшой библиотеки инструментов.
В руководстве среди поддерживаемых моделей прямо указаны Gemini 4 Argon, Gemini 3.8 Flash и Gemini 3.6 Flash. Запросы, в которых для неподдерживаемой модели задан параметр defer_loading возвращают ошибку 400. Также отмечается, что интерфейс API в предварительной версии может измениться до общего выпуска.
При работе с поддерживаемыми моделями важно учитывать и другие ограничения. Загруженные инструменты нельзя выгрузить в ходе разговора. Кроме того, массив инструментов необходимо передавать заново в каждом запросе, в том числе в ходах диалога, связанных с помощью previous_interaction_id, поскольку объявления инструментов не сохраняются между запросами.
В более общем руководстве Google по вызову функций рекомендуется рассмотреть подгрузку, когда библиотека насчитывает примерно от 20 до 30 инструментов. Таким образом, новый механизм позволяет агентам держать наготове гораздо более крупные каталоги, однако то, снизит или увеличит дополнительная возможность расход токенов, зависит от частоты поиска и количества сохраняемых схем.












