Configuração do ambiente em nuvem

Os ambientes definem a configuração do contêiner onde seu agente é executado. Você cria um ambiente uma vez e, em seguida, referencia seu ID cada vez que inicia uma sessão. Múltiplas sessões podem compartilhar o mesmo ambiente, mas cada sessão obtém sua própria instância de contêiner isolada.

Criar um ambiente

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

O name deve ser único dentro da sua organização e espaço de trabalho.

Usar o ambiente em uma sessão

Passe o ID do ambiente como uma string ao criar uma sessão.

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
)

Opções de configuração

Pacotes

O campo packages pré-instala pacotes no contêiner antes do agente iniciar. Os pacotes são instalados pelos seus respectivos gerenciadores de pacotes e armazenados em cache entre sessões que compartilham o mesmo ambiente. Quando múltiplos gerenciadores de pacotes são especificados, eles são executados em ordem alfabética (apt, cargo, gem, go, npm, pip). Você pode opcionalmente fixar versões específicas; o padrão é a versão mais recente.

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

Gerenciadores de pacotes suportados:

Rede

O campo networking controla o acesso à rede de saída do contêiner. Ele não afeta os domínios permitidos das ferramentas web_search ou web_fetch.

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

Ao usar rede limited:

• allowed_hosts especifica os domínios que o contêiner pode acessar. Estes devem ter prefixo HTTPS.
• allow_mcp_servers permite acesso de saída aos endpoints do servidor MCP configurados no agente, além daqueles listados no array allowed_hosts. O padrão é false.
• allow_package_managers permite acesso de saída a registros de pacotes públicos (PyPI, npm, etc.) além daqueles listados no array allowed_hosts. O padrão é false.

Ciclo de vida do ambiente

• Os ambientes persistem até serem explicitamente arquivados ou excluídos.
• Múltiplas sessões podem referenciar o mesmo ambiente.
• Cada sessão obtém sua própria instância de contêiner. As sessões não compartilham o estado do sistema de arquivos.
• Os ambientes não são versionados. Se você atualiza seus ambientes com frequência, pode ser interessante registrar essas atualizações do seu lado, para mapear o estado do ambiente com as sessões.

Gerenciar ambientes

# 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"

Runtimes pré-instalados

Os contêineres em nuvem incluem runtimes comuns prontos para uso. Consulte a Referência de contêineres para a lista completa de linguagens, bancos de dados e utilitários pré-instalados.