Condividi tramite

Esercitazione: Introduzione a Microsoft Dev Box MCP Server

Questa esercitazione illustra come usare il server MCP (Microsoft Dev Box Model Context Protocol) per gestire le caselle di sviluppo tramite agenti di intelligenza artificiale. Si apprenderà a eseguire operazioni comuni di dev box usando i comandi del linguaggio naturale anziché spostarsi tra più interfacce.

In questa esercitazione si apprenderà come:

  • Connettersi alle risorse di Dev Box tramite un agente di intelligenza artificiale
  • Elencare ed esplorare i progetti e le caselle di sviluppo disponibili
  • Eseguire operazioni dev box di base usando comandi di conversazione
  • Verificare che le operazioni siano state completate correttamente

Prerequisiti

Prima di iniziare questa esercitazione, assicurarsi di disporre di:

Requisito Dettagli
Dev Box MCP Server installato Seguire i passaggi di installazione nel repository di Dev Box MCP Server
Risorse di Dev Box - Almeno un progetto Dev Box con un pool configurato
- Caselle di sviluppo esistenti da gestire (facoltativo ma consigliato)
Autenticazione Accesso tramite l'interfaccia della riga di comando di Azure, Visual Studio Code o Windows SSO
Autorizzazioni necessarie Ruolo utente di Dev Box o versione successiva nelle risorse di Dev Box

Passaggio 1: Aprire l'agente di intelligenza artificiale e testare la connettività

Per iniziare, aprire l'agente di intelligenza artificiale e testare la connessione alle risorse di Dev Box.

  1. Aprire GitHub Copilot Chat nell'IDE (VS Code o Visual Studio)

  2. Testare la connessione al server MCP immettendo questa richiesta:

    List my Dev Box projects

  3. Verificare la risposta: dovrebbe essere visualizzato un elenco di progetti a cui si ha accesso. Se viene visualizzato un errore, verificare di essere autenticati tramite l'interfaccia della riga di comando di Azure (az login) o Windows SSO.

Output previsto: elenco che mostra i nomi, le descrizioni e i gruppi di risorse del progetto.

Passaggio 2: Esplorare l'ambiente Dev Box

Dopo aver confermato la connettività, esplorare le risorse di Dev Box per comprendere l'ambiente.

Visualizzare le finestre di sviluppo in tutti i progetti:

Show me all my dev boxes

Ottenere informazioni dettagliate su un progetto specifico (sostituire "YourProjectName" con un nome di progetto effettivo):

Show me details about the YourProjectName project

Elencare i pool di box di sviluppo disponibili in un progetto:

What dev box pools are available in the YourProjectName project?

Output previsto: informazioni sulle macchine di sviluppo, inclusi nomi, stato (in esecuzione, arrestato e così via), progetti e configurazioni del pool.

Passaggio 3: Eseguire operazioni di base della finestra di sviluppo

Praticare attività comuni di gestione di dev box usando i comandi del linguaggio naturale.

Selezionare lo stato della casella di sviluppo

Selezionare lo stato di una casella di sviluppo specifica:

What's the status of my DevBoxName dev box?

Ottenere informazioni dettagliate su una casella di sviluppo:

Show me detailed information about DevBoxName including its configuration and current state

Avviare o arrestare una finestra di sviluppo

Avviare una finestra di sviluppo arrestata:

Start my DevBoxName dev box

Arrestare una finestra di sviluppo in esecuzione:

Stop my DevBoxName dev box

Annotazioni

L'avvio e l'arresto degli ambienti di sviluppo sono operazioni di lunga durata che potrebbero richiedere alcuni minuti.

Usare le pianificazioni

Controllare le pianificazioni di arresto:

When is my DevBoxName dev box scheduled to shut down?

Ritardare un arresto pianificato:

Delay the shutdown of my DevBoxName dev box until 6 PM today

Passaggio 4: Verificare il lavoro

Verificare che le operazioni siano state completate controllando i risultati.

Controllare lo stato dell'operazione per le attività a esecuzione prolungata:

What's the status of the operation I just started?

Verificare le modifiche apportate allo stato della casella di sviluppo:

Show me the current status of DevBoxName

Confermare le modifiche alla pianificazione:

Show me the updated schedule for DevBoxName

Cosa cercare:

  • Al termine delle operazioni dovrebbe essere visualizzato lo stato "Succeeded"
  • Gli stati di alimentazione di Dev Box devono riflettere i comandi di avvio/arresto
  • Le modifiche della pianificazione devono essere visibili nelle informazioni sulla pianificazione

Passaggio 5: Provare scenari avanzati (facoltativo)

Dopo aver familiarità con le operazioni di base, provare questi scenari più avanzati:

Creare una nuova casella di sviluppo

Create a new dev box called "FeatureWork" in the DevelopmentProject using the StandardPool

Applicazione delle personalizzazioni

What customization tasks are available for my project?

Install the development tools customization on my FeatureWork dev box

Monitorare lo stato di avanzamento della personalizzazione

What's the status of the customization running on my FeatureWork dev box?

Risoluzione dei problemi

Se si verificano problemi durante questa esercitazione:

Problemi di autenticazione

  • Verificare di aver eseguito l'accesso: az account show
  • Controllare le autorizzazioni nel portale di Azure
  • Provare a disconnettersi e a riconnettersi: az logout quindi az login

Errori di registrazione degli strumenti

  1. Premere Ctrl+Shift+P (VS Code) o Ctrl+Shift+P (Visual Studio)
  2. Eseguire MCP: Reimpostare gli strumenti memorizzati nella cache
  3. Riavviare l'IDE

Errori dell'operazione

  • Verificare che i nomi delle caselle di sviluppo e i nomi dei progetti siano corretti
  • Verificare di disporre delle autorizzazioni appropriate per l'operazione
  • Alcune operazioni potrebbero richiedere tempo: controllare periodicamente lo stato dell'operazione

Pulire le risorse (facoltativo)

Se durante questa esercitazione sono state create risorse di test:

Eliminare le caselle di sviluppo di test che non sono più necessarie:

Delete the FeatureWork dev box from DevelopmentProject

Interrompere l'esecuzione di dev box per risparmiare sui costi:

Stop all my running dev boxes

Passaggi successivi

Dopo aver completato l'esercitazione, è possibile:

  • Esplorare l'intera gamma di operazioni supportate
  • Integrare i comandi di Dev Box MCP Server nel flusso di lavoro di sviluppo giornaliero
  • Condividere i comandi del linguaggio naturale con il team per le operazioni comuni

Contenuti correlati

  • Last updated on