Управляемые агенты в Gemini API – это настраиваемый каркас агента. Один вызов API создает изолированную среду Linux, в которой агент может рассуждать, выполнять код, управлять файлами и автономно просматривать веб-страницы.
Краткое руководство
Как совершить первый звонок агенту, передать ответы и создать собственного агента.
Агент Antigravity
Возможности, инструменты, мультимодальный ввод и цены для агента по умолчанию.
Агенты в AI Studio
Визуальная среда для создания прототипов агентов без написания кода.
Доступные управляемые агенты
- Агент Antigravity – универсальный управляемый агент общего назначения, созданный на основе Gemini 3.8 Flash. Выполняет код, управляет файлами и ищет информацию в интернете в безопасной среде Linux, размещенной в Google. Вы можете настроить базовую модель (например, Gemini 3.6 Flash или Gemini 3.5 Flash-Lite), используя
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.