Prérequis
Avant de commencer, vous devez disposer des éléments suivants :- Un jeton d’accès à l’API CoreWeave avec l’action
SANDBOX_USER. - Une clé API Meta donnant accès à Muse Code.
- L’URL d’un dépôt public que la sandbox peut cloner. Pour les dépôts privés, des identifiants d’authentification Git doivent être disponibles dans la sandbox.
- Python 3.11 ou version ultérieure avec
uv, ou Node.js 22 ou version ultérieure avecnpm.
[API-ACCESS-TOKEN] par votre jeton d’accès à l’API CoreWeave et [META-API-KEY] par votre clé API Meta :
Installer le client Sandboxes
Choisissez un langage et préparez un projet local :- Python
- TypeScript
Exécuter une tâche dans la sandbox
Enregistrez le script correspondant à votre langage sous le nom de fichier indiqué. Chaque script crée une sandbox sans serveur dotée d’une durée de vie maximale de 30 minutes et effectue les étapes suivantes :- Installe Muse Code à l’aide du programme d’installation de Meta.
- Clone votre dépôt dans le répertoire
/workspace/project. - Exécute
muse execpour compiler et tester une CLI de sparkline qui affiche des nombres sous forme de petit graphique. - Exécute indépendamment la CLI générée, vérifie sa sortie et enregistre le fichier
sparkline.mjsen local. - Arrête la sandbox dans un bloc
finally, y compris en cas d’échec de la configuration ou de l’exécution.
muse --version après l’installation.
L’exemple utilise --yolo pour désactiver les demandes d’approbation de Muse Code ainsi que la sandbox du système d’exploitation (OS), et pour accorder sa confiance au Workspace le temps de cette exécution. CoreWeave fournit la sandbox externe. Muse peut accéder aux fichiers, aux identifiants d’authentification et aux destinations réseau disponibles dans cette sandbox. Utilisez un dépôt de confiance et ne fournissez que les identifiants d’authentification nécessaires à la tâche. Pour plus d’informations, consultez Autorisations de Muse Code.
- Python
- TypeScript
run_muse.py
[REPOSITORY-URL] par l’URL de votre dépôt public, puis exécutez le script :
- Python
- TypeScript
sparkline.mjs généré dans le répertoire local de votre projet, puis arrête le sandbox. Si le fichier existe déjà localement, le script l’écrase. La vérification de la sortie s’exécute indépendamment du test propre à Muse et porte sur l’entrée de cet exemple. Pour une tâche plus conséquente, remplacez-la par des tests adaptés à vos exigences.
Ces exemples ne configurent pas de stockage persistant. Copiez les fichiers dont vous avez besoin hors du sandbox avant l’exécution du bloc finally. Voir opérations sur les fichiers et instantanés du système de fichiers.
Dépannage
Effectuez les vérifications suivantes pour résoudre les problèmes courants :- Si la création du sandbox échoue, vérifiez votre jeton d’accès à l’API CoreWeave et vos paramètres d’authentification.
- Si Muse Code signale une erreur d’authentification, vérifiez
META_API_KEYet la configuration de votre compte Meta. L’identifiant d’authentification du sandbox ne sert pas à authentifier les requêtes envoyées au modèle. - Si l’installation, le clonage ou les requêtes envoyées au modèle échouent, vérifiez l’accès sortant vers Meta et vers votre hébergeur Git. Ces exemples utilisent le placement sans serveur. Pour utiliser votre propre cluster CoreWeave Kubernetes Service (CKS), appliquez les paramètres client décrits dans Configurer le placement et la politique CKS. Vérifiez que la politique de l’exécuteur autorise le trafic sortant vers ces destinations.
- Si une tâche plus lourde dépasse le délai d’expiration, augmentez le délai d’expiration de la commande et la durée de vie du bac à sable avant de l’exécuter. La durée de vie de 30 minutes comprend le démarrage et l’installation. Voir délais d’expiration des commandes et cycle de vie du sandbox.
Étapes suivantes
Pour plus d’informations, consultez les guides suivants :- Shells interactifs et TTY explique comment accéder au terminal pour les agents interactifs.
- Exécuter des agents dans des sandboxes CoreWeave compare les intégrations d’agents et les options de Workspace.
- Le cookbook d’exécution en sandbox de Meta présente un flux de travail en trois temps (reproduire, corriger, vérifier) reposant sur une boucle d’outils personnalisée dans Docker.
- La documentation de Muse Code traite de la configuration de l’agent et d’autres flux de travail en CLI.