Megosztás a következőn keresztül:

A GitHub Copilot kódolási ügynök csatlakoztatása az Azure MCP-kiszolgálóhoz

Ez a cikk bemutatja, hogyan állíthatja be és csatlakoztathatja a GitHub Copilot kódolási ügynököt az Azure MCP-kiszolgálóhoz, hogy a kódügynök megértse az Azure-specifikus fájlokat és Az Azure-erőforrásokat a kódfájlok szerkesztéséhez.

A GitHub-tárházban a GitHub-ügyek GitHub Copilot kódolási ügynökhöz való hozzárendelése létrehoz egy lekéréses kérelmet a kód módosításaival. Ha a kért módosításokhoz hozzáférésre van szükség az Azure-erőforrásokhoz, a GitHub Copilot kódolási ügynökének az Azure MCP-kiszolgálót kell használnia. Ahhoz, hogy a GitHub Copilot kódolási ügynök az Azure MCP-kiszolgálóval ügynökileg módosíthassa az Azure-alapú projektet, konfigurálnia kell a GitHub Copilot kódolási ügynököt, és meg kell adnia a megfelelő engedélyeket az Azure-ban. Manuálisan is konfigurálhat mindent, azonban számos lépés automatikusan használható az Azure Developer CLI és a azd bővítmény használatávalcoding-agent.

Előfeltételek

  • Egy Azure-fiók és egy Azure-előfizetéshez való hozzáférés. A beállításukkal kapcsolatos részletekért tekintse meg az Azure-fiókok díjszabási oldalát.

  • Egy GitHub-fiók és egy GitHub Copilot-előfizetés. A beállításukról további információt a Fiók létrehozása a GitHubon és a GitHub Copilot rövid útmutatója című témakörben talál.

  • Egy GitHub-adattár meglévő helyi klónja. Mivel ez a cikk bemutatja, hogyan állíthatja be a GitHub Copilot kódolási ügynöke és az Azure MCP-kiszolgáló közötti kapcsolatot, a GitHub-adattárnak tartalmaznia kell az Azure-ba irányuló üzembehelyezési szkripteket, például Bicep- vagy Terraform-sablonokat.

A GitHub-adattár konfigurálása az Azure MCP-kiszolgáló használatára

A azd kódolási ügynök bővítmény leegyszerűsíti a GitHub Copilot kódolási ügynök és az Azure-előfizetéshez tartozó Azure MCP-kiszolgáló közötti kapcsolat biztonságos beállításához szükséges lépéseket. Először létrehoz egy fiókot az Azure-előfizetésben, és hozzárendel egy szerepkört a szükséges engedélyekkel. Másodszor egy JSON-kódrészletet biztosít, amely szükséges ahhoz, hogy az Azure MCP-kiszolgálót a GitHub Copilot kódolási ügynökébe vezesse be.

  1. Ha még nem telepítette azd , a telepítéshez kövesse az utasításokat .

  2. A terminálban lépjen a használni kívánt adattár helyi klónjára.

  3. Hívja meg az azd kódolási ügynök bővítményt a következő paranccsal: azd coding-agent config.

  4. A telepítés során felkérik, hogy válassza ki a következőket:

    • Azure-előfizetés
    • Melyik GitHub-adattár fogja használni a Copilot Kódolási ügynököt
    • Akár új, akár meglévő felhasználó által felügyelt identitást szeretne létrehozni
    • Azure helyszín
    • Azure-erőforráscsoport
    • A GitHub-adattár, ahol létrejön egy új ág, amely tartalmazza a létrehozott GitHub Actions munkafolyamat-telepítőfájlt

    A hely és az erőforráscsoport kiválasztásakor érdemes lehet ugyanazt a célhelyet és erőforráscsoportot használni, mint az Azure-erőforrások az alkalmazásban.

  5. Néhány pillanat múlva a azd kódolási ügynök bővítmény létrehozza (vagy használja a meglévő) felhasználói felügyelt identitást, és hozzárendeli egy szerepkörhöz, az identitásértékeket a GitHub-adattárkörnyezetben tárolja, és létrehoz és leküld egy ágat, amely tartalmazza a létrehozott GitHub Actions-munkafolyamat beállítási fájlját.

  6. Megjelenik egy üzenet a konzolon:

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

    Általában három feladat van:

    • Egyesítse a létrehozott GitHub Actions munkafolyamat-telepítőfájlt tartalmazó ágat.
    • Konfigurálja a Copilot kódolási ügynök felügyelt identitásszerepköreit az Azure Portalon. Alapértelmezés szerint az "Olvasó" szerepkör van hozzárendelve. Előfordulhat azonban, hogy más engedélyeket is szeretne adni neki, attól függően, hogy mit szeretne a kódolási ügynök autonóm módon elvégezni.
    • Az MCP-konfiguráció beállításához látogasson el a hivatkozásra. Ha manuálisan szeretne ott navigálni, a GitHubon nyissa meg a Settings > Copilot > kódolási ügynök > MCP-konfigurációját, és illessze be a megadott JSON-kódrészletet. Íme egy példa:
    {
    "mcpServers": {
        "Azure": {
            "type": "local",
            "command": "npx",
            "args": [
                "-y",
                "@azure/mcp@latest",
                "server",
                "start"
            ],
            "tools": [
                "*"
            ]
        }
    }
}

  7. Végül engedélyezheti, hogy a azd kódolási ügynök bővítménye megnyissa a böngészőt, így létrehozhatja a lekéréses kérelmet a létrehozott GitHub Actions munkafolyamat-telepítőfájlt tartalmazó ág egyesítéséhez.

Probléma létrehozása a GitHubon a GitHub Copilot kódolási ügynök elindításához

Ezen a ponton sikeresen beállította a GitHub Copilot kódolási ügynökét, hogy az Azure MCP Servert használja a GitHub Copilot kódolási ügynökhöz hozzárendelt gitHub-problémákhoz, amelyekhez ismerni kell az Azure-üzemelő példányokat és erőforrásokat.

Tegyük fel például, hogy növelni szeretné a PostgreSQL-nek lefoglalt memóriát az Azure Database for PostgreSQL-ben való üzembe helyezéskor. Problémát okozna, ha módosítaná a Bicep-sablont a következő elérhető tárolási szint használatára, és hozzárendelné a GitHub Copilothoz.

Megjegyzés:

A felhasználói felügyelt identitás szerepkör alapértelmezés szerint "Olvasó" értékre van állítva, ezért a kért módosításoknak módosítaniuk kell az üzembehelyezési szkripteket, például a Bicep- vagy Terraform-sablonokat. Az Azure-előfizetés meglévő erőforrásainak közvetlen módosítására vonatkozó kérés nem engedélyezett az Olvasó szerepkör engedélyei miatt.

  1. A GitHubon az Azure-alapú projektet tartalmazó adattárban, ahol engedélyezte az Azure MCP-kiszolgálót, lépjen a Problémák gombra.

  2. Válassza az "Új probléma" gombot. Ismertesse a GitHub Copilot kódolási ügynök által a cím- és leírásmezőkben végzett módosításokat. Válassza a "Létrehozás" gombot.

    A korábbi példát követve a következő szöveggel írhatja le a problémát.

    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.

    Ez a példaproblémák egyszerű, egyértelmű kérést tesznek lehetővé akkor is, ha a felhasználó nem tudja pontosan, hogy mit kér. Lehetővé teszi az Azure MCP Server számára a rugalmas Azure Database fo PostgreSQL-kiszolgálóhoz elérhető tárolási szintek és a módosításhoz szükséges Bicep-sablon beállításának kutatását.

    Fontos

    Győződjön meg arról, hogy az "Azure" szót használja a parancssorban, hogy a GitHub Copilot eszközöket kérjen az Azure MCP-kiszolgálótól.

  3. Válassza a "Hozzárendelés a Copilothoz" gombot a Hozzárendelések csoportban. Megjelenik a "Copilot hozzárendelése a problémához" párbeszédpanel, amelyen módosíthatja a céladattárat, az alapágat, és hozzáadhat egy opcionális kérést. Válassza a "Hozzárendelés" gombot.

  4. Ha a probléma a GitHub Copilot kódolási ügynökhöz van rendelve, megjelenik a lekéréses kérelemre mutató hivatkozás a(z) "[WIP]" előtaggal, amely tudatja Önnel, hogy a munka elkezdődött.

  5. A lekéréses kérelem megtekintéséhez válassza a [WIP]" hivatkozást.

  6. A lekéréses kérelem törzsében kattintson a hivatkozásra a kódolási munkamenet megtekintéséhez. Ez azt mutatja, hogy a Copilot Coding-ügynök milyen előrehaladást ért el a kérelemben, hasonlóan a Visual Studióban tapasztaltakhoz.

  7. Ha elkészült, a GitHub Copilot kódolási ügynök kódvizsgálatot kér. A szokásos munkafolyamat használatával iterálhat a GitHubon, és a GitHub Copilotot munkatársaként, kódoló ügynökként kezelheti.

  8. Amikor jóváhagyja a módosításokat, és egyesíti a lekéréses kérelmet, a GitHub Copilot megoldja az eredeti hibát.

Kapcsolódó tartalom

  • Last updated on