Připojení GitHub Copilot cloudového agenta k serveru Azure MCP

V tomto článku se dozvíte, jak nastavit a připojit GitHub Copilot cloudového agenta k serveru Azure MCP. Připojením cloudového agenta k serveru může agent porozumět vašim Azure souborům a Azure prostředkům, aby mohl provádět úpravy souborů kódu.

V úložišti GitHub přiřazování problémů GitHub agentu cloudu GitHub Copilot vytvoří žádost o přijetí změn se změnami kódu. Pokud požadované změny vyžadují přístup k vašim prostředkům Azure, musí GitHub Copilot cloudový agent používat Azure MCP Server. Než bude GitHub Copilot cloudový agent moct pomocí Azure MCP Serveru provádět změny v agentech projektu Azure, musíte nakonfigurovat GitHub Copilot cloudového agenta a udělit mu správná oprávnění v Azure. Všechno můžete nakonfigurovat ručně, ale mnoho kroků je automatizováno pomocí azd a rozšíření coding-agent. GitHub teď v uživatelském rozhraní používá zobrazovaný název „cloudový agent Copilot“, ale stabilní identifikátor rozšíření zůstává azure.coding-agent a příkaz CLI zůstává azd coding-agent ....

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 GitHub Copilot cloudovým agentem a Azure MCP Serverem, mělo by úložiště GitHub zahrnovat skripty nasazení pro Azure, jako jsou Bicep nebo šablony Terraformu.

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

Rozšíření azd programovacího agenta zjednodušuje kroky potřebné k bezpečnému nastavení připojení mezi GitHub Copilot cloudovým agentem a serverem Azure MCP 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 cloudového agenta 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. Vyvolejte coding-agent rozšíření pro azd pomocí příkazu azd coding-agent config.

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

   • Předplatné Azure
   • GitHub úložiště, které používá cloudového agenta Copilot
   • 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 několika okamžicích rozšíření coding-agent pro azd vytvoří (nebo použije existující) uživatelem přiřazenou spravovanou identitu, přiřadí jí roli, uloží hodnoty identity do prostředí úložiště GitHubu a vytvoří a nahraje větev obsahující vygenerovaný soubor nastavení 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.
   • Na portálu Azure nakonfigurujte role spravované identity cloudového agenta Copilot. Ve výchozím nastavení je přiřazena role Čtenář. Můžete ale chtít udělit další oprávnění na základě toho, co má cloudový agent dělat samostatně.
   • Přejděte na odkaz pro nastavení konfigurace MCP. Pokud tam chcete přejít ručně, na GitHubu přejděte do Nastavení>Copilot>cloudový agent>konfigurace MCP a vložte poskytnutý fragment JSON. Tady je příklad:

   {
       "mcpServers": {
           "Azure": {
               "type": "local",
               "command": "npx",
               "args": [
                   "-y",
                   "@azure/mcp@latest",
                   "server",
                   "start"
               ],
               "tools": [
                   "*"
               ]
           }
       }
   }
   

7. Nakonec můžete rozšíření coding-agent povolit otevřít prohlížeč pro azd, abyste mohli vytvořit pull request pro sloučení větve obsahující vygenerovaný soubor konfigurace pracovního postupu GitHub Actions.

Vytvořte hlášení na GitHubu ke spuštění cloudového agenta GitHub Copilot

V tomto bodě jste úspěšně nastavili cloudového agenta GitHub Copilot tak, aby používal server Azure MCP pro všechny problémy na GitHubu, které přiřadíte cloudovému agentovi GitHub Copilot a které vyžadují porozumění nasazením a prostředkům v 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.

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. Klikněte na tlačítko Nový problém. Popište změnu, kterou má GitHub Copilot cloudový agent 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 Azure MCP Serveru provádět průzkum dostupných úrovní úložiště pro flexibilní server Azure Database for 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 se problém přiřadí ke cloudovému agentovi GitHub Copilot, zobrazí se odkaz na žádost o přijetí změn s předponou [WIP] s oznámením, že se práce spouští.

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 postup, kterého cloudový agent Copilot dosahuje při zpracování požadavku, podobně jako v aplikaci Visual Studio.

7. Po dokončení GitHub Copilot agent cloudu požádá o kontrolu kódu. Používejte svůj běžný pracovní postup k průběžné práci s GitHubem a GitHub Copilot cloudového agenta berte jako spolupracovníka.

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

• GitHub Copilot cloudový agent