Introdução ao GitHub Copilot para Azure

Pré-requisitos

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

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

• Uma conta GitHub e uma assinatura GitHub Copilot. Para obter detalhes sobre como configurá-los, consulte Criando uma conta em GitHub e Quickstart para GitHub Copilot, respectivamente.

• Visual Studio Code. Para obter detalhes sobre como baixá-lo e instalá-lo, consulte Setting up 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 GitHub Copilot no VS Code e Introdução ao GitHub Copilot Chat no VS Code, respectivamente.

Por padrã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 a Copilot em Azure para sua organização. O acesso também pode ser concedido opcionalmente a usuários ou grupos Microsoft Entra específicos. Para obter mais informações, consulte Manage acesso ao Microsoft Copilot no Azure.

Instalar GitHub Copilot para Azure

1. Em Visual Studio Code, selecione o ícone Extensions.
2. No Marketplace de Extensões, pesquise GitHub Copilot para Azure. Quando a extensão GitHub Copilot para Azure for exibida, selecione Instalar.
3. Se for solicitado, entre em sua conta 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 momento em Azure em sua assinatura.

4. Em seguida, use o seguinte prompt:

   What are your tools?
   

   A resposta de conclusão exibe uma lista das 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 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 desabilitar ou habilitar novamente 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 Microsoft Entra ID, poderá definir um locatário padrão usando o seguinte prompt:

@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. Em Visual Studio Code, na Barra de Atividades, selecione Extensions. Em seguida, role para baixo 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 Settings, defina o locatário Azure Resource Graph como sua ID de locatário Microsoft Entra. Você pode encontrar sua ID de locatário Microsoft Entra no portal do Azure.

   

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

O arquivo instructions (também conhecido como "Diretrizes de Azure Copilot") contém diretrizes de alto nível para GitHub Copilot que são adicionadas à janela de contexto ao enviar prompts para GitHub Copilot para ferramentas de Azure e ferramentas do SERVIDOR MCP Azure. A orientação neste arquivo destina-se a ser global por natureza, ou seja, destina-se a todas as interações entre 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 GitHub Copilot para Azure, e suas alterações podem ser substituídas com novas atualizações para GitHub Copilot para Azure.

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

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 Azure e acesso a uma assinatura Azure. Para obter detalhes sobre como configurá-los, consulte a página de preços para contas do Azure.

• Uma conta GitHub e uma assinatura GitHub Copilot. Para obter detalhes sobre como configurá-los, consulte Criando uma conta em GitHub e Quickstart para GitHub Copilot, respectivamente.

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

Instalar GitHub Copilot para Azure

Azure MCP está integrado ao Visual Studio 2022. Você precisa da carga de trabalho de desenvolvimento Azure instalada para acessar as ferramentas do MCP Azure.

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

   

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

2. Na guia Cargas de Trabalho, verifique se a carga de trabalho Azure desenvolvimento está selecionada.

   

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

4. Inicie Visual Studio 2022 e crie ou carregue um projeto.

5. Abra a Copilot Chat do GitHub.

6. Se solicitado, entre em sua conta GitHub.

7. Se solicitado, entre em sua conta 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 de Azure verificando os principais nós para Azure MCP Server v.x.x.x.

   

Escreva seu primeiro prompt

1. Se a janela chat ainda não estiver aberta, verifique se ela está 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, GitHub Copilot usa o modo ask. O modo de perguntas fornece respostas para suas solicitações no bate-papo. Agent modo permite que GitHub Copilot tome medidas em seu workspace.

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

Modo de agente

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

GitHub Copilot para Azure fornece "ferramentas" para o GitHub Copilot aprimorar a experiência do 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 desabilitar ou reabilitar 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 Azure e acesso a uma assinatura Azure. Para obter detalhes sobre como configurá-los, consulte a página de preços para contas do Azure.

• Uma conta GitHub e uma assinatura GitHub Copilot. Para obter detalhes sobre como configurá-los, consulte Criando uma conta em GitHub e Quickstart para GitHub Copilot, respectivamente.

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

Instalar GitHub Copilot para Azure

1. Se você já instalou o Visual Studio 2026 e deseja adicionar GitHub Copilot para Azure após a instalação inicial, abra Visual Studio Instalador e selecione o botão Modify, 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 Visual Studio 2026 e crie ou carregue um projeto.

5. Abra a Copilot Chat do GitHub.

6. Se solicitado, entre em sua conta GitHub.

7. Se solicitado, entre em sua conta 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 nós principais de Azure.

   

   Selecione também o nó principal de Azure MCP Server.

   

Escreva seu primeiro prompt

1. Se a janela chat ainda não estiver aberta, verifique se ela está 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, GitHub Copilot usa o modo ask. O modo de perguntas fornece respostas para suas solicitações no bate-papo. Agent modo permite que GitHub Copilot tome medidas em seu workspace.

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

Modo de agente

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

GitHub Copilot para Azure fornece "ferramentas" para o GitHub Copilot aprimorar a experiência do 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 desabilitar ou habilitar novamente 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).