Sdílet prostřednictvím

Připojení agenta kódování GitHub Copilot k serveru Azure MCP

V tomto článku se dozvíte, jak nastavit a připojit agenta kódování GitHub Copilot k Serveru Azure MCP, aby agent kódování mohl pochopit soubory specifické pro Azure a prostředky Azure a provádět úpravy souborů kódu.

V úložišti GitHub při přiřazení problémů v GitHubu agentu GitHub Copilot pro kódování se vytvoří pull request s úpravami ve vašem kódu. Pokud požadované změny vyžadují přístup k vašim prostředkům Azure, musí agent kódování GitHub Copilot použít Azure MCP Server. Než může agent kódování GitHub Copilot použít Azure MCP Server k provádění změn v agentech projektu založeného na Azure, musíte nakonfigurovat agenta kódování GitHub Copilot a udělit mu správná oprávnění v Azure. Všechno můžete nakonfigurovat ručně, ale mnoho kroků se automatizuje pomocí azd, Azure Developer CLI a coding-agent rozšíření.

Požadavky

  • Účet Azure a přístup k předplatnému Azure. Podrobnosti o tom, jak je nastavit, najdete na stránce s cenami účtů Azure.

  • Účet GitHub a předplatné GitHub Copilot. Podrobnosti o tom, jak je nastavit, najdete v tématu Vytvoření účtu na GitHubu a rychlém startu pro GitHub Copilot.

  • Existující místní klon úložiště GitHub. Vzhledem k tomu, že tento článek popisuje, jak nastavit připojení mezi agentem kódování GitHub Copilot k Serveru Azure MCP, úložiště GitHub by mělo zahrnovat skripty nasazení do Azure, jako jsou šablony Bicep nebo Terraform.

Konfigurace úložiště GitHub pro použití Azure MCP Serveru

Rozšíření azd kódovacího agenta zjednodušuje kroky potřebné k bezpečnému nastavení připojení mezi agentem kódování GitHub Copilot a Azure MCP Serverem pro vaše předplatné Azure. Nejprve vytvoří účet ve vašem předplatném Azure a přiřadí ho roli s potřebnými oprávněními. Za druhé poskytuje fragment kódu JSON potřebný k zavedení Azure MCP Serveru do agenta kódování GitHub Copilot.

  1. Pokud ještě azd nemáte nainstalované, nainstalujte ho podle pokynů .

  2. V terminálu přejděte do místního klonu úložiště, se kterým chcete pracovat.

  3. Spusťte rozšíření pro kódování agenta azd příkazem: azd coding-agent config.

  4. Během instalace se zobrazí výzva k výběru:

    • Předplatné Azure
    • Které úložiště GitHubu bude používat agenta Copilot Coding
    • Bez ohledu na to, jestli chcete vytvořit novou nebo existující identitu spravovanou uživatelem
    • Umístění Azure
    • Skupina prostředků Azure
    • Úložiště GitHub, kde se vytvoří nová větev obsahující vygenerovaný soubor nastavení pracovního postupu GitHub Actions

    Při výběru umístění a skupiny prostředků můžete chtít použít stejné cílové umístění a skupinu prostředků jako prostředky Azure v aplikaci.

  5. Po chvíli rozšíření agentu pro kódování vytvoří (nebo použije existující) spravovanou identitu uživatele a přiřadí jí roli, uloží hodnoty identity v prostředí na GitHubu a vytvoří a pushne větev obsahující vygenerovaný instalační soubor pracovního postupu GitHub Actions.

  6. V konzole se zobrazí zpráva:

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

    Obvykle existují tři úkoly:

    • Sloučte větev obsahující vygenerovaný soubor nastavení pracovního postupu GitHub Actions.
    • Nakonfigurujte role spravované identity agenta Copilot v Azure Portalu. Ve výchozím nastavení je přiřazena role Čtenář. Mohli byste však chtít udělit agentu programování další oprávnění podle toho, co má dělat samostatně.
    • Přejděte na odkaz pro nastavení konfigurace MCP. Pokud tam chcete přejít ručně, přejděte v GitHubu do části Nastavení > Copilot > programovací agent > MCP Configuration a vložte poskytnutý JSON úryvek kódu. Tady je příklad:
    {
    "mcpServers": {
        "Azure": {
            "type": "local",
            "command": "npx",
            "args": [
                "-y",
                "@azure/mcp@latest",
                "server",
                "start"
            ],
            "tools": [
                "*"
            ]
        }
    }
}

  7. Nakonec můžete povolit rozšíření kódovacího agenta azd k otevření prohlížeče, abyste mohli vytvořit pull request pro sloučení větve obsahující vygenerovaný instalační soubor pracovního postupu GitHub Actions.

Vytvoření problému na GitHubu za účelem zahájení agenta kódování GitHub Copilot

V tomto okamžiku jste úspěšně nastavili agenta kódování GitHub Copilot tak, aby používal Azure MCP Server pro všechny problémy GitHubu, které přiřadíte agentu kódování GitHub Copilot, který vyžaduje pochopení nasazení a prostředků Azure.

Předpokládejme například, že chcete zvýšit paměť přidělenou postgreSQL při nasazení do služby Azure Database for PostgreSQL. Vytvořili byste problém s úpravou šablony Bicep tak, aby používala další dostupnou úroveň úložiště a přiřadili ji ke GitHub Copilotu.

Poznámka:

Role User Managed Identity je ve výchozím nastavení nastavena na "Čtenář", takže změny, které požadujete, by měly být provedeny v skriptech nasazení, jako jsou šablony Bicep nebo Terraform. Žádost o přímou úpravu existujících prostředků ve vašem předplatném Azure není autorizovaná kvůli oprávněním role Čtenář.

  1. V GitHubu přejděte v úložišti obsahujícím váš projekt založený na Azure, kde jste povolili Azure MCP Server, do části Problémy.

  2. Vyberte tlačítko Nový problém. Popište změnu, kterou má agent kódování GitHub Copilot provést v polích názvu a popisu. Vyberte tlačítko Vytvořit.

    K čerpání inspirace z předchozího příkladu můžete následující text použít k popisu vašeho problému.

    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.

    Tento příklad problému jasně a jednoduše formulovat žádost, i když uživatel přesně neví, o co žádá. Umožňuje serveru Azure MCP provádět průzkum dostupných úrovní úložiště pro flexibilní server Azure Database fo PostgreSQL a nastavení v šabloně Bicep potřebné k provedení této změny.

    Důležité

    Ujistěte se, že ve výzvě používáte slovo Azure, abyste zajistili, že GitHub Copilot požaduje nástroje ze serveru Azure MCP.

  3. Vyberte tlačítko "Přiřadit ke Copilotu" v části Přiřazení. Zobrazí se dialogové okno 'Přiřadit Copilot k problému', ve kterém můžete upravit cílové úložiště, základní větev a přidat volitelný podnět. Vyberte tlačítko Přiřadit.

  4. Jakmile je problém přiřazený k agentovi kódování GitHub Copilot, zobrazí se odkaz na žádost o přijetí změn s předponou [WIP] s informací, že práce začíná.

  5. Klikněte na odkaz [WIP] pro zobrazení žádosti o přijetí změn.

  6. V těle pull requestu vyberte odkaz pro zobrazení kódovací relace. To ukazuje průběh, kterého agent Copilot Coding dosahuje při plnění požadavku, podobně jako v prostředí Visual Studio.

  7. Po dokončení vyžaduje agent kódování GitHub Copilot kontrolu kódu. Pomocí svého běžného pracovního postupu iterujte s GitHubem a zacházejte s GitHub Copilot jako se spolupracovníkem při psaní kódu.

  8. Když změny schválíte a žádost o přijetí změn sloučíte, GitHub Copilot vyřeší původní problém, který jste vytvořili.

Související obsah

  • Last updated on