Эволюция Gemini API Managed Agents: Gemini 3.6 Flash, система хуков и расширение возможностей

Платформа Managed Agents в составе Gemini API претерпела масштабное обновление, получив поддержку хуков среды (environment hooks), расширенные возможности выбора моделей и долгожданный доступ для пользователей бесплатного уровня (Free Tier). Эти функциональные нововведения логически развивают экосистему, начатую с внедрения фоновых задач и интеграции с удаленными MCP-серверами (Model Context Protocol). Управляемые агенты в рамках Gemini Interactions API представляют собой комплексный инструмент: один единственный API-вызов позволяет координировать процессы рассуждения, выполнения кода, установки необходимых пакетов, управления файловой системой и веб-поиска в полностью изолированной облачной песочнице. Если вы используете AI-ассистента для написания кода, вы можете легко предоставить ему доступ к навыкам Interactions API, добавив в терминал следующую команду: npx skills add google-gemini/gemini-skills --skill gemini-interactions-api. Для разработчиков, использующих SDK на TypeScript или JavaScript, доступна установка через npm install @google/genai. Для работы с Python или cURL-запросами обратитесь к подробной документации агента Antigravity.

Gemini 3.6 Flash становится стандартом

Агент antigravity-preview-05-2026 теперь переведен на работу с моделью Gemini 3.6 Flash по умолчанию. Это обновление происходит автоматически, не требуя никаких правок в существующем коде — ваши последующие вызовы подхватят новую версию самостоятельно. Тем не менее, разработчики сохраняют полный контроль: вы можете явно выбрать модель, передав параметр agent_config.model при создании интеракции или управляемого агента. Например, можно использовать Gemini 3.5 Flash-Lite для существенной экономии бюджета или зафиксировать любую другую предпочитаемую модель. Актуальный список поддерживаемых моделей включает:

• Gemini 3.6 Flash (gemini-3.6-flash): текущий стандарт, обеспечивающий оптимальный баланс между способностью к логическому рассуждению, написанием кода и использованием инструментов.
• Gemini 3.5 Flash (gemini-3.5-flash): модель предыдущего поколения для стандартных агентных рабочих процессов.
• Gemini 3.5 Flash-Lite (gemini-3.5-flash-lite): наиболее экономичная модель в семействе 3.5, характеризующаяся минимальными задержками при выполнении задач.

Пример программной настройки при создании интеракции:

import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
  agent: "antigravity-preview-05-2026",
  input: "Audit all dependencies in package.json, upgrade outdated packages, and verify the build by running npm test.",
  environment: "remote",
  agent_config: {
    type: "antigravity",
    model: "gemini-3.5-flash-lite",
  },
});
console.log(interaction.output_text);

Среда выполнения и система хуков: управление инструментами

Новая система хуков (environment hooks) позволяет исполнять пользовательские скрипты до (pre_tool_execution) или после (post_tool_execution) вызова любого инструмента агентом внутри песочницы. Для настройки достаточно разместить файл .agents/hooks.json в вашей среде выполнения. Поле matcher поддерживает регулярные выражения, что дает гибкость в таргетировании: можно применять хуки к конкретным инструментам (например, code_execution|write_file) или ко всем операциям сразу через символ *.

Пример конфигурации:

{
  "security-gate": {
    "pre_tool_execution": [
      { "matcher": "code_execution|write_file", "hooks": [ { "type": "command", "command": "python3 /.agents/hooks-scripts/gate.py", "timeout": 10 } ] }
    ]
  },
  "auto-format": {
    "post_tool_execution": [
      { "matcher": "*", "hooks": [ { "type": "command", "command": "python3 /.agents/hooks-scripts/auto_lint.py", "timeout": 15 } ] }
    ]
  }
}

В данной конфигурации группа security-gate запускает gate.py перед каждым вызовом code_execution или write_file. Если скрипт возвращает JSON-ответ {"decision": "deny", "reason": "..."}, действие блокируется, а причина отказа передается в контекст модели. Группа auto-format запускает auto_lint.py после завершения любого инструмента для обеспечения чистоты кода. Хуки также поддерживают HTTP-обработчики, которые могут отправлять POST-запросы на внешние эндпоинты (детали реализации и семантику обработки ошибок можно найти в официальной документации). Компании уже активно используют хуки для построения полноценных продакшн-конвейеров валидации. Например, AI-native инвестиционный банк Offdeal применяет post_tool_execution хуки для автоматической верификации изображений. Их AI-аналитик Archie подготавливает презентации с множеством логотипов, которые требуют проверки на соответствие размеру, контрастности, прозрачности фона и качеству. Ранее из-за удаленной природы песочницы такой контроль был невозможен. Теперь хук запускает конвейер внутри среды, который проводит pixel-level проверку, верифицирует логотипы через Gemini Vision и публикует манифест одобренных файлов, которые только и допускаются к использованию в слайдах.

Контроль расходов, автоматизация и управление средами

Managed Agents теперь доступны на бесплатном тарифе (Free Tier) для всех проектов. Разработчики могут экспериментировать с агентными рабочими процессами, используя API-ключ проекта без необходимости активной привязки биллинга. Для защиты от перерасхода средств при выполнении сложных автономных циклов реализован параметр max_total_tokens внутри agent_config. При достижении лимита (включая входные, выходные токены и токены мышления) выполнение безопасно приостанавливается, а интеракция возвращает статус incomplete. Состояние среды сохраняется, позволяя продолжить выполнение с той же точки при помощи previous_interaction_id и обновленного лимита токенов.

Для автоматизации предусмотрены запланированные триггеры (scheduled execution): они связывают агента, среду, промпт и расписание cron в единый ресурс, работающий без ручного вмешательства. Файлы сохраняются между запусками, так как каждый цикл переиспользует одну и ту же среду. Дополнительно обновленный Environments API позволяет программно инспектировать, восстанавливать или удалять сессии песочниц, что избавляет от необходимости ждать стандартного истечения срока действия (TTL) в 7 дней. Эти инструменты превращают управляемых агентов в надежных, автономных и предсказуемых помощников для любых DevOps-сценариев. Подробную информацию об определении кастомных агентов и правилах сети можно найти в обзоре Gemini Interactions API и руководстве по быстрому старту (quickstart).

Источник: blog.google