Configuración del entorno en la nube

Los entornos definen la configuración del sandbox donde se ejecuta tu agente. Creas un entorno una vez y luego haces referencia a su ID cada vez que inicias una sesión. Varias sesiones pueden compartir el mismo entorno, pero cada sesión obtiene su propio sandbox aislado (un contenedor Linux nuevo).

Esta página cubre los entornos de type: cloud. Para ejecutar sandboxes en tu propia infraestructura, consulta Sandboxes autoalojados.



Crear un entorno

ant beta:environments create < python-dev.environment.yaml

name: python-dev
config:
  type: cloud
  networking:
    type: unrestricted

Usa un name único y descriptivo para poder distinguir los entornos entre sí.



Usar el entorno en una sesión

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

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



Opciones de configuración



Paquetes

El campo packages preinstala paquetes en el sandbox antes de que el agente se inicie. Los paquetes son instalados por sus respectivos gestores de paquetes y se almacenan en caché entre sesiones que comparten el mismo entorno. Cuando se especifican varios gestores de paquetes, se ejecutan en orden alfabético (apt, cargo, gem, go, npm, pip). Opcionalmente, puedes fijar versiones específicas. Los paquetes sin versión fijada instalan la versión más reciente.

ant beta:environments create < environment.yaml

name: data-analysis
config:
  type: cloud
  packages:
    pip:
      - pandas
      - numpy
      - scikit-learn
    npm:
      - express
  networking:
    type: unrestricted

Gestores de paquetes compatibles:



Redes

El campo networking controla el acceso de red saliente del sandbox. No afecta a las herramientas web_search ni web_fetch, que se ejecutan en los servidores de Anthropic; para restringir los sitios a los que esas herramientas pueden acceder, configura allowed_domains o blocked_domains en la entrada de la herramienta dentro del conjunto de herramientas del agente. Consulta Restringir dominios de búsqueda web y obtención web.

El siguiente ejemplo crea un entorno con redes limited:

ant beta:environments create < environment.yaml

name: api-access
config:
  type: cloud
  networking:
    type: limited
    allowed_hosts:
      - api.example.com
    allow_mcp_servers: true
    allow_package_managers: true

Al usar redes limited:

• allowed_hosts especifica los dominios a los que el sandbox puede acceder. Especifica nombres de host simples o patrones con comodines (como *.example.com). No incluyas un esquema de URL, puerto ni ruta.
• allow_mcp_servers permite el acceso saliente a los endpoints de servidores MCP configurados en el agente, más allá de los listados en el array allowed_hosts. El valor predeterminado es false.
• allow_package_managers permite el acceso saliente a registros públicos de paquetes (como PyPI y npm) más allá de los listados en el array allowed_hosts. El valor predeterminado es false.



Ciclo de vida del entorno

• Los entornos persisten hasta que se archivan o eliminan explícitamente.
• Cada sesión obtiene su propia instancia de sandbox, incluso cuando varias sesiones hacen referencia al mismo entorno. Las sesiones no comparten el estado del sistema de archivos.
• Los entornos no tienen control de versiones. Si actualizas un entorno con frecuencia, mantén tu propio registro de los cambios para poder identificar qué configuración usó cada sesión.



Gestionar entornos

# Listar entornos
ant beta:environments list

# Recuperar un entorno específico
ant beta:environments retrieve --environment-id "$ENVIRONMENT_ID"

# Archivar un entorno (solo lectura, las sesiones existentes continúan)
ant beta:environments archive --environment-id "$ENVIRONMENT_ID"

# Eliminar un entorno (solo si ninguna sesión lo referencia)
ant beta:environments delete --environment-id "$ENVIRONMENT_ID"



Runtimes preinstalados

Los sandboxes en la nube incluyen runtimes comunes listos para usar. Consulta Referencia de sandbox en la nube para ver la lista completa de lenguajes, bases de datos y utilidades preinstalados.



Próximos pasos