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

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

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



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

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

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



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

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

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"



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

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



Следующие шаги