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 conteneur Linux neuf).

Cette page couvre les environnements 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



Paquets

Le champ packages préinstalle des paquets dans le sandbox avant le démarrage de l'agent. Les paquets sont installés par leurs gestionnaires de paquets respectifs et mis en cache entre les sessions qui partagent le même environnement. Lorsque plusieurs gestionnaires de paquets sont spécifiés, ils s'exécutent dans l'ordre alphabétique (apt, cargo, gem, go, npm, pip). Vous pouvez éventuellement épingler des versions spécifiques. Les paquets 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 paquets 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ôte simples ou des motifs avec caractères génériques (comme *.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 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 paquets publics (comme 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 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 n'y fait référence)
ant beta:environments delete --environment-id "$ENVIRONMENT_ID"



Environnements d'exécution préinstallés

Les sandboxes cloud incluent des environnements d'exécution 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