Настройка облачной среды

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

Создание среды

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

Параметр name должен быть уникальным в пределах вашей организации и рабочей области.

Использование среды в сеансе

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

session = client.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.

config = {
    "type": "cloud",
    "networking": {
        "type": "limited",
        "allowed_hosts": ["api.example.com"],
        "allow_mcp_servers": True,
        "allow_package_managers": True,
    },
}

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

• allowed_hosts указывает домены, к которым может получить доступ контейнер. Они должны быть с префиксом HTTPS.
• allow_mcp_servers разрешает исходящий доступ к конечным точкам MCP-сервера, настроенным на агенте, помимо тех, которые указаны в массиве allowed_hosts. По умолчанию false.
• allow_package_managers разрешает исходящий доступ к общедоступным реестрам пакетов (PyPI, npm и т. д.) помимо тех, которые указаны в массиве allowed_hosts. По умолчанию false.

Жизненный цикл среды

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

Управление средами

# List environments
ant beta:environments list

# Retrieve a specific environment
ant beta:environments retrieve --environment-id "$ENVIRONMENT_ID"

# Archive an environment (read-only, existing sessions continue)
ant beta:environments archive --environment-id "$ENVIRONMENT_ID"

# Delete an environment (only if no sessions reference it)
ant beta:environments delete --environment-id "$ENVIRONMENT_ID"

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

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