Bagikan melalui

Tutorial: Mulai menggunakan Microsoft Dev Box MCP Server

Tutorial ini menunjukkan kepada Anda cara menggunakan Server Microsoft Dev Box Model Context Protocol (MCP) untuk mengelola kotak pengembangan Anda melalui agen AI. Anda belajar melakukan operasi dev box umum menggunakan perintah bahasa alami alih-alih menavigasi melalui beberapa antarmuka.

Dalam tutorial ini, Anda akan:

  • Hubungkan dengan sumber daya Dev Box Anda melalui agen AI
  • Mencantumkan dan menjelajahi proyek dan kotak pengembangan yang tersedia
  • Melakukan operasi dev box dasar menggunakan perintah percakapan
  • Verifikasi operasi Anda berhasil diselesaikan

Prasyarat

Sebelum memulai tutorial ini, pastikan Anda memiliki:

Persyaratan Detail lebih lanjut
Dev Box MCP Server terinstal Ikuti langkah-langkah penginstalan di repositori Dev Box MCP Server
Sumber daya Dev Box - Setidaknya satu proyek Dev Box dengan kumpulan sumber daya yang dikonfigurasi
- Kotak dev yang ada untuk dikelola (opsional tetapi direkomendasikan)
Authentication Masuk melalui Azure CLI, Visual Studio Code, atau Windows SSO
Memerlukan izin Peran Pengguna Dev Box atau yang lebih tinggi pada sumber daya Dev Box Anda

Langkah 1: Buka agen AI Anda dan uji konektivitas

Mulailah dengan membuka agen AI Anda dan menguji koneksi ke sumber daya Dev Box Anda.

  1. Buka GitHub Copilot Chat di IDE Anda (VISUAL Code atau Visual Studio)

  2. Uji koneksi McP Server dengan memasukkan perintah ini:

    List my Dev Box projects

  3. Verifikasi respons: Anda akan melihat daftar proyek yang dapat Anda akses. Jika Anda mendapatkan kesalahan, periksa apakah Anda diautentikasi melalui Azure CLI (az login) atau Windows SSO.

Output yang diharapkan: Daftar yang menunjukkan nama proyek, deskripsi, dan grup sumber daya Anda.

Langkah 2: Jelajahi lingkungan Dev Box Anda

Sekarang setelah Anda mengonfirmasi konektivitas, jelajahi sumber daya Dev Box Anda untuk memahami lingkungan Anda.

Lihat kotak pengembangan Anda di semua proyek:

Show me all my dev boxes

Dapatkan detail tentang proyek tertentu (ganti "YourProjectName" dengan nama proyek aktual):

Show me details about the YourProjectName project

Mencantumkan kumpulan kotak pengembangan yang tersedia dalam proyek:

What dev box pools are available in the YourProjectName project?

Output yang diharapkan: Informasi tentang kotak dev Anda termasuk nama, status (Berjalan, Dihentikan, dll.), proyek, dan konfigurasi kumpulan.

Langkah 3: Lakukan operasi dev box dasar

Berlatih tugas manajemen kotak dev umum menggunakan perintah bahasa alami.

Centang status kotak dev

Centang status kotak dev tertentu:

What's the status of my DevBoxName dev box?

Dapatkan informasi terperinci tentang kotak pengembangan:

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

Memulai atau menghentikan kotak pengembangan

Mulai kotak pengembangan yang dihentikan

Start my DevBoxName dev box

Hentikan kotak dev yang sedang berjalan:

Stop my DevBoxName dev box

Nota

Memulai dan menghentikan dev box adalah operasi jangka panjang yang mungkin memakan waktu beberapa menit untuk diselesaikan.

Bekerja dengan jadwal

Periksa jadwal matikan:

When is my DevBoxName dev box scheduled to shut down?

Tunda penonaktifan terjadwal:

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

Langkah 4: Verifikasi pekerjaan Anda

Konfirmasikan bahwa operasi Anda berhasil diselesaikan dengan memeriksa hasilnya.

Periksa status operasi untuk tugas yang berjalan lama:

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

Verifikasi perubahan status kotak dev:

Show me the current status of DevBoxName

Konfirmasi perubahan jadwal:

Show me the updated schedule for DevBoxName

Apa yang harus dicari:

  • Operasi harus menampilkan status "Berhasil" ketika selesai
  • Status daya kotak dev harus mencerminkan perintah mulai/hentikan Anda
  • Modifikasi jadwal harus terlihat dalam informasi jadwal

Langkah 5: Coba skenario tingkat lanjut (opsional)

Setelah Anda nyaman dengan operasi dasar, coba skenario yang lebih canggih ini:

Membuat kotak dev baru

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

Menerapkan kustomisasi

What customization tasks are available for my project?

Install the development tools customization on my FeatureWork dev box

Memantau kemajuan kustomisasi

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

Troubleshooting

Jika Anda mengalami masalah selama tutorial ini:

Masalah autentikasi

  • Verifikasi bahwa Anda masuk: az account show
  • Memeriksa izin Anda di portal Microsoft Azure
  • Coba keluar dan masuk kembali: az logout lalu az login

Kesalahan pendaftaran alat

  1. Tekan Ctrl+Shift+P (VS Code) atau Ctrl+Shift+P (Visual Studio)
  2. Jalankan MCP: Reset alat yang di-cache
  3. Mulai ulang IDE Anda

Kegagalan operasi

  • Periksa apakah nama kotak dev dan nama proyek sudah benar
  • Verifikasi bahwa Anda memiliki izin yang sesuai untuk operasi
  • Beberapa operasi mungkin membutuhkan waktu - memeriksa status operasi secara berkala

Membersihkan sumber daya (opsional)

Jika Anda membuat sumber daya pengujian selama tutorial ini:

Hapus kotak dev pengujian yang tidak lagi Anda perlukan:

Delete the FeatureWork dev box from DevelopmentProject

Berhenti menjalankan kotak dev untuk menghemat biaya:

Stop all my running dev boxes

Langkah selanjutnya

Sekarang setelah Anda menyelesaikan tutorial, Anda dapat:

  • Menjelajahi berbagai operasi yang didukung
  • Mengintegrasikan perintah Dev Box MCP Server ke dalam alur kerja pengembangan harian Anda
  • Bagikan perintah bahasa alami dengan tim Anda untuk operasi umum

Konten terkait

  • Last updated on