Skip to main content
Exécutez Muse Code dans une sandbox CoreWeave pour modifier des fichiers et lancer des commandes dans un Workspace distant. Ce guide utilise le kit de développement logiciel (SDK) Sandboxes pour installer l’interface en ligne de commande (CLI) et cloner un dépôt. Vous exécutez ensuite une tâche sans terminal interactif, puis récupérez le résultat avant d’arrêter la sandbox. Le processus de l’agent et le Workspace s’exécutent sur CoreWeave, tandis que les requêtes adressées au modèle sont envoyées à Meta.

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 avec npm.
Chargez vos identifiants d’authentification depuis votre gestionnaire de secrets dans l’environnement de votre terminal local. Remplacez [API-ACCESS-TOKEN] par votre jeton d’accès à l’API CoreWeave et [META-API-KEY] par votre clé API Meta :
Le script transmet la clé Meta via l’entrée standard afin qu’elle n’apparaisse ni dans les arguments de la commande ni dans la configuration du bac à sable. Pour un identifiant d’authentification partagé par l’équipe et injecté en tant que variable d’environnement lors de la création du sandbox, consultez Secrets Forge.

Installer le client Sandboxes

Choisissez un langage et préparez un projet local :

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 :
  1. Installe Muse Code à l’aide du programme d’installation de Meta.
  2. Clone votre dépôt dans le répertoire /workspace/project.
  3. Exécute muse exec pour compiler et tester une CLI de sparkline qui affiche des nombres sous forme de petit graphique.
  4. Exécute indépendamment la CLI générée, vérifie sa sortie et enregistre le fichier sparkline.mjs en local.
  5. Arrête la sandbox dans un bloc finally, y compris en cas d’échec de la configuration ou de l’exécution.
Ces exemples ont été testés avec Muse Code 1.3.0. Le programme d’installation pouvant installer une version plus récente, chaque script exécute 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.
run_muse.py
Dans le répertoire de votre projet local, remplacez [REPOSITORY-URL] par l’URL de votre dépôt public, puis exécutez le script :
Une fois l’installation terminée et la sortie de l’agent affichée, le script vérifie puis affiche la sparkline :
Le script enregistre le fichier 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_KEY et 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 :
Dernière modification le 15 octobre 2026