Configuration de l'environnement cloud

Les environnements définissent la configuration du sandbox 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 traite des 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 \
  --name "python-dev" \
  --config '{type: cloud, networking: {type: unrestricted}}'

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



Utiliser l'environnement dans une session

Transmettez 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 <<'YAML'
name: data-analysis
config:
  type: cloud
  packages:
    pip:
      - pandas
      - numpy
      - scikit-learn
    npm:
      - express
  networking:
    type: unrestricted
YAML

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 domaines autorisés pour les outils web_search ou web_fetch.

L'exemple suivant crée un environnement avec un réseau limited :

ant beta:environments create <<'YAML'
name: api-access
config:
  type: cloud
  networking:
    type: limited
    allowed_hosts:
      - api.example.com
    allow_mcp_servers: true
    allow_package_managers: true
YAML

Lors de l'utilisation du réseau limited :

• allowed_hosts spécifie les domaines que le sandbox peut atteindre. 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 ni 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 répertorié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 répertorié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 identifier 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 n'y fait 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 obtenir la liste complète des langages, bases de données et utilitaires préinstallés.



Étapes suivantes