GitHub Copilot felhőügynök csatlakoztatása az Azure MCP-kiszolgálóhoz

Ez a cikk bemutatja, hogyan állíthatja be és csatlakoztathatja a GitHub Copilot felhőügynököt az Azure MCP-kiszolgálóhoz. A felhőügynök kiszolgálóhoz való csatlakoztatásával az ügynök megismerheti a Azure-specifikus fájlokat és Azure erőforrásokat a kódfájlok szerkesztéséhez.

A GitHub adattárban GitHub problémák hozzárendelése a GitHub Copilot felhőügynökhöz egy lekéréses kérést hoz létre a kód módosításaival. Ha a kért módosításokhoz hozzá kell férnie a Azure-erőforrásokhoz, a GitHub Copilot felhőügynöknek az Azure MCP-kiszolgálót kell használnia. Ahhoz, hogy a GitHub Copilot felhőügynök a Azure MCP-kiszolgálóval ügynökileg módosíthassa a Azure-alapú projektet, konfigurálnia kell a GitHub Copilot felhőügynököt, és meg kell adnia neki a megfelelő engedélyeket Azure. Mindent manuálisan konfigurálhat, de számos lépés automatizálható a használatával azd és a coding-agent bővítmény használatával. GitHub mostantól a felhasználói felületen a "Copilot felhőügynök" megjelenítendő nevet használja, de a stabil bővítményazonosító megmaradazure.coding-agent, és a CLI-parancs megmaradazd coding-agent ....

Prerequisites

  • 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 kapcsolatot GitHub Copilot felhőügynök és a Azure MCP-kiszolgáló között, a GitHub adattárnak tartalmaznia kell a Azure ü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 felhőügynök és a Azure MCP-kiszolgáló közötti kapcsolat biztonságos beállításához szükséges lépéseket a Azure-előfizetéshez. 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 a Azure MCP-kiszolgáló GitHub Copilot felhőügynökhöz való bevezetéséhez.

  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. A(z) coding-agentazd bővítmény meghívásához használja a(z) azd coding-agent config parancsot.

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

    • Azure-előfizetés
    • GitHub Copilot felhőügynököt használó adattár
    • 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 coding-agent bővítmény azd létrehozza (vagy használja a meglévő) felhasználó által hozzárendelt felügyelt identitást, hozzárendel egy szerepkört, 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 Copilot felhőügynök felügyelt identitásszerepköreit a Azure portálon. Alapértelmezés szerint az "Olvasó" szerepkör van hozzárendelve. Előfordulhat azonban, hogy más engedélyeket szeretne adni neki attól függően, hogy mit szeretne a felhőügynöknek autonóm módon elvégeznie.
    • Az MCP-konfiguráció beállításához látogasson el a hivatkozásra. Ha manuálisan szeretne odamenni, GitHub lépjen a Beállítások>Copilot>Felhő ügynök>MCP-konfigurációjára, é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 coding-agent bővítmény azd megnyissa a böngészőt, így létrehozhatja a lekéréses kérelmet, amely egyesíti a létrehozott GitHub Actions munkafolyamat-telepítőfájlt tartalmazó ágat.

Hibajegy létrehozása a GitHubon a GitHub Copilot felhőalapú ügynökének elindításához

Ezen a ponton sikeresen beállította GitHub Copilot felhőügynököt, hogy az Azure MCP-kiszolgálót használja az GitHub Copilot felhőügynökhöz hozzárendelt GitHub problémákhoz, amelyek Azure üzemelő példányok és erőforrások megértését igénylik.

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.

Note

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. Írja le, hogy milyen módosítást szeretne GitHub Copilot felhőügynöknek a cím- és leírásmezőkben. 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, hogy a Azure MCP-kiszolgáló kutatást végezzen a rugalmas Azure Database for PostgreSQL kiszolgáló rendelkezésre álló tárolási szintjeiről, valamint a módosításhoz szükséges Bicep sablon beállításáról.

    Important

    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 GitHub Copilot felhőügynökhöz van rendelve, megjelenik a lekéréses kérelemre mutató hivatkozás, amely a(z) "[WIP]" előtaggal van ellátja, és 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 felhőügynök milyen előrehaladást végez a kérésen, hasonlóan a Visual Studio tapasztalataihoz.

  7. Ha elkészült, GitHub Copilot felhőügynök kódvizsgálatot kér. Használja a megszokott munkafolyamatát a GitHubbal való iterációhoz, és kezelje a GitHub Copilot felhőügynököt munkatársként.

  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

  • Utolsó frissítés időpontja: