Google AI Studio Playground предоставляет визуальный интерфейс для создания прототипов и обучения разработке управляемых агентов без необходимости создания и написания вызовов API.
Для начала перейдите на вкладку «Playground» в панели навигации Google AI Studio и переключите тумблер в положение «Agents» .
Готовые шаблоны
Вкладка «Агенты» содержит ряд шаблонов, которые предварительно настраивают базового агента Antigravity Agent, устанавливая параметры инструментов и среды. Все шаблоны являются открытым исходным кодом и опубликованы в репозитории google-gemini/gemini-managed-agents-templates . Изучение этих шаблонов — отличный способ научиться создавать и структурировать собственного управляемого агента.
Например, при выборе шаблона AI Radio активируются все разрешенные инструменты, а также подключается специализированный файл AGENTS.md и навыки для создания радиопередач. Эти настройки можно просмотреть в пользовательском интерфейсе Playground в разделе «Окружение» , нажав кнопку «Источники» .
Настройка инструмента
В настройках агента в тестовой среде можно включить или выключить доступ к следующим встроенным инструментам:
- Поиск Google: доступ к открытому интернету для получения актуальной информации в режиме реального времени.
- Контекст URL: Получение и анализ текстового содержимого URL-адресов конкретных веб-страниц.
- Выполнение кода: Запускайте команды Bash и Python непосредственно в изолированной среде песочницы.
- Инструменты файловой системы: чтение, запись, отображение списка и удаление файлов в рабочей области.
Конфигурация среды
Управляемые агенты работают в защищенной, временной среде Linux (песочнице), которая предоставляет им рабочее пространство и инструменты, необходимые для работы. Для получения дополнительной информации см. руководство по среде управляемых агентов .
Поведение управляющего агента
Поведение, личные качества и возможности агента в основном определяются файлами, находящимися в его окружении. Агент автоматически обнаруживает и загружает конфигурации из специальной папки .agents :
-
AGENTS.md: Предварительно загружается в контекст агента для определения системных инструкций и характеристик пользователя. -
SKILL.md: Находится в соответствующих папках навыков (например,.agents/skills/my-skill/SKILL.md) и определяет конкретные возможности и рабочие процессы.
Обеспечение окружающей среды
Вы можете настроить среду, используемую агентом, смонтировав файлы в эту среду перед началом сеанса. Вы можете либо создать новую среду, смонтировав исходные файлы, либо восстановить предыдущую:
- Чтобы создать новую среду , нажмите «Добавить источники» на панели настроек среды и выберите один из следующих типов источников:
| Тип источника | Описание | Путь монтажа |
|---|---|---|
| Встроенные файлы | Вставляйте или копируйте файлы конфигурации, фиктивные наборы данных или вспомогательные скрипты (до 100 КБ) непосредственно в пользовательский интерфейс Playground. | Путь назначения, заданный пользователем (например, /workspace/scripts/parser.py ). |
| Google Облачное хранилище | Подключите общедоступное хранилище Cloud Storage. | Сопоставляет путь к корзине GCS (например, gs://your-bucket-name/data/ ) с каталогом рабочей области (например, /workspace/data/ ). |
| Репозитории GitHub | Клонируйте общедоступные или частные кодовые базы. Для частных репозиториев требуется персональный токен доступа: https://<YOUR_TOKEN>@github.com/username/repo.git . | Клонируется непосредственно в /workspace/ (обычно в /workspace/<repo-name> ). |
- Для восстановления предыдущей среды можно использовать существующий идентификатор среды , чтобы клонировать и создать форк ее точного состояния.
Повторное использование существующего идентификатора среды
Если вы уже потратили время на настройку тестовой среды, вам не нужно начинать с нуля. Чтобы использовать существующую среду:
- Перейдите в панель «Окружения» в AI Studio и измените параметр «Тип» на «Существующие».
- Введите идентификатор среды (например,
env_abc123).
Для получения дополнительной информации см. раздел «Настройка среды» . Вы также можете получить идентификатор среды текущей сессии на вкладке «Среда» в пользовательском интерфейсе.
После отправки первого сообщения агенту конфигурация среды фиксируется на этот сеанс. Вы не можете монтировать новые источники или изменять список разрешенных сетевых ресурсов, пока взаимодействие активно выполняется.
Загрузите окружающую среду
После создания среды вы можете в любое время загрузить снимок среды, используя кнопку «Загрузить» в настройках среды в AI Studio Playground, чтобы получить файлы среды в виде архива tarball.
Безопасность и управление затратами
Управление потреблением токенов
В отличие от стандартного запроса в чате, который выдает один результат, Antigravity Agent выполняет автономный рабочий процесс. Он планирует, запускает код, отслеживает результаты и итеративно повторяет действия. Это означает, что один запрос может привести к неограниченному потреблению токенов.
Для управления затратами указывайте четкие критерии завершения в своих подсказках и узко определяйте задачи для агента . Хорошим примером может быть подсказка типа : «Проверьте запрос на слияние и остановитесь, как только сгенерируете сводку в формате Markdown. Не пытайтесь написать исправление самостоятельно» .
Дополнительные расходы
По умолчанию все шаблоны агентов в Playground имеют доступ к сервису Gemini API и могут выполнять вызовы API из среды для обработки запросов. Это может повлечь за собой дополнительные расходы, которые не будут отражены в потреблении токенов.
Аналогичным образом, если вы добавите другие внешние услуги, агент может понести дополнительные расходы, обращаясь к этим услугам от вашего имени.
Список разрешенных сетей
По умолчанию в AI Studio все исходящие сетевые запросы из изолированной среды вашего агента строго контролируются и ограничиваются для обеспечения безопасности. Чтобы предоставить вашему агенту возможность доступа к внешним API, веб-сервисам или менеджерам пакетов, необходимо явно их объявить:
- Перейдите в панель «Окружения» в AI Studio.
- Выберите кнопку «Правила» рядом с пунктом «Сеть» .
- В панели настроек сети нажмите «Добавить в список разрешенных» и заполните соответствующие поля:
- Ограничение по доменам: Доступ к виртуальному автомобилю агента возможен только для определенных доменов или шаблонов с подстановочными знаками, добавленных в список. Например, вы можете ввести точные домены, такие как
api.github.com, или общие шаблоны, такие как*.googleapis.com. - Добавление HTTP-заголовка и внедрение токена: используйте параметр «Добавить HTTP-заголовок» для безопасного внедрения необходимых учетных данных (например, токена API) для определенного домена. Эти учетные данные безопасно передаются через исходящий прокси-сервер и никогда не отображаются напрямую в виде необработанного текста внутри песочницы агента.
- Ограничение по доменам: Доступ к виртуальному автомобилю агента возможен только для определенных доменов или шаблонов с подстановочными знаками, добавленных в список. Например, вы можете ввести точные домены, такие как
Всегда проявляйте осторожность при добавлении доменов в список разрешенных. Предоставление агенту доступа к аутентифицированным службам означает, что он может действовать от вашего имени, что может привести к непредвиденным последствиям, если не контролировать ситуацию должным образом.
лучшие практики в области подтверждения квалификации
Если ваш рабочий процесс требует аутентификации агента во внешних сервисах, вы несете ответственность за предоставление и определение области действия этих учетных данных. Следуйте этим рекомендациям, чтобы снизить риски:
- Используйте учетные данные с минимальными привилегиями: создавайте учетные записи служб или ключи API только с теми разрешениями, которые необходимы вашему агенту. Избегайте передачи учетных данных с широкими или административными правами доступа.
- Отдавайте предпочтение токенам с коротким сроком действия: по возможности используйте учетные данные или токены с ограниченным сроком действия, а не ключи API с длительным сроком действия.
- Предполагайте полный доступ: агент может использовать любые имеющиеся у него учетные данные для выполнения поставленной вами задачи. Предоставляйте только те учетные данные, полный объем доступа к которым вы готовы разрешить.
- Регулярно меняйте учетные данные: относитесь к учетным данным, предоставленным агенту, так же, как и к любым другим программным учетным данным; меняйте их по установленному графику.
Подключение внешних инструментов и API
Для расширения возможностей агента можно подключать внешние инструменты и API (например, серверы протокола контекста модели / MCP). При этом:
- Подключайте только инструменты из надежных источников. Вредоносный или плохо написанный инструмент может привести к утечке данных или выполнению непредусмотренных действий.
- Настройте инструменты с минимальными правами доступа, необходимыми для вашего сценария использования. Если инструмент поддерживает режим только для чтения, отдавайте предпочтение ему, если только запись не является строго необходимой.
- Перед подключением инструмента к источнику производственных данных протестируйте его на выборочных или синтетических данных, чтобы убедиться, что агент использует его должным образом.
Человеческий надзор
Агенты способны рассуждать, планировать и выполнять многоэтапные рабочие процессы с высокой степенью автономности. Хотя это и мощный инструмент, он также требует надлежащего контроля, особенно в задачах, которые изменяют данные или взаимодействуют с внешними системами.
Перед развертыванием всегда проверяйте критически важные результаты, такие как сгенерированный код, преобразования данных или изменения конфигурации.