Configuration de l'environnement cloud

Les environnements définissent la configuration du « sandbox » (bac à sable) dans lequel votre agent s'exécute. Vous créez un environnement une seule fois, puis vous référencez son ID chaque fois que vous démarrez une session. Plusieurs sessions peuvent partager le même environnement, mais chaque session obtient son propre sandbox isolé (un nouveau conteneur Linux).

Cette page couvre les environnements de type: cloud. Pour exécuter des sandboxes sur votre propre infrastructure, consultez Sandboxes auto-hébergés.



Créer un environnement

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

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

Utilisez un name unique et descriptif afin de pouvoir distinguer les environnements.



Utiliser l'environnement dans une session

Passez l'ID de l'environnement sous forme de chaîne de caractères lors de la création d'une session.

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



Options de configuration



Packages

Le champ packages préinstalle des packages dans le sandbox avant le démarrage de l'agent. Les packages sont installés par leurs gestionnaires de packages respectifs et mis en cache entre les sessions qui partagent le même environnement. Lorsque plusieurs gestionnaires de packages sont spécifiés, ils s'exécutent par ordre alphabétique (apt, cargo, gem, go, npm, pip). Vous pouvez éventuellement épingler des versions spécifiques. Les packages non épinglés installent la dernière version.

ant beta:environments create < environment.yaml

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

Gestionnaires de packages pris en charge :



Réseau

Le champ networking contrôle l'accès réseau sortant du sandbox. Il n'affecte pas les outils web_search ou web_fetch, qui s'exécutent sur les serveurs d'Anthropic ; pour restreindre les sites auxquels ces outils peuvent accéder, définissez allowed_domains ou blocked_domains sur l'entrée de l'outil dans l'ensemble d'outils de l'agent. Consultez Restreindre les domaines de recherche web et de récupération web.

L'exemple suivant crée un environnement avec un réseau 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

Lors de l'utilisation du réseau limited :

• allowed_hosts spécifie les domaines auxquels le sandbox peut accéder. Spécifiez des noms d'hôtes simples ou des motifs avec caractères génériques (tels que *.example.com). N'incluez pas de schéma d'URL, de port ou de chemin.
• allow_mcp_servers autorise l'accès sortant aux points de terminaison des serveurs MCP configurés sur l'agent, au-delà de ceux listés dans le tableau allowed_hosts. La valeur par défaut est false.
• allow_package_managers autorise l'accès sortant aux registres de packages publics (tels que PyPI et npm) au-delà de ceux listés dans le tableau allowed_hosts. La valeur par défaut est false.



Cycle de vie de l'environnement

• Les environnements persistent jusqu'à ce qu'ils soient explicitement archivés ou supprimés.
• Chaque session obtient sa propre instance de sandbox, même lorsque plusieurs sessions référencent le même environnement. Les sessions ne partagent pas l'état du système de fichiers.
• Les environnements ne sont pas versionnés. Si vous mettez à jour un environnement fréquemment, conservez votre propre historique des modifications afin de pouvoir déterminer quelle configuration chaque session a utilisée.



Gérer les environnements

# Lister les environnements
ant beta:environments list

# Récupérer un environnement spécifique
ant beta:environments retrieve --environment-id "$ENVIRONMENT_ID"

# Archiver un environnement (lecture seule, les sessions existantes continuent)
ant beta:environments archive --environment-id "$ENVIRONMENT_ID"

# Supprimer un environnement (uniquement si aucune session ne le référence)
ant beta:environments delete --environment-id "$ENVIRONMENT_ID"



Runtimes préinstallés

Les sandboxes cloud incluent des runtimes courants prêts à l'emploi. Consultez la Référence des sandboxes cloud pour la liste complète des langages, bases de données et utilitaires préinstallés.



Prochaines étapes