Menyambungkan agen cloud GitHub Copilot ke Server MCP Azure

Artikel ini memperlihatkan kepada Anda cara menyiapkan dan menyambungkan agen cloud GitHub Copilot ke Azure McP Server. Dengan menyambungkan agen cloud ke server, agen dapat memahami file khusus Azure dan sumber daya Azure Anda untuk mengedit file kode Anda.

Di repositori GitHub Anda, menetapkan issue GitHub kepada agen cloud GitHub Copilot akan membuat pull request yang berisi perubahan pada kode Anda. Jika perubahan yang diminta memerlukan akses ke sumber daya Azure Anda, agen cloud GitHub Copilot perlu menggunakan Azure MCP Server. Sebelum agen cloud GitHub Copilot dapat menggunakan Azure MCP Server untuk membuat perubahan pada proyek berbasis Azure Anda secara agenik, Anda perlu mengonfigurasi agen cloud GitHub Copilot dan memberinya izin yang tepat di Azure. Anda dapat mengonfigurasi semuanya secara manual, tetapi banyak langkah diotomatisasi dengan menggunakan azd dan coding-agent ekstensi. GitHub sekarang menggunakan nama yang ditampilkan "agen cloud Copilot" di antarmuka pengguna (UI), tetapi identifier ekstensi stabil tetap azure.coding-agent, dan perintah CLI tetap azd coding-agent ....

Prasyarat

  • Akun Azure dan akses ke langganan Azure. Untuk detail tentang cara menyiapkannya, lihat halaman harga untuk akun Azure.

  • Akun GitHub dan langganan GitHub Copilot. Untuk detail tentang cara menyiapkannya, lihat Membuat akun di GitHub dan Panduan Cepat untuk GitHub Copilot.

  • Klon lokal repositori GitHub yang ada. Karena artikel ini menjelaskan cara menyiapkan koneksi antara agen cloud GitHub Copilot dan Azure McP Server, repositori GitHub harus menyertakan skrip penyebaran ke Azure, seperti templat Bicep atau Terraform.

Mengonfigurasi repositori GitHub untuk menggunakan Azure MCP Server

azd Ekstensi coding-agent menyederhanakan langkah-langkah yang diperlukan untuk menyiapkan koneksi antara agen cloud GitHub Copilot dengan aman dan Azure MCP Server untuk langganan Azure Anda. Pertama, ini membuat akun di langganan Azure Anda dan menetapkannya peran dengan izin yang diperlukan. Kedua, ini menyediakan cuplikan JSON yang diperlukan untuk memperkenalkan Azure MCP Server ke agen cloud GitHub Copilot.

  1. Apabila azd belum terpasang, ikuti instruksi untuk memasangnya.

  2. Pada terminal, masuk ke salinan lokal repositori yang ingin Anda gunakan.

  3. Panggil coding-agent ekstensi untuk azd dengan menggunakan perintah azd coding-agent config.

  4. Selama penginstalan, Anda diminta untuk memilih:

    • Langganan Azure
    • repositori GitHub yang menggunakan agen cloud Copilot
    • Apakah Anda ingin membuat Identitas Terkelola Pengguna baru atau yang sudah ada
    • Lokasi Azure
    • Grup sumber daya Azure
    • Repositori GitHub tempat cabang baru akan dibuat yang berisi file penyiapan alur kerja GitHub Actions yang dihasilkan

    Saat memilih lokasi dan grup sumber daya, Anda mungkin ingin menggunakan lokasi target dan grup sumber daya yang sama dengan sumber daya Azure dalam aplikasi.

  5. Setelah beberapa saat, ekstensi coding-agent untuk azd membuat identitas terkelola yang ditetapkan pengguna (atau menggunakan yang sudah ada), memberikan peran kepadanya, menyimpan nilai identitas di environment repositori GitHub, serta membuat dan mendorong cabang yang berisi file penyiapan alur kerja GitHub Actions yang dihasilkan.

  6. Anda akan melihat pesan di konsol:

    (!)
(!) NOTE: Some tasks must still be completed, manually:
(!)

    Biasanya ada tiga tugas:

    • Gabungkan cabang yang berisi file persiapan alur kerja GitHub Actions yang dihasilkan.
    • Konfigurasikan peran identitas terkelola agen cloud Copilot di portal Azure. Secara bawaan, peran "Pembaca" secara otomatis ditetapkan. Namun, Anda mungkin ingin memberikan izin lain berdasarkan apa yang Anda inginkan untuk dilakukan agen cloud secara otonom.
    • Kunjungi tautan untuk menyiapkan konfigurasi MCP. Untuk masuk ke sana secara manual, di GitHub buka Pengaturan>Copilot>Konfigurasi MCP> dan tempelkan di cuplikan JSON yang disediakan. Berikut adalah sebuah contoh:
    {
    "mcpServers": {
        "Azure": {
            "type": "local",
            "command": "npx",
            "args": [
                "-y",
                "@azure/mcp@latest",
                "server",
                "start"
            ],
            "tools": [
                "*"
            ]
        }
    }
}

  7. Terakhir, Anda dapat mengizinkan ekstensi coding-agent untuk azd membuka browser sehingga Anda dapat membuat pull request untuk menggabungkan cabang yang berisi file penyiapan alur kerja GitHub Actions yang dihasilkan.

Buat masalah di GitHub untuk memulai agen cloud GitHub Copilot

Pada tahap ini, Anda telah berhasil menyiapkan agen cloud GitHub Copilot untuk menggunakan Azure MCP Server pada issue GitHub yang Anda tetapkan ke agen cloud GitHub Copilot dan yang memerlukan pemahaman tentang deployment serta sumber daya Azure.

Misalnya, Anda ingin meningkatkan memori yang dialokasikan ke PostgreSQL saat disebarkan ke Azure Database for PostgreSQL. Anda akan membuat isu untuk mengubah templat Bicep Anda agar menggunakan level penyimpanan selanjutnya yang tersedia dan menugaskannya kepada GitHub Copilot.

Note

Peran Identitas Terkelola Pengguna diatur ke "Pembaca" secara default, sehingga perubahan yang Anda minta harus memodifikasi skrip penyebaran seperti templat Bicep atau Terraform. Meminta untuk memodifikasi sumber daya yang ada secara langsung di langganan Azure Anda tidak diizinkan karena izin dari peran "Reader".

  1. Di GitHub, di repositori yang berisi proyek berbasis Azure tempat Anda mengaktifkan Azure MCP Server, buka Masalah.

  2. Pilih tombol Masalah Baru . Jelaskan perubahan yang Anda inginkan GitHub Copilot agen cloud lakukan di bidang judul dan deskripsi. Pilih tombol Create.

    Meminjam dari contoh sebelumnya, Anda mungkin menggunakan teks berikut untuk menjelaskan masalah Anda.

    Title: Increase database storage

Currently, when deploying to Azure via Bicep, we're creating a PostgreSQL database with 32gb of storage. I need the next tier higher -- whatever that is.

    Contoh masalah ini membuat permintaan yang sederhana dan jelas meskipun pengguna tidak tahu persis apa yang mereka minta. Hal ini memungkinkan Azure MCP Server menelusuri informasi tentang tingkatan penyimpanan yang tersedia untuk Azure Database for PostgreSQL Flexible Server serta pengaturan dalam templat Bicep yang diperlukan untuk melakukan perubahan tersebut.

    Important

    Pastikan untuk menggunakan kata "Azure" dalam perintah Anda untuk memastikan bahwa GitHub Copilot meminta alat dari Azure MCP Server.

  3. Pilih tombol "Tetapkan ke Copilot" di bawah Assignees. Dialog "Tentukan Copilot ke isu" muncul yang memungkinkan Anda mengubah repository target, branch dasar, dan menambahkan perintah opsional. Pilih tombol "Tetapkan".

  4. Setelah masalah ditugaskan kepada agen cloud GitHub Copilot, Anda akan melihat tautan ke pull request yang diawali dengan "[WIP]" yang menunjukkan bahwa pengerjaan telah dimulai.

  5. Pilih tautan "[WIP]" untuk melihat pull request.

  6. Di isi permintaan pull, pilih tautan untuk melihat sesi pengodian. Ini menunjukkan kemajuan yang dibuat agen cloud Copilot atas permintaan, mirip dengan pengalaman dalam Visual Studio.

  7. Setelah selesai, GitHub Copilot agen cloud meminta peninjauan kode. Gunakan alur kerja normal Anda untuk melakukan iterasi dengan GitHub, memperlakukan agen cloud GitHub Copilot sebagai rekan kerja.

  8. Saat Anda menyetujui perubahan dan menggabungkan permintaan pull, GitHub Copilot menyelesaikan masalah asli yang Anda buat.

Konten terkait

  • Terakhir diperbarui pada