La sandbox du Studio IA
L'espace de travail derrière chaque projet Studio - la démarrer, la mettre en pause, la redémarrer, ce qui se passe quand elle reste inutilisée, et comment vos fichiers reviennent.
Chaque projet du Studio IA a une sandbox : un conteneur privé où l'assistant écrit des fichiers et lance des commandes, et d'où votre aperçu est servi. Cette page explique comment elle démarre et s'arrête, ce que la plateforme en fait quand personne ne s'en sert, et quoi faire quand elle échoue.
Ses états
La pastille à côté du nom du projet affiche toujours l'un de ces états :
| État | Ce que cela veut dire |
|---|---|
| Non démarrée | Le projet existe ; sa sandbox n'a jamais tourné. |
| Démarrage, Réveil | En train de démarrer. Quelques secondes en général. |
| En cours d'exécution | Prête. C'est le seul état facturé. |
| Mise en pause, En pause | Arrêtée, fichiers et processus conservés pour une reprise rapide. |
| En échec | Elle s'est arrêtée ou n'a pas pu démarrer. La raison est affichée au-dessus des panneaux. |
| Éteinte | Son conteneur a été supprimé. Vos fichiers sont conservés, sauf si vous les avez supprimés. |
Elle démarre toute seule
Ouvrir un projet démarre sa sandbox si elle est en pause, éteinte ou jamais démarrée. Vous n'avez rien à cliquer.
L'assistant fait de même. Si vous envoyez un message alors que la sandbox est éteinte ou en échec, il la démarre, attend qu'elle soit prête, puis poursuit votre demande. Dans ce cas, une sandbox en échec est reconstruite plutôt que réutilisée.
Le menu d'alimentation
L'icône d'alimentation en haut à droite d'un projet ouvre les commandes de la sandbox :
- Démarrer / Reprendre - la lancer. Affiché quand elle ne tourne pas.
- Mettre en veille - la mettre en pause. Les fichiers et les processus en cours reviennent à la reprise, et la facturation s'arrête.
- Redémarrer - reconstruire le conteneur autour de vos fichiers. À utiliser quand la sandbox a échoué ou ne répond plus. Vos fichiers ne sont pas touchés.
- Éteindre - supprimer le conteneur et conserver vos fichiers. Redémarrez-la quand vous voulez.
- Supprimer - supprimer le conteneur et tous les fichiers de l'espace de travail. Une confirmation est demandée, et c'est irréversible.
Pendant que la sandbox change d'état, le menu attend : les actions reviennent dès qu'elle est stabilisée.
Quand elle échoue
Une sandbox en échec affiche au-dessus des panneaux un bandeau avec la raison, en clair, et un bouton Redémarrer. Les raisons habituelles :
- Mémoire insuffisante. Une installation ou une compilation lourde a consommé plus que ce dont la sandbox dispose. Redémarrez-la ; si cela se reproduit, lancez des commandes plus légères.
- Arrêt inattendu. Vos fichiers sont intacts. Redémarrez-la.
- Démarrage trop long. Un nouveau démarrage suffit en général.
- La région est à pleine capacité. Toutes les machines réservées aux sandboxes sont occupées par des sandboxes en cours d'exécution. Réessayez un peu plus tard.
Le redémarrage règle la plupart des échecs parce qu'il ne réutilise pas le conteneur défaillant : il le supprime et en crée un neuf, sur l'image actuelle de la plateforme, monté sur les mêmes fichiers.
Ce qui se passe quand vous ne l'utilisez plus
Deux choses, à deux délais différents.
Après 15 minutes sans activité, elle est mise en pause. Rien n'est perdu ; elle reprend à votre retour, avec les processus qu'elle avait.
Après 6 heures sans activité, elle est retirée de sa machine. L'espace de travail est écrit dans une archive .zip, puis le conteneur et son stockage sont supprimés. La pastille indique Éteinte. À la prochaine ouverture du projet, une nouvelle sandbox est créée et l'archive y est décompressée avant toute autre chose : vos fichiers sont là où vous les aviez laissés.
Ce que l'archive ne contient pas, parce qu'une installation le reconstitue :
node_modules, les environnements virtuels Python (.venv, venv),
__pycache__, .cache et .next. Après une longue pause, attendez-vous à
relancer votre commande d'installation.
Les processus ne survivent pas non plus à cette étape. Un serveur de développement qui tournait doit être relancé : demandez-le à l'assistant, ou passez par l'onglet Journaux.
Mettre votre travail à l'abri
La sandbox est un endroit pour travailler, pas pour conserver. L'archive est un seul fichier sur une seule machine. Ce qui rend votre travail durable :
- Publier le projet, ce qui construit une image et la déploie.
- Connecter un dépôt Git et y pousser votre code.
- Télécharger le code (.zip) dans le menu du projet, qui vous donne tous les fichiers qu'une publication emporterait.
Les projets de l'agent DevOps sont différents
Un projet créé avec Déployer avec l'agent DevOps contient des dépôts clonés pour être lus et déployés, pas écrits. Sa sandbox n'est jamais archivée : le code est supprimé quand le travail se termine. Voir L'agent DevOps et votre code.