Outils de l'agent Sandbox (BETA)
Dans le sandbox, l'agent ne se contente pas de répondre : il appelle des outils pour agir. Pendant un tour, chaque appel d'outil s'affiche en direct dans l'interface. Cette page décrit les outils disponibles dans la fonctionnalité Sandbox Agent en BETA (vue d'ensemble).
Fichiers
write_file / read_file
Écrire un fichier dans l'espace de travail du sandbox, et le relire. C'est ainsi que l'agent produit du code, des données ou un livrable à publier ensuite en artefact.
filesystem
Explorer l'espace de travail : lister le contenu d'un dossier et obtenir des métadonnées de fichier (stat). Utile pour que l'agent se repère avant d'agir.
Exécution
run_code
Exécuter un extrait de code (dans le runtime de l'agent, Python ou Node) et récupérer sa sortie. Idéal pour un calcul ponctuel ou une vérification rapide.
terminal
Lancer des commandes shell dans le sandbox. L'agent peut installer une dépendance disponible, manipuler des fichiers, lancer des tests, etc.
python_context
Un espace de noms Python persistant entre les appels au sein d'un même sandbox : les variables et imports définis restent disponibles d'un appel à l'autre, comme dans un notebook. (Rappel : cet état disparaît dès l'expiration du sandbox — qui peut survenir bien avant les ~10 minutes qu'un tour obtient tant qu'il est activement en cours : une fois que l'agent a fini de travailler, le sandbox est libéré au bout de seulement ~2 minutes. Tout ce dont vous avez besoin de cet espace de noms doit être extrait — écrit dans un fichier et publié en artefact — avant la fin du tour, pas « à un moment avant l'expiration du sandbox ».)
Persistance et livrables
checkpoint
Créer, lister, restaurer et supprimer des checkpoints de l'état du système de fichiers. C'est le moyen de conserver un état intermédiaire et d'y revenir au cours d'un travail.
publish_artifact
Publier un fichier de l'espace de travail comme artefact téléchargeable (avec une date d'expiration). Voir espace de travail et artefacts.
Web
web_search
Statut : `web_search` pas encore activé. Cette fonctionnalité privée reste indisponible pendant la validation des contrôles de sécurité, de coût et de reprise.
Recherche sur le web public. Les résultats sont normalisés (titre, URL, extrait) et bornés en taille.
À l'ouverture, les plafonds resteront 1 recherche par tour, et par compte 3 par tranche de 5 h et 6 par semaine en Dev, 5 et 12 en Pro. Une recherche décomptée reste décomptée même si le fournisseur répond en erreur ou expire — le plafond protège votre offre, il ne rembourse pas les tentatives.
web_fetch
Statut : `web_fetch` pas encore activé. Cet outil n'est ouvert sur aucun compte. Il est décrit ici parce qu'il fait partie de la fonctionnalité, pas parce qu'il est disponible.
Récupérer le contenu d'une page publique autorisée. L'accès est protégé contre le SSRF (seules les cibles autorisées sont atteignables) et l'outil peut demander une confirmation avant de récupérer une page.
Étapes suivantes
- Conversations et tours — voir les appels d'outils en streaming.
- Espace de travail et artefacts — uploader des fichiers, publier des livrables.