Introdução ao GitHub Copilot para Azure

Comece a usar o GitHub Copilot para Azure para simplificar seu fluxo de trabalho de desenvolvimento e melhorar sua produtividade na plataforma Azure. Este guia orienta você pelos pré-requisitos e instalação do Copilot do GitHub para Azure no Visual Studio, para que você possa escrever seu primeiro prompt.

Pré-requisitos

Para concluir as etapas neste artigo, verifique se você tem:

• 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.

• Código do Visual Studio. Para obter detalhes sobre como baixá-lo e instalá-lo, consulte Configurando o Visual Studio Code.

• A extensão GitHub Copilot e a extensão GitHub Copilot Chat. Para obter instruções sobre como instalar essas extensões, consulte Configurar o GitHub Copilot no VS Code e Introdução ao bate-papo do GitHub Copilot no VS Code, respectivamente.

Importante

O GitHub Copilot é uma assinatura separada gerenciada pelo GitHub. Para perguntas sobre assinaturas e suporte do GitHub Copilot, consulte Introdução a um plano do GitHub Copilot.

Por padrão, o Copilot no Azure está disponível para todos os usuários em um locatário. No entanto, os Administradores Globais podem gerenciar o acesso ao Copilot no Azure para sua organização. O acesso também pode ser concedido opcionalmente a usuários ou grupos específicos do Microsoft Entra. Para obter mais informações, consulte Gerenciar o acesso ao Microsoft Copilot no Azure.

Instalar o GitHub Copilot para Azure

1. No Visual Studio Code, selecione o ícone Extensões .
2. No Extensions Marketplace, pesquise GitHub Copilot for Azure. Quando a extensão GitHub Copilot for Azure for exibida, selecione Instalar.
3. Se lhe for pedido, inicie sessão na sua conta do Azure.

Escreva o seu primeiro prompt

1. Verifique se a extensão está instalada, se você está autenticado corretamente e se a extensão está funcionando corretamente.

2. Se a janela Chat ainda não estiver aberta, certifique-se de que está aberta selecionando o botão Alternar Chat na barra de menus ou selecione a lista suspensa ao lado do botão Alternar Chat e selecione Abrir Chat (Ctrl+Alt+I).

   

3. Na área de texto do bate-papo na parte inferior do painel de bate-papo, digite o seguinte prompt:

   Do I have any Azure resources currently running?
   

   A resposta à sua pergunta depende do que está atualmente em execução no Azure na sua subscrição.

4. Em seguida, use o seguinte prompt:

   What are your tools?
   

   A resposta de conclusão exibe uma lista de ferramentas específicas do GitHub Copilot para Azure disponíveis para o GitHub Copilot. A resposta fornece uma boa visão geral dos tipos de funcionalidade agora disponíveis para você:

   I'll ask the Azure development helper to recommend custom modes relevant to listing and explaining the GitHub Copilot for Azure tools in VS Code; expected outcome: a short set of recommended modes or tips to tailor the tools explanation.
   
   Progress update: I queried the Azure development helper to get recommended custom modes for this topic. Next, I'll list and briefly explain the tools I have available (grouped and with example prompts and common uses) so you can copy/paste or use them directly in VS Code.
   
   Tools I can use (concise overview)
   
   1. Search & navigation
   
      - Capabilities: semantic code/documentation search, file search with globs, text search (grep), list directory contents, read file contents, find usages/references.
      - Example prompts:
         - "Find all usages of MyService in this workspace."
         - "Search for connectionString in **/*.config files."
      - When to use: locating code, docs, or examples quickly inside your repo.
   
   2. Code editing & analysis
      - Capabilities: insert edits into files, create or modify files, suggest refactors, report code errors, find test files.
      - Example prompts:
         - "Add a function to validate input in src/utils.js."
         - "Refactor this function to use async/await and update its tests."
      - When to use: implementing features, fixing bugs, generating or updating code.
   
   3. Terminal & Git operations
   
      - Capabilities: run shell commands, read terminal output, show git diffs and changed files.
      - Example prompts:
         - "Run npm test and show me failing tests."
         - "Stage and commit the changes with message 'fix: update README'."
      - When to use: run builds/tests, inspect outputs, perform git workflows (if enabled).
   
   4. Project creation & workspace setup
   
      - Capabilities: create new workspaces, scaffold projects (templates), install VS Code extensions, create notebooks.
      - Example prompts:
         - "Generate a Node.js express app scaffold in a new folder."
         - "Add recommended extensions for Python development."
      - When to use: bootstrapping projects or adding project-level config.
   
   5. Web & API tools
   
      - Capabilities: fetch web pages, retrieve API docs (for example VS Code API references), gather remote content for research.
      - Example prompts:
         - "Fetch the Azure CLI docs for az storage account list."
         - "Get the VS Code extension API docs for commands."
      - When to use: look up official docs or examples during work.
   
   6. Azure-specific tools
   
      - Capabilities: Azure development best practices guidance, Microsoft Learn documentation lookup, query Azure Resource Graph (when authenticated), manage Azure auth context (change tenant, sign out), generate Azure CLI / Bicep / ARM snippets, Bicep schemas, and guidance for deploying models and services.
      - Example prompts:
         - "What are Azure best practices for deploying this function app?"
         - "@azure /changeTenant — set my default tenant to <tenant-id>"
         - "Generate a Bicep template for an App Service and a Storage Account."
      - When to use: any task that touches Azure resources, deployment, or configuration.
   
   7. Documentation & learning
   
      - Capabilities: search and extract Microsoft Learn articles, provide code samples from official docs, show relevant how-to steps.
      - Example prompts:
         - "Show official docs for configuring Key Vault access policies."
         - "Give me a short tutorial on using Azure App Configuration."
      - When to use: learn or reference official Microsoft guidance.
   
   How I present results
   
   - Short answers or step-by-step instructions.
   - Full edits (I can create or modify files if you allow the extension to act).
   - Commands and code snippets you can paste into your terminal.
   - Checks (like running tests or linters) when terminal access is allowed.
   
   Example: Quick copy-paste prompts you can use in the VS Code chat
   
   - "What are your tools?" — lists the tools (this reply).
   - "Find all TODO comments in this repo and open a summary."
   - "Generate an az CLI command to list storage accounts sorted by region."
   - "@azure /changeTenant" — opens tenant selection (if you need to set a default).
   
   Notes and privacy/permissions
   
   - Some capabilities (like querying your Azure resources or running commands) require you to be signed in and to enable those tools in the extension (you can enable/disable specific tools in the chat pane tool list).
   - I won't perform actions that need elevated permissions without verifying your explicit consent.
   
   If you'd like, I can:
   
   - Expand any tool section with more example prompts and exact commands.
   - Show a short step-by-step for enabling/disabling tools in the chat pane.
   - Generate a one-page cheatsheet you can paste into an internal docs file. Which would you like next?
   
   

   O conteúdo da resposta pode variar e pode mudar ao longo do tempo à medida que novos recursos e ferramentas são adicionados.

5. Para testar mensagens sobre ferramentas específicas do Azure, tente a seguinte mensagem:

   What is the az command to list all my storage accounts ordered by location?
   

   A conclusão desse prompt pode gerar:

   
   I'll show the exact az CLI commands (sorted ascending/descending) plus a few useful output variants and a quick note about prerequisites.
   
   Commands
   
   - Sorted by location (ascending), full JSON:
   
      az storage account list --query "sort_by(@, &location)" -o json
   
   - Sorted by location, show only name and location in a readable table:
   
      az storage account list --query "sort_by(@, &location)[].[name,location]" -o table
   
   - Sorted by location (descending):
   
      az storage account list --query "reverse(sort_by(@, &location))" -o json
   
   - Sorted by location and include resource group and SKU in table:
   
      az storage account list --query "sort_by(@, &location)[].[name,resourceGroup,sku.name,location]" -o table
   
   Notes
   
   - Run az login first and ensure the correct subscription is selected (e.g., az account set -s "<subscription-id-or-name>").
   - You need permission to list storage accounts in the chosen subscription.
   - The query uses JMESPath (sort_by/reverse) to order results client-side.
   
   Would you like a version that groups counts by region or that queries across all subscriptions?
   
   

Habilitar e desabilitar ferramentas no modo de agente

Talvez você queira desabilitar ou reativar determinadas ferramentas disponíveis pelo GitHub Copilot for Azure.

1. Selecione o ícone da ferramenta no painel de chat.

   

2. Use a caixa de seleção ao lado da lista de ferramentas para ativar/desabilitar ferramentas (ou grupos de ferramentas).

   

Definir o inquilino predefinido

Se tiver múltiplos inquilinos do Microsoft Entra ID, pode definir um inquilino padrão utilizando o seguinte comando:

@azure /changeTenant

Selecione a partir de uma lista dos seus inquilinos disponíveis no menu pendente no centro superior.

Você também pode definir o locatário padrão nas configurações da extensão:

1. No Visual Studio Code, na barra de atividades, selecione Extensões. Em seguida, role para baixo até GitHub Copilot for Azure.

   

2. Selecione o ícone de engrenagem no canto da entrada da extensão e, em seguida, selecione Configurações no menu pop-up.

   

3. Na guia Configurações, ajuste o inquilino do Azure Resource Graph para o seu identificador de inquilino do Microsoft Entra. Você pode encontrar sua ID de locatário do Microsoft Entra no portal do Azure.

   

Exibir o arquivo de instruções do GitHub Copilot para Azure

O arquivo de instruções (também conhecido como "Azure Copilot Guidelines") contém orientações de alto nível para o GitHub Copilot que são adicionadas à janela de contexto ao enviar prompts para o GitHub Copilot para ferramentas do Azure e ferramentas do Azure MCP Server. A orientação neste arquivo destina-se a ser global por natureza, ou seja, destina-se a todas as interações no GitHub Copilot for Azure em todos os projetos. Este ficheiro está localizado numa localização de pasta oculta e não se destina a ser modificado. Você não deve modificar esse arquivo porque ele pode degradar ou desabilitar o GitHub Copilot para Azure, e suas alterações podem ser substituídas por novas atualizações para o GitHub Copilot for Azure.

Exibir as "Diretrizes do Copiloto do Azure" pode fornecer uma visão de como o Copiloto do GitHub para ferramentas do Azure e as ferramentas do Servidor MCP do Azure são introduzidas no Copiloto do GitHub, ajudando você a desenvolver uma compreensão mais profunda de como tudo funciona.

Importante

Não deve modificar este ficheiro.

1. Selecione ctrl + shift + p para abrir a paleta de comandos.

2. Digite Chat: Configure Instructions e selecione a entrada.

   

3. Na próxima etapa, selecione AzureCopilotGuidelines .

   

4. É aberta uma nova guia contendo o arquivo de instruções.

   

   Importante

   Não deve modificar este ficheiro.

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.

• Visual Studio 2022 (Qualquer edição). Para obter detalhes sobre como baixá-lo e instalá-lo, consulte Instalar o Visual Studio.

Importante

O GitHub Copilot é uma assinatura separada gerenciada pelo GitHub. Para perguntas sobre assinaturas e suporte do GitHub Copilot, consulte Introdução a um plano do GitHub Copilot.

Instalar o GitHub Copilot para Azure

1. No Visual Studio 2022, no menu Extensões, selecione Gerenciar Extensões.
2. No Extension Manager, procure e selecione GitHub Copilot for Azure (VS 2022). Selecione o botão Instalar.
3. Depois de um momento, você verá um banner: "Suas alterações estão programadas. As modificações começarão quando o Microsoft Visual Studio for fechado." Desligue o Visual Studio.
4. A caixa de diálogo VSIX Installer é aberta confirmando a instalação. Selecione o botão Modificar .
5. Depois de alguns momentos, você verá "Modificações concluídas". Selecione o botão Fechar .
6. Reabra o Visual Studio 2022.
7. Selecione o botão "GitHub Copilot" no canto superior direito da janela na barra de ferramentas. Selecione Abrir janela de chat.
8. Quando a janela GitHub Copilot Chat aparecer, na área de bate-papo na parte inferior, selecione Modo de agente e, em seguida, selecione o botão Selecionar ferramentas (duas chaves).
9. Na caixa de diálogo Selecionar ferramentas , você verá "Azure MCP Server". À direita, você verá "0/153" se nenhuma ferramenta estiver selecionada (que é atualmente o padrão). Selecione o nó pai para escolher todas as ferramentas.

Importante

Se não vir "Azure MCP Server" na lista de ferramentas, poderá ter de desinstalar e reinstalar a extensão.

Escreva o seu primeiro prompt

1. Se a janela de bate-papo ainda não estiver aberta, verifique se ela está aberta selecionando a opção do menu Exibir>bate-papo do GitHub Copilot . Você deve ver a janela de bate-papo encaixada no lado direito por padrão.

   

2. Na área de texto do bate-papo na parte inferior do painel de bate-papo, digite o seguinte prompt:

   Do I have any resources currently running?
   

   

Por padrão, o GitHub Copilot usa o modo ask . O modo Perguntar fornece respostas às suas solicitações no painel de chat. O modo de agente permite que o GitHub Copilot execute ações em seu espaço de trabalho.

A resposta à sua pergunta depende do que está atualmente em execução no Azure na sua subscrição.

Modo de agente

No modo Agente, o GitHub Copilot pode executar tarefas em todo o espaço de trabalho do Visual Studio, fazendo edições, executando comandos de terminal e assim por diante.

O GitHub Copilot para Azure fornece "ferramentas" ao GitHub Copilot para melhorar a experiência de agente por meio de uma integração profunda com o Azure.

Para alternar entre o modo ask e agente, selecione a divisa para baixo ao lado da opção Ask na área de chat e selecione o modo desejado.

Habilitar e desabilitar ferramentas no modo de agente

Talvez você queira desabilitar ou reativar determinadas ferramentas disponíveis pelo GitHub Copilot for Azure.

1. Selecione o ícone "Selecionar ferramentas" no painel de chat.

   

2. Use a caixa de seleção ao lado da lista de ferramentas para ativar/desabilitar ferramentas (ou grupos de ferramentas).

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.

• Visual Studio 2026 (Qualquer edição). Para obter detalhes sobre como baixá-lo e instalá-lo, consulte Instalar o Visual Studio.

Importante

O GitHub Copilot é uma assinatura separada gerenciada pelo GitHub. Para perguntas sobre assinaturas e suporte do GitHub Copilot, consulte Introdução a um plano do GitHub Copilot.

Instalar o GitHub Copilot para Azure

1. Se você já instalou o Visual Studio 2026 e deseja adicionar o GitHub Copilot para Azure após a instalação inicial, abra o Visual Studio Installer e selecione o botão Modificar , que exibe as cargas de trabalho disponíveis.

   

   Se você estiver instalando o Visual Studio 2026 pela primeira vez, o instalador do Visual Studio exibirá automaticamente as cargas de trabalho disponíveis.

2.  Na guia Cargas de trabalho, verifique se "Desenvolvimento de IA do Azure" está selecionado.

   

3. Selecione o botão Instalar para concluir a instalação.

4. Inicie o Visual Studio 2026 e crie ou carregue um projeto.

5. Abra o bate-papo do copiloto do GitHub.

6. Se solicitado, faça login na sua conta do GitHub.

7. Se solicitado, entre na sua conta do Azure.

8. Na área de chat, selecione o botão Selecionar ferramentas (ícone de duas chaves inglesas) para exibir uma lista de ferramentas disponíveis. Habilite todas as ferramentas do Azure verificando os principais nós do Azure.

   

   Selecione também o nó principal para o Servidor MCP do Azure.

   

Escreva o seu primeiro prompt

1. Se a janela de bate-papo ainda não estiver aberta, verifique se ela está aberta selecionando a opção do menu Exibir>bate-papo do GitHub Copilot . Você deve ver a janela de bate-papo encaixada no lado direito por padrão.

   

2. Na área de texto do bate-papo na parte inferior do painel de bate-papo, digite o seguinte prompt:

   Do I have any resources currently running?
   

   

Por padrão, o GitHub Copilot usa o modo ask . O modo Perguntar fornece respostas às suas solicitações no painel de chat. O modo de agente permite que o GitHub Copilot execute ações em seu espaço de trabalho.

A resposta à sua pergunta depende do que está atualmente em execução no Azure na sua subscrição.

Modo de agente

No modo Agente, o GitHub Copilot pode executar tarefas em todo o espaço de trabalho do Visual Studio, fazendo edições, executando comandos de terminal e assim por diante.

O GitHub Copilot para Azure fornece "ferramentas" ao GitHub Copilot para melhorar a experiência de agente por meio de uma integração profunda com o Azure.

Para alternar entre o modo ask e agente, selecione a divisa para baixo ao lado da opção Ask na área de chat e selecione o modo desejado.

Habilitar e desabilitar ferramentas no modo de agente

Talvez você queira desabilitar ou reativar determinadas ferramentas disponíveis pelo GitHub Copilot for Azure.

1. Selecione o ícone "Selecionar ferramentas" no painel de chat.

   

2. Use a caixa de seleção ao lado da lista de ferramentas para ativar/desabilitar ferramentas (ou grupos de ferramentas).

Conteúdos relacionados

• Entenda o que é o GitHub Copilot para Azure e como ele funciona.
• Siga o guia rápido para entender como incluir o GitHub Copilot para Azure no seu fluxo de trabalho de desenvolvimento de software. O guia de início rápido descreve como implantar serviços no Azure, monitorar seu status e solucionar problemas.
• Veja exemplos de prompts para saber mais sobre o Azure e entender sua conta, assinatura e recursos do Azure.
• Veja exemplos de prompts para projetar e desenvolver aplicativos para o Azure.
• Veja exemplos de prompts para implantar seu aplicativo no Azure.
• Veja exemplos de prompts para solucionar problemas de seus recursos do Azure.