Ligue o agente cloud do GitHub Copilot ao servidor Azure MCP

Este artigo mostra-te como configurar e ligar o agente cloud do GitHub Copilot ao Azure MCP Server. Ao ligar o agente cloud ao servidor, o agente pode compreender os seus ficheiros específicos do Azure e os recursos do Azure para fazer edições nos seus ficheiros de código.

No teu repositório do GitHub, atribuir issues do GitHub ao agente de cloud do GitHub Copilot cria um pull request com as alterações no teu código. Se as alterações solicitadas exigirem acesso aos seus recursos do Azure, o agente cloud do GitHub Copilot precisa de usar o Azure MCP Server. Antes de o agente cloud do GitHub Copilot poder usar o Azure MCP Server para fazer alterações agenticamente ao seu projeto baseado no Azure, precisa de configurar o agente cloud do GitHub Copilot e dar-lhe as permissões adequadas no Azure. Podes configurar tudo manualmente, mas muitos passos são automatizados ao usar azd e a coding-agent extensão. O GitHub usa agora o nome de exibição "Copilot cloud agent" na interface, mas o identificador de extensão estável mantém-se azure.coding-agent, e o comando CLI mantém-se azd coding-agent ....

Pré-requisitos

• Uma conta do Azure e acesso a uma assinatura do Azure. Para obter detalhes sobre como configurá-los, consulte a página de preços para contas do Azure.

• Uma conta do GitHub e uma assinatura do GitHub Copilot. Para obter detalhes sobre como configurá-los, consulte Criando uma conta no GitHub e Guia de início rápido para o GitHub Copilot, respectivamente.

• Um clone local existente de um repositório GitHub. Como este artigo descreve como configurar a ligação entre o agente cloud do GitHub Copilot e o Azure MCP Server, o repositório do GitHub deve incluir scripts de deployment para o Azure, como templates do Bicep ou Terraform.

Configurar o repositório GitHub para usar o Servidor MCP do Azure

A azd extensão do agente de codificação simplifica os passos necessários para configurar de forma segura a ligação entre o agente cloud do GitHub Copilot e o servidor MCP do Azure para a sua subscrição do Azure. Primeiro, ele cria uma conta em sua assinatura do Azure e atribui a ela uma função com as permissões necessárias. Em segundo lugar, fornece um excerto JSON necessário para introduzir o Azure MCP Server no agente cloud do GitHub Copilot.

1. Se ainda não tiver azd instalado, siga as instruções para instalá-lo.

2. No terminal, navegue até o clone local do repositório com o qual deseja trabalhar.

3. Invocar a coding-agent extensão para azd usando o comando azd coding-agent config.

4. Durante a instalação, ser-lhe-á pedido que selecione:

   • Subscrição do Azure
   • repositório GitHub que utiliza o agente cloud Copilot
   • Se você deseja criar uma identidade gerenciada pelo usuário nova ou existente
   • Uma localização do Azure
   • Um grupo de recursos do Azure
   • O repositório do GitHub onde uma nova ramificação será criada contendo o arquivo de configuração do fluxo de trabalho GitHub Actions gerado

   Ao selecionar o local e o grupo de recursos, convém usar o mesmo local de destino e o mesmo grupo de recursos que os recursos do Azure no aplicativo.

5. Após alguns momentos, a coding-agent extensão para azd cria (ou usa a identidade gerida atribuída pelo utilizador existente), atribui-lhe um papel, armazena valores de identidade no ambiente do repositório GitHub e cria e lança um ramo contendo o ficheiro de instalação do fluxo de trabalho GitHub Actions gerado.

6. Você verá uma mensagem no console:

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

   Normalmente, existem três tarefas:

   • Mescle a ramificação que contém o arquivo de configuração do fluxo de trabalho GitHub Actions gerado.
   • Configure os papéis de identidade gerida do agente cloud do Copilot no portal Azure. Por padrão, a função "Leitor" é atribuída. No entanto, pode querer dar-lhe outras permissões consoante o que quer que o agente cloud faça de forma autónoma.
   • Visite o link para configurar a configuração do MCP. Para aceder lá manualmente, no GitHub, vá a Settings>Copilot>cloud agent>MCP configuration e cole o excerto de JSON fornecido. Aqui está um exemplo:

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

7. Por fim, pode permitir que a extensão coding-agent abra o navegador azd para criar o pull request para intercalar o ramo que contém o ficheiro gerado de configuração do fluxo de trabalho do GitHub Actions.

Criar um problema no GitHub para iniciar o agente cloud do GitHub Copilot

Neste ponto, configuraste com sucesso o agente cloud do GitHub Copilot para usar o servidor MCP do Azure para quaisquer problemas do GitHub que atribuíres ao agente cloud do GitHub Copilot que exijam compreensão das implementações e recursos do Azure.

Por exemplo, suponha que pretenda aumentar a memória alocada para o PostgreSQL quando implementado no Banco de Dados do Azure para PostgreSQL. Você criaria um problema para modificar seu modelo Bicep para usar a próxima camada de armazenamento disponível e atribuí-lo ao GitHub Copilot.

1. No GitHub, no repositório que contém seu projeto baseado no Azure onde você habilitou o Servidor MCP do Azure, vá para Problemas.

2. Selecione o botão Novo Problema . Descreve a alteração que queres que o agente cloud do GitHub Copilot faça nos campos de título e descrição. Selecione o botão Criar.

   Pegando emprestado do exemplo anterior, você pode usar o texto a seguir para descrever seu problema.

   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.
   

   Este problema de exemplo faz uma solicitação simples e clara, mesmo que o usuário não saiba exatamente o que está pedindo. Permite ao Azure MCP Server pesquisar sobre os níveis de armazenamento disponíveis para o Base de Dados do Azure para PostgreSQL Flexible Server e as definições no modelo Bicep necessárias para fazer essa alteração.

   Importante

   Certifique-se de usar a palavra "Azure" em seu prompt para garantir que o GitHub Copilot solicite ferramentas do Servidor MCP do Azure.

3. Selecione o botão "Atribuir ao Copilot" em Cessionários. A caixa de diálogo "Atribuir Copilot ao problema" é exibida, permitindo que você modifique o repositório de destino, a ramificação base e adicione um prompt opcional. Selecione o botão "Atribuir".

4. Depois de o problema ser atribuído ao agente cloud do GitHub Copilot, vê um link para o pull request com o prefixo "[WIP]" a informar que o trabalho está a começar.

5. Selecione o link "[WIP]" para visualizar a solicitação pull.

6. No corpo da solicitação pull, selecione o link para exibir a sessão de codificação. Isto mostra o progresso que o agente na cloud do Copilot está a fazer relativamente ao pedido, à semelhança da experiência no Visual Studio.

7. Quando termina, o agente cloud do GitHub Copilot solicita uma revisão de código. Utilize o seu fluxo de trabalho habitual para iterar no GitHub, tratando o agente na cloud do GitHub Copilot como um colega de equipa.

8. Quando você aprova as alterações e mescla a solicitação pull, o GitHub Copilot resolve o problema original que você criou.

Conteúdo relacionado

• GitHub Copilot cloud agent