Configuración del entorno en la nube

Los entornos definen la configuración del contenedor donde se ejecuta tu agente. Creas un entorno una vez y luego haces referencia a su ID cada vez que inicias una sesión. Múltiples sesiones pueden compartir el mismo entorno, pero cada sesión obtiene su propia instancia de contenedor aislada.

Crear un entorno

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

El name debe ser único dentro de tu organización y espacio de trabajo.

Usar el entorno en una sesión

Pasa el ID del entorno como una cadena al crear una sesión.

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

Opciones de configuración

Paquetes

El campo packages preinstala paquetes en el contenedor antes de que el agente se inicie. Los paquetes se instalan por sus respectivos gestores de paquetes y se almacenan en caché en todas las sesiones que comparten el mismo entorno. Cuando se especifican múltiples gestores de paquetes, se ejecutan en orden alfabético (apt, cargo, gem, go, npm, pip). Opcionalmente puedes fijar versiones específicas; el valor predeterminado es la más reciente.

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

Gestores de paquetes soportados:

Redes

El campo networking controla el acceso a la red saliente del contenedor. No afecta los dominios permitidos de las herramientas web_search o web_fetch.

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

Cuando uses redes limited:

• allowed_hosts especifica los dominios que el contenedor puede alcanzar. Estos deben tener prefijo HTTPS.
• allow_mcp_servers permite el acceso saliente a los puntos finales del servidor MCP configurados en el agente, más allá de los enumerados en el array allowed_hosts. El valor predeterminado es false.
• allow_package_managers permite el acceso saliente a registros de paquetes públicos (PyPI, npm, etc.) más allá de los enumerados en el array allowed_hosts. El valor predeterminado es false.

Ciclo de vida del entorno

• Los entornos persisten hasta que se archiven o eliminen explícitamente.
• Múltiples sesiones pueden hacer referencia al mismo entorno.
• Cada sesión obtiene su propia instancia de contenedor. Las sesiones no comparten el estado del sistema de archivos.
• Los entornos no tienen versiones. Si actualizas frecuentemente tus entornos, es posible que desees registrar estas actualizaciones de tu lado para mapear el estado del entorno con las sesiones.

Gestionar entornos

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

Tiempos de ejecución preinstalados

Los contenedores en la nube incluyen tiempos de ejecución comunes listos para usar. Consulta Referencia de contenedor para la lista completa de lenguajes preinstalados, bases de datos y utilidades.