Настройка облачного окружения

Окружения определяют конфигурацию песочницы, в которой работает ваш агент. Вы создаёте окружение один раз, а затем ссылаетесь на его идентификатор каждый раз при запуске сессии. Несколько сессий могут использовать одно и то же окружение, но каждая сессия получает собственную изолированную песочницу (новый контейнер Linux).

На этой странице рассматриваются окружения с type: cloud. Чтобы запускать песочницы на собственной инфраструктуре, см. Самостоятельно размещаемые песочницы.



Создание окружения

ant beta:environments create \
  --name "python-dev" \
  --config '{type: cloud, networking: {type: unrestricted}}'

Используйте уникальное описательное значение name, чтобы различать окружения.



Использование окружения в сессии

Передайте идентификатор окружения в виде строки при создании сессии.

ant beta:sessions create \
  --agent "$AGENT_ID" \
  --environment-id "$ENVIRONMENT_ID"



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



Пакеты

Поле packages предварительно устанавливает пакеты в песочницу до запуска агента. Пакеты устанавливаются соответствующими менеджерами пакетов и кэшируются между сессиями, использующими одно и то же окружение. Если указано несколько менеджеров пакетов, они выполняются в алфавитном порядке (apt, cargo, gem, go, npm, pip). При желании вы можете закрепить конкретные версии. Пакеты без закреплённой версии устанавливаются в последней доступной версии.

ant beta:environments create <<'YAML'
name: data-analysis
config:
  type: cloud
  packages:
    pip:
      - pandas
      - numpy
      - scikit-learn
    npm:
      - express
  networking:
    type: unrestricted
YAML

Поддерживаемые менеджеры пакетов:



Сеть

Поле networking управляет исходящим сетевым доступом песочницы. Оно не влияет на разрешённые домены для инструментов web_search и web_fetch.

В следующем примере создаётся окружение с сетевым режимом limited:

ant beta:environments create <<'YAML'
name: api-access
config:
  type: cloud
  networking:
    type: limited
    allowed_hosts:
      - api.example.com
    allow_mcp_servers: true
    allow_package_managers: true
YAML

При использовании сетевого режима limited:

• allowed_hosts указывает домены, к которым песочница может обращаться. Указывайте простые имена хостов или шаблоны с подстановочными знаками (например, *.example.com). Не включайте схему URL, порт или путь.
• allow_mcp_servers разрешает исходящий доступ к конечным точкам серверов MCP, настроенным для агента, помимо тех, что перечислены в массиве allowed_hosts. По умолчанию — false.
• allow_package_managers разрешает исходящий доступ к публичным реестрам пакетов (таким как PyPI и npm) помимо тех, что перечислены в массиве allowed_hosts. По умолчанию — false.



Жизненный цикл окружения

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



Управление окружениями

# Вывести список окружений
ant beta:environments list

# Получить конкретное окружение
ant beta:environments retrieve --environment-id "$ENVIRONMENT_ID"

# Архивировать окружение (только чтение, существующие сессии продолжают работу)
ant beta:environments archive --environment-id "$ENVIRONMENT_ID"

# Удалить окружение (только если на него не ссылаются сессии)
ant beta:environments delete --environment-id "$ENVIRONMENT_ID"



Предустановленные среды выполнения

Облачные песочницы включают распространённые среды выполнения «из коробки». Полный список предустановленных языков, баз данных и утилит см. в Справочнике по облачным песочницам.



Дальнейшие шаги