Обзор агентов

Управляемые агенты в Gemini API – это настраиваемый каркас агента. Один вызов API создает изолированную среду Linux, в которой агент может рассуждать, выполнять код, управлять файлами и автономно просматривать веб-страницы.

Доступные управляемые агенты

• Агент Antigravity – универсальный управляемый агент общего назначения, созданный на основе Gemini 3.8 Flash. Выполняет код, управляет файлами и ищет информацию в интернете в безопасной среде Linux, размещенной в Google. Вы можете настроить базовую модель (например, Gemini 3.6 Flash или Gemini 3.5 Flash) с помощью agent_config и расширить ее собственными инструкциями, навыками и данными, чтобы создать специального агента.
• Deep Research – автономный исследовательский агент, который планирует, выполняет и обобщает многоэтапные исследовательские задачи для таких целей, как анализ рынка, комплексная юридическая экспертиза и обзор литературы.

Безопасность и рекомендации

Каждый агент работает в изолированной среде, которая защищена на уровне ОС. По умолчанию у изолированной среды нет ограничений на исходящий сетевой трафик. Вы можете ограничить или отключить доступ к сети с помощью белого списка.

Доступ к сети

По умолчанию у сред нет ограничений на исходящий сетевой трафик. Используйте список разрешенных ресурсов network, чтобы ограничить исходящий трафик определенными доменами или шаблонами с подстановочными знаками. Подробнее о белом списке сетей (AI Studio) и правилах для сетей (API)…

Внешние инструменты и API

Вы можете подключить внешние инструменты и API, чтобы расширить возможности агента. Используйте только инструменты из надежных источников и предоставляйте им минимально необходимые разрешения. Храните секреты в виде управляемых учетных данных и ссылайтесь на них по идентификатору, чтобы исходящий прокси-сервер внедрял их во время запроса и они никогда не раскрывались в песочнице. Агент может использовать любые учетные данные, к которым у него есть доступ, поэтому предоставляйте только те, которые вы готовы предоставить в полном объеме.

• Используйте сервисные аккаунты или ключи API с минимальными правами доступа.
• Предпочитайте токены с коротким сроком действия ключам с длинным сроком действия.
• Предоставляйте только те учетные данные, полный доступ к которым вы готовы предоставить.
• Регулярно меняйте учетные данные.

Типы учетных данных и операции по управлению ими описаны в разделе Учетные данные. Вы также можете задать заголовки непосредственно в правиле белого списка. Подробнее о конфигурации сети…

Контроль со стороны человека

Всегда проверяйте результаты (сгенерированный код, преобразования данных, изменения конфигурации) перед их развертыванием, особенно если они связаны с изменением данных или взаимодействием с внешними системами.

Цены

Управляемые агенты используют модель оплаты по мере использования на основе токенов модели Gemini и использования инструментов. Одно взаимодействие может запустить несколько циклов рассуждений, обычно потребляя от 100 000 до 3 000 000 токенов. Вычисления в среде не оплачиваются в период предварительной версии. Посмотрите оценку стоимости для каждой задачи. Управляемые агенты также доступны на бесплатном плане с ограничением частоты запросов и квотой на использование.

Ограничения

Ограничение	Описание
Срок действия среды	Среды удаляются навсегда через семь дней неактивности.
Отключение виртуальной машины	Чтобы экономить ресурсы, виртуальные машины отключаются после короткого периода бездействия. Следующий запрос восстанавливает состояние (с холодным запуском).
Предустановленное ПО	Среда на основе Ubuntu с Python 3.12 и Node.js 22. Подробнее о предустановленном ПО…
Максимальное количество агентов	Можно создать до 1000 управляемых агентов.

Платформы агентов

Вы также можете создавать агентов с помощью Gemini, используя следующие фреймворки и SDK:

• LangChain / LangGraph: создавайте сложные приложения с сохранением состояния и мультиагентные системы с помощью графовых структур.
• LlamaIndex: подключите агентов Gemini к своим частным данным для рабочих процессов с расширенным поиском по контексту.
• CrewAI – оркестратор автономных ИИ-агентов, которые могут работать вместе и играть роли.
• Vercel AI SDK позволяет создавать пользовательские интерфейсы и агентов на основе ИИ на JavaScript/TypeScript.
• Google ADK – это фреймворк с открытым исходным кодом для создания и координации совместимых ИИ-агентов.
• Antigravity SDK позволяет создавать автономных ИИ-агентов с помощью тех же инструментов, цикла агента и управления контекстом, которые используются в Google Antigravity. Программирование выполняется на языке Python.