Introdução ao GitHub Copilot para Azure

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

Pré-requisitos

Para concluir as etapas deste 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 das contas do Azure.

• Uma conta do GitHub e uma assinatura do GitHub Copilot. Para obter detalhes sobre como configurá-los, consulte Criar uma conta no GitHub e Início Rápido para o GitHub Copilot, respectivamente.

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

• A extensão do GitHub Copilot e a extensão do 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 GitHub Copilot Chat no VS Code, respectivamente.

Importante

O GitHub Copilot é uma assinatura separada gerenciada pelo GitHub. Para obter 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 o Azure

1. No Visual Studio Code, selecione o ícone Extensões .
2. No Marketplace de Extensões, pesquise GitHub Copilot para Azure. Quando a extensão do GitHub Copilot para Azure for exibida, selecione Instalar.
3. Se você for solicitado, entre em sua conta do Azure.

Escreva 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, verifique se ela 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 chat na parte inferior do painel de chat, insira o seguinte prompt:

   Do I have any Azure resources currently running?
   

   A resposta à sua pergunta depende do que está sendo executado no Azure em sua assinatura.

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 os prompts sobre ferramentas específicas do Azure, experimente o seguinte prompt:

   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 desativar ou reativar determinadas ferramentas disponíveis no GitHub Copilot para 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 habilitar/desabilitar ferramentas (ou grupos de ferramentas).

   

Definir seu locatário padrão

Se você tiver vários locatários do Microsoft Entra ID, poderá definir um locatário padrão com o seguinte comando:

@azure /changeTenant

Selecione um dos seus locatários disponíveis no menu suspenso 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, desça até GitHub Copilot para 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, defina o locatário do Azure Resource Graph como sua ID de locatário 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 "Diretrizes do Copilot do Azure") contém diretrizes de alto nível para o GitHub Copilot que é adicionado à janela de contexto ao enviar prompts ao GitHub Copilot para ferramentas do Azure e ferramentas do Servidor MCP do Azure. A orientação neste arquivo destina-se a ser global por natureza, ou seja, destina-se a todas as interações no GitHub Copilot para Azure em todos os projetos. Esse arquivo está localizado em um local de pasta oculto 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 com novas atualizações no GitHub Copilot para Azure.

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

Importante

Você não deve modificar esse arquivo.

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. Uma nova guia é aberta contendo o arquivo de instruções.

   

   Importante

   Você não deve modificar esse arquivo.

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 das contas do Azure.

• Uma conta do GitHub e uma assinatura do GitHub Copilot. Para obter detalhes sobre como configurá-los, consulte Criar uma conta no GitHub e 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 obter perguntas sobre assinaturas e suporte do GitHub Copilot, consulte Introdução a um plano do GitHub Copilot.

Instalar o GitHub Copilot para o Azure

1. No Visual Studio 2022, no menu Extensões, selecione Gerenciar Extensões.
2. No Gerenciador de Extensões, pesquise e selecione GitHub Copilot para Azure (VS 2022). Selecione o botão Instalar.
3. Pouco depois, você verá um banner: "Suas alterações estão agendadas. As modificações começarão quando o Microsoft Visual Studio for fechado." Desligue o Visual Studio.
4. A caixa de diálogo Instalador VSIX é aberta confirmando a instalação. Selecione o botão Modificar .
5. Após alguns instantes, você deverá 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 de Chat do GitHub Copilot for exibida, na área de chat na parte inferior, selecione o modo Agente e, em seguida, selecione o botão Selecionar ferramentas (duas chaves).
9. Na caixa de diálogo Selecionar ferramentas , você deverá ver "Servidor MCP do Azure". À 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 você não vir "Servidor MCP do Azure" na lista de ferramentas, talvez seja necessário desinstalar e reinstalar a extensão.

Escreva seu primeiro prompt

1. Se a janela de Chat ainda não estiver aberta, certifique-se de que ela esteja aberta selecionando a opção de menu View>GitHub Copilot Chat. Você deve ver a janela do chat fixada no lado direito por padrão.

   

2. Na área de texto do chat na parte inferior do painel de chat, insira o seguinte prompt:

   Do I have any resources currently running?
   

   

Por padrão, o GitHub Copilot usa o modo de solicitação . O modo de perguntas fornece respostas para suas solicitações no bate-papo. O modo "Agente" permite que o GitHub Copilot tome medidas em seu ambiente de trabalho.

A resposta à sua pergunta depende do que está sendo executado no Azure em sua assinatura.

Modo de agente

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

O GitHub Copilot para Azure fornece "ferramentas" para o GitHub Copilot para aprimorar a experiência agente por meio da integração profunda com o Azure.

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

Habilitar e desabilitar ferramentas no modo de agente

Talvez você queira desativar ou reativar determinadas ferramentas disponíveis no GitHub Copilot para 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 habilitar/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 das contas do Azure.

• Uma conta do GitHub e uma assinatura do GitHub Copilot. Para obter detalhes sobre como configurá-los, consulte Criar uma conta no GitHub e 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 obter perguntas sobre assinaturas e suporte do GitHub Copilot, consulte Introdução a um plano do GitHub Copilot.

Instalar o GitHub Copilot para o Azure

1. Se você já instalou o Visual Studio 2026 e deseja adicionar o GitHub Copilot ao Azure após a instalação inicial, abra o Instalador do Visual Studio 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 o "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 GitHub Copilot Chat.

6. Se solicitado, entre em sua conta do GitHub.

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

8. Na área de chat, selecione o botão Selecionar ferramentas (ícone de duas chaves) 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ó superior para o Servidor MCP do Azure.

   

Escreva seu primeiro prompt

1. Se a janela de Chat ainda não estiver aberta, certifique-se de que ela esteja aberta selecionando a opção de menu View>GitHub Copilot Chat. Você deve ver a janela do chat fixada no lado direito por padrão.

   

2. Na área de texto do chat na parte inferior do painel de chat, insira o seguinte prompt:

   Do I have any resources currently running?
   

   

Por padrão, o GitHub Copilot usa o modo de solicitação . O modo de perguntas fornece respostas para suas solicitações no bate-papo. O modo "Agente" permite que o GitHub Copilot tome medidas em seu ambiente de trabalho.

A resposta à sua pergunta depende do que está sendo executado no Azure em sua assinatura.

Modo de agente

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

O GitHub Copilot para Azure fornece "ferramentas" para o GitHub Copilot para aprimorar a experiência agente por meio da integração profunda com o Azure.

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

Habilitar e desabilitar ferramentas no modo de agente

Talvez você queira desativar ou reativar determinadas ferramentas disponíveis no GitHub Copilot para 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 habilitar/desabilitar ferramentas (ou grupos de ferramentas).

Conteúdo relacionado

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