Configuration de l'environnement cloud

Les environnements définissent la configuration du conteneur dans lequel votre agent s'exécute. Vous créez un environnement une seule fois, puis 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 sa propre instance de conteneur isolée.

Créer un environnement

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

Le name doit être unique au sein de votre organisation et de votre espace de travail.

Utiliser l'environnement dans une session

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

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

Options de configuration

Packages

Le champ packages pré-installe des packages dans le conteneur 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 ; la valeur par défaut est 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 conteneur. Il n'affecte pas les domaines autorisés des outils web_search ou web_fetch.

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 que le conteneur peut atteindre. Ceux-ci doivent être préfixés par HTTPS.
• allow_mcp_servers autorise l'accès sortant aux points de terminaison du serveur 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 (PyPI, npm, etc.) au-delà de ceux listés dans le tableau allowed_hosts. La valeur par défaut est false.

Cycle de vie des environnements

• Les environnements persistent jusqu'à ce qu'ils soient explicitement archivés ou supprimés.
• Plusieurs sessions peuvent référencer le même environnement.
• Chaque session obtient sa propre instance de conteneur. Les sessions ne partagent pas l'état du système de fichiers.
• Les environnements ne sont pas versionnés. Si vous mettez fréquemment à jour vos environnements, vous pouvez enregistrer ces mises à jour de votre côté, afin de mapper l'état de l'environnement avec les sessions.

Gérer les environnements

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

Runtimes pré-installés

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