Espace de travail et artefacts du Sandbox Agent (BETA)
Chaque sandbox dispose d'un espace de travail : le dossier où vivent les fichiers pendant un tour. Vous pouvez y uploader vos propres fichiers pour que l'agent les traite, et l'agent peut publier un fichier en artefact téléchargeable. Cette page fait partie de la fonctionnalité Sandbox Agent en BETA (vue d'ensemble).
Uploader des fichiers dans l'espace de travail
Depuis la conversation, vous pouvez uploader des fichiers dans l'espace de travail du sandbox. L'agent les retrouve ensuite via ses outils fichiers (read_file, filesystem) et peut les lire, les transformer ou en écrire de nouveaux.
Les uploads sont soumis à un quota : la taille cumulée des fichiers de l'espace de travail est limitée. Si vous atteignez le quota, l'interface vous l'indique — supprimez ou remplacez des fichiers, ou allégez ce que vous envoyez.
Rappel : l'espace de travail est éphémère. Il vit avec le sandbox (~10 minutes) et disparaît à son expiration. Pour conserver un résultat, publiez-le en artefact.
Publier un artefact
Quand l'agent (ou vous, via ses instructions) veut vous livrer un résultat, il utilise publish_artifact pour transformer un fichier de l'espace de travail en artefact téléchargeable. Un artefact :
- est téléchargeable depuis la conversation ;
- possède une date d'expiration : au-delà, il n'est plus disponible au téléchargement.
Récupérez donc vos artefacts importants avant leur expiration. Pour un livrable que vous voulez garder durablement, téléchargez-le et stockez-le de votre côté.
Bon à savoir
- Les fichiers uploadés et les artefacts sont propres à leur contexte de sandbox ; rien ne « fuit » vers un autre agent ou une autre conversation.
- Pour conserver un état de travail intermédiaire entre les étapes d'un même tour, l'agent peut aussi utiliser les checkpoints.
Étapes suivantes
- Outils de l'agent —
write_file,read_file,publish_artifact,checkpoint. - Conversations et tours — le cycle de vie d'un sandbox.
