Udostępnij przez


Samouczek: rozpoczynanie pracy z serwerem MICROSOFT Dev Box MCP

W tym samouczku pokazano, jak używać serwera Microsoft Dev Box Model Context Protocol (MCP) do zarządzania skrzynkami deweloperskimi za pośrednictwem agentów sztucznej inteligencji. Nauczysz się wykonywać typowe operacje usługi Dev Box przy użyciu poleceń języka naturalnego zamiast przechodzić przez wiele interfejsów.

W tym samouczku wykonasz następujące elementy:

  • Nawiązywanie połączenia z zasobami usługi Dev Box za pośrednictwem agenta sztucznej inteligencji
  • Wyświetlanie listy i eksplorowanie dostępnych projektów i pól deweloperskich
  • Wykonywanie podstawowych operacji usługi Dev Box przy użyciu poleceń konwersacyjnych
  • Sprawdź, czy operacje zostały ukończone pomyślnie

Wymagania wstępne

Przed rozpoczęciem tego samouczka upewnij się, że masz następujące elementy:

Wymaganie Szczegóły
Zainstalowano serwer Dev Box MCP Wykonaj kroki instalacji w repozytorium serwera MCP usługi Dev Box
Zasoby usługi Dev Box — Co najmniej jeden projekt usługi Dev Box ze skonfigurowaną pulą
— Istniejące środowiska deweloperskie do zarządzania (opcjonalne, ale zalecane)
Uwierzytelnianie Zalogowano przez Azure CLI, Visual Studio Code lub Windows SSO
Wymagane uprawnienia Rola użytkownika usługi Dev Box lub nowsza w zasobach usługi Dev Box

Krok 1. Otwieranie agenta sztucznej inteligencji i testowanie łączności

Zacznij od otwarcia agenta sztucznej inteligencji i przetestowania połączenia z zasobami usługi Dev Box.

  1. Otwórz czat Copilot usługi GitHub w środowisku IDE (VS Code lub Visual Studio)

  2. Przetestuj połączenie z serwerem MCP , wprowadzając następujący monit:

    List my Dev Box projects
    
  3. Sprawdź odpowiedź: powinna zostać wyświetlona lista projektów, do których masz dostęp. Jeśli wystąpi błąd, sprawdź, czy jesteś uwierzytelniony za pomocą Azure CLI (az login) lub logowania jednokrotnego Windows SSO.

Oczekiwane dane wyjściowe: lista przedstawiająca nazwy projektu, opisy i grupy zasobów.

Krok 2. Eksplorowanie środowiska usługi Dev Box

Po potwierdzeniu łączności zapoznaj się z zasobami usługi Dev Box, aby zrozumieć środowisko.

Wyświetl pola deweloperskie we wszystkich projektach:

Show me all my dev boxes

Uzyskaj szczegółowe informacje o określonym projekcie (zastąp ciąg "YourProjectName" rzeczywistą nazwą projektu):

Show me details about the YourProjectName project

Lista dostępnych pul pól deweloperskich w projekcie:

What dev box pools are available in the YourProjectName project?

Oczekiwane dane wyjściowe: informacje o maszynach deweloperskich, w tym ich nazwy, stan (Uruchomione, Zatrzymane itp.), projekty i konfiguracje puli.

Krok 3. Wykonywanie podstawowych operacji usługi Dev Box

Przećwicz typowe zadania zarządzania skrzynkami deweloperskimi przy użyciu poleceń języka naturalnego.

Sprawdź stan dev boxa

Sprawdź stan określonego pola deweloperskiego:

What's the status of my DevBoxName dev box?

Uzyskaj szczegółowe informacje o polu deweloperskim:

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

Uruchamianie lub zatrzymywanie środowiska deweloperskiego

Uruchom zatrzymaną maszynę deweloperską:

Start my DevBoxName dev box

Zatrzymaj uruchomione środowisko deweloperskie

Stop my DevBoxName dev box

Uwaga / Notatka

Uruchamianie i zatrzymywanie pól deweloperskich to długotrwałe operacje, które mogą potrwać kilka minut.

Praca z harmonogramami

Sprawdź harmonogramy zamykania:

When is my DevBoxName dev box scheduled to shut down?

Opóźnij zaplanowane zamknięcie:

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

Krok 4. Weryfikowanie pracy

Upewnij się, że operacje zostały wykonane pomyślnie, sprawdzając wyniki.

Sprawdź stan operacji dla długotrwałych zadań:

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

Sprawdź zmiany stanu środowiska deweloperskiego:

Show me the current status of DevBoxName

Potwierdź zmiany harmonogramu:

Show me the updated schedule for DevBoxName

Czego szukać:

  • Operacje powinny pokazywać stan "Powodzenie" po zakończeniu
  • Stany zasilania usługi Dev Box powinny odzwierciedlać polecenia uruchamiania/zatrzymywania
  • Modyfikacje harmonogramu powinny być widoczne w informacjach o harmonogramie

Krok 5. Wypróbuj zaawansowane scenariusze (opcjonalnie)

Gdy opanujesz podstawowe operacje, wypróbuj te bardziej zaawansowane scenariusze.

Tworzenie nowego pola deweloperskiego

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

Stosowanie dostosowań

What customization tasks are available for my project?
Install the development tools customization on my FeatureWork dev box

Monitorowanie postępu dostosowywania

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

Rozwiązywanie problemów

Jeśli podczas tego samouczka wystąpią problemy:

Problemy z uwierzytelnianiem

  • Sprawdź, czy zalogowałeś się: az account show
  • Sprawdzanie uprawnień w witrynie Azure Portal
  • Spróbuj wylogować się i wrócić do: az logoutaz login

Błędy rejestracji narzędzi

  1. Naciśnij Ctrl+Shift+P (VS Code) lub Ctrl+Shift+P (Visual Studio)
  2. Uruchamianie programu MCP: resetowanie buforowanych narzędzi
  3. Ponowne uruchamianie środowiska IDE

Błędy operacji

  • Sprawdź, czy nazwy pól deweloperskich i nazwy projektów są poprawne
  • Sprawdź, czy masz odpowiednie uprawnienia do operacji
  • Niektóre operacje mogą zająć trochę czasu — okresowo sprawdzaj stan operacji

Czyszczenie zasobów (opcjonalnie)

Jeśli zasoby testowe zostały utworzone podczas tego samouczka:

Usuń pola deweloperskie testowe , których już nie potrzebujesz:

Delete the FeatureWork dev box from DevelopmentProject

Zatrzymaj uruchamianie pól deweloperskich , aby zaoszczędzić koszty:

Stop all my running dev boxes

Dalsze kroki

Po ukończeniu samouczka możesz wykonać następujące czynności:

  • Eksplorowanie pełnego zakresu obsługiwanych operacji
  • Integrowanie poleceń programu Dev Box MCP Server z codziennym przepływem pracy programowania
  • Udostępnianie poleceń języka naturalnego zespołowi na potrzeby typowych operacji