> ## Documentation Index > Fetch the complete documentation index at: https://docs.enclave.ai/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg. > People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files. > Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it. # Sandboxes personnalisées > Créez une sandbox à partir d'un Dockerfile avec les langages et outils dont votre équipe a besoin, et lancez des sessions Research dessus. Research exécute les commandes dans la sandbox par défaut d'Enclave. Si votre équipe a besoin d'autres langages, d'autres outils ou d'une autre distribution Linux, un propriétaire ou un administrateur peut créer une **sandbox personnalisée** à partir d'un Dockerfile. Tous les membres de l'organisation peuvent ensuite lancer une session dessus. ## Avant de commencer * Créer, reconstruire et supprimer une sandbox nécessite l'autorisation de gérer les intégrations : le rôle **Owner** ou **Admin**. Consultez [Rôles et autorisations](https://docs.enclave.ai/fr/admin/roles.md). * Les sandboxes personnalisées ne sont pas disponibles pour les déploiements [bring-your-own-cloud](https://docs.enclave.ai/fr/deployment/byoc.md). ## Créer une sandbox **1. Demandez à Research** Dans une [session Research](https://docs.enclave.ai/fr/research/sessions.md), décrivez ce dont vous avez besoin et donnez-lui un nom. Par exemple : « J'ai besoin d'une sandbox où l'agent peut exécuter jq et protoc. Appelle-la tools. » **2. Approuvez le Dockerfile** Research rédige un Dockerfile et affiche une carte **Create the sandbox tools?** avec l'image de base et le Dockerfile. Relisez-le et cliquez sur **Approve**. **3. Suivez la construction** Une carte de construction affiche le statut (**Queued**, **Building**, **Testing**, **Ready**, **Build failed** ou **Cancelled**), le temps écoulé et le journal de construction. Cliquez sur **Cancel** pour l'arrêter. À la fin de la construction, la session reçoit le résultat et Research vous indique la marche à suivre. Si la construction a échoué, Research en explique la raison et peut proposer un Dockerfile corrigé. Vous recevez aussi une notification, pour être averti depuis n'importe quelle page. Une sandbox n'est enregistrée que si sa construction réussit. Une construction échouée ou annulée ne change rien pour les membres. Pour modifier une sandbox, demandez à Research de la mettre à jour en la désignant par son nom. Il affiche une carte **Update the sandbox**. La version actuelle reste utilisée jusqu'à ce que la nouvelle construction réussisse. ### Règles du Dockerfile * Le Dockerfile part de `enclave/base`, l'image de sandbox par défaut d'Enclave, sauf si vous avez besoin d'un autre système d'exploitation. Les autres images de base doivent provenir d'un registre public. * Il n'y a pas de contexte de construction. `COPY` et `ADD` ne peuvent pas lire de fichiers locaux, mais `ADD` peut télécharger une URL `http(s)` ou cloner un dépôt git. * Un Dockerfile peut faire jusqu'à 64 Ko et 100 instructions. * Une construction peut durer jusqu'à 30 minutes. ## Lancer une session sur une sandbox Dans une nouvelle session, cliquez sur le sélecteur de sandbox dans la zone de saisie et choisissez une sandbox sous **Sandbox environment**. **Enclave default** est la sandbox propre à Enclave. Une session conserve sa sandbox. Pour en utiliser une autre, lancez une nouvelle session. Une sandbox en cours de reconstruction affiche **Rebuilding** dans le sélecteur. Les nouvelles sessions utilisent sa dernière construction réussie jusqu'à ce que la nouvelle réussisse. ## Gérer les sandboxes Accédez à **Settings → Sandboxes** pour voir les sandboxes de votre organisation, leur statut (**Ready** ou **Rebuilding**) et la date de la construction utilisée. Les propriétaires et les administrateurs cliquent sur **Manage** pour voir le Dockerfile en vigueur et le journal de la dernière construction, et pour : * **Rebuild** : reconstruire la sandbox à partir de son Dockerfile. * **Cancel** : annuler une construction en cours. * **Delete** : supprimer la sandbox. Les sessions qui l'utilisent ne peuvent plus redémarrer leur sandbox et vous invitent à lancer une nouvelle session. Lorsqu'Enclave met à jour le logiciel de ses sandboxes, une sandbox personnalisée se reconstruit automatiquement la prochaine fois que quelqu'un lance une session dessus. D'ici là, les sessions utilisent la dernière construction réussie. ## Limites * 3 sandboxes par organisation. Une nouvelle sandbox dont la première construction est en cours compte dans la limite. * 20 constructions par organisation sur toute période de 24 heures. Les reconstructions lancées par Enclave après une mise à jour ne comptent pas. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.