Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Ce tutoriel vous montre comment utiliser le serveur MCP (Microsoft Dev Box Model Context Protocol) pour gérer vos zones de développement via des agents IA. Vous apprenez à effectuer des opérations courantes de zone de développement à l’aide de commandes en langage naturel au lieu de naviguer dans plusieurs interfaces.
Dans ce didacticiel, vous allez :
- Se connecter à vos ressources Dev Box via un agent IA
- Répertorier et explorer vos projets et vos zones de développement disponibles
- Effectuer des opérations simples de boîte de développement à l’aide de commandes conversationnelles
- Vérifier que vos opérations se sont terminées correctement
Prerequisites
Avant de commencer ce tutoriel, vérifiez que vous disposez des points suivants :
| Requirement | Détails |
|---|---|
| Serveur MCP Dev Box installé | Suivez les étapes d’installation dans le référentiel dev Box MCP Server |
| Ressources Dev Box | - Au moins un projet Dev Box avec un pool configuré - Environnements de développement existants à gérer (facultatifs mais recommandés) |
| Authentification | Connecté grâce à Azure CLI, Visual Studio Code ou SSO Windows |
| Permissions requises | Rôle Utilisateur Dev Box ou un rôle supérieur sur vos ressources Dev Box |
Étape 1 : Ouvrir votre agent IA et tester la connectivité
Commencez par ouvrir votre agent IA et tester la connexion à vos ressources Dev Box.
Ouvrez GitHub Copilot Chat dans votre IDE (VS Code ou Visual Studio)
Testez la connexion du serveur MCP en entrant cette invite :
List my Dev Box projectsVérifiez la réponse : vous devez voir la liste des projets auquel vous avez accès. Si vous recevez une erreur, vérifiez que vous êtes authentifié via Azure CLI (
az login) ou l’authentification unique Windows.
Sortie attendue : liste montrant les noms, descriptions et groupes de ressources de votre projet.
Étape 2 : Explorer votre environnement Dev Box
Maintenant que vous avez confirmé la connectivité, explorez vos ressources Dev Box pour comprendre votre environnement.
Affichez vos dev boxes dans tous les projets :
Show me all my dev boxes
Obtenez des détails sur un projet spécifique (remplacez « YourProjectName » par un nom de projet réel) :
Show me details about the YourProjectName project
Répertorier les pools de boîtes de développement disponibles dans un projet :
What dev box pools are available in the YourProjectName project?
Sortie attendue : informations sur vos boîtes de développement, notamment leurs noms, leur état (En cours d'exécution, Arrêté, etc.), les projets et les configurations de pool.
Étape 3 : Effectuer des opérations de base sur l'environnement de développement
Pratiquez des tâches courantes de gestion des boîtes de développement à l’aide de commandes en langage naturel.
Vérifiez l'état de la boîte de développement
Cochez l’état d’une zone de développement spécifique :
What's the status of my DevBoxName dev box?
Obtenez des informations détaillées sur une zone de développement :
Show me detailed information about DevBoxName including its configuration and current state
Démarrer ou arrêter une boîte de développement
Démarrez une boîte de développement arrêtée :
Start my DevBoxName dev box
Arrêtez une boîte de développement en fonctionnement :
Stop my DevBoxName dev box
Note
Le démarrage et l’arrêt des environnements de développement sont des opérations prolongées qui peuvent prendre plusieurs minutes.
Utiliser des planifications
Vérifiez les planifications d’arrêt :
When is my DevBoxName dev box scheduled to shut down?
Retarder un arrêt planifié :
Delay the shutdown of my DevBoxName dev box until 6 PM today
Étape 4 : Vérifier votre travail
Vérifiez que vos opérations se sont terminées correctement en vérifiant les résultats.
Vérifiez l’état de l’opération pour les tâches de longue durée :
What's the status of the operation I just started?
Vérifiez les modifications de l’état de la boîte de développement :
Show me the current status of DevBoxName
Confirmer les modifications de planification :
Show me the updated schedule for DevBoxName
Éléments à rechercher :
- Les opérations doivent afficher l’état « Réussi » quand elles sont terminées
- Les états d’alimentation de la boîte de développement doivent refléter vos commandes start/stop
- Les modifications de planification doivent être visibles dans les informations de planification
Étape 5 : Essayer des scénarios avancés (facultatif)
Une fois que vous êtes à l’aise avec les opérations de base, essayez ces scénarios plus avancés :
Créer une boîte de développement
Create a new dev box called "FeatureWork" in the DevelopmentProject using the StandardPool
Appliquer les personnalisations
What customization tasks are available for my project?
Install the development tools customization on my FeatureWork dev box
Surveiller la progression de la personnalisation
What's the status of the customization running on my FeatureWork dev box?
Résolution des problèmes
Si vous rencontrez des problèmes pendant ce tutoriel :
Problèmes d’authentification
- Vérifiez que vous êtes connecté :
az account show - Vérifier vos autorisations dans le portail Azure
- Essayez de vous déconnecter et de vous reconnecter :
az logout, puisaz login
Erreurs d’enregistrement des outils
- Appuyez
Ctrl+Shift+Psur (VS Code) ouCtrl+Shift+P(Visual Studio) - Exécuter MCP : Réinitialiser les outils mis en cache
- Redémarrer votre IDE
Échecs d’opération
- Vérifiez que les noms des cases de développement et les noms de projet sont corrects
- Vérifiez que vous disposez des autorisations appropriées pour l’opération
- Certaines opérations peuvent prendre du temps : vérifier régulièrement l’état de l’opération
Nettoyez les ressources (facultatif)
Si vous avez créé des ressources de test pendant ce tutoriel :
Supprimez les zones de développement de test dont vous n’avez plus besoin :
Delete the FeatureWork dev box from DevelopmentProject
Arrêtez d’exécuter des dev box pour réduire les coûts :
Stop all my running dev boxes
Étapes suivantes
Maintenant que vous avez terminé le didacticiel, vous pouvez :
- Explorer la gamme complète d’opérations prises en charge
- Intégrer les commandes dev Box MCP Server à votre flux de travail de développement quotidien
- Partager des commandes en langage naturel avec votre équipe pour les opérations courantes