Comece a usar o GitHub Copilot para Azure

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

Pré-requisitos

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

• Uma conta Azure e acesso a uma subscrição Azure. Para detalhes sobre como configurá-las, consulte a página de preços para contas Azure.

• Uma conta no GitHub e uma subscrição do GitHub Copilot. Para detalhes sobre como os configurar, veja Criar uma conta no GitHub e Quickstart para GitHub Copilot, respetivamente.

• Visual Studio Code. Para detalhes sobre como descarregar e instalar, veja Configurar Visual Studio Code.

• A extensão GitHub Copilot e a extensão GitHub Copilot Chat. Para instruções sobre como instalar estas extensões, veja Configurar GitHub Copilot em VS Code e Começar com GitHub Copilot Chat em VS Code, respetivamente.

Importante

GitHub Copilot é uma subscrição separada gerida pelo GitHub. Para questões relacionadas com subscrições GitHub Copilot e Suporte, consulte Como começar com um plano GitHub Copilot.

Por padrão, o Copilot no Azure está disponível para todos os utilizadores em um inquilino. No entanto, os Administradores Globais podem gerir o acesso ao Copilot no Azure para a sua organização. O acesso pode também ser concedido opcionalmente a utilizadores ou grupos específicos da Microsoft Entra. Para mais informações, consulte Gerir o acesso a Microsoft Copilot em Azure.

Instalar o GitHub Copilot para Azure

1. No Visual Studio Code, selecione o ícone Extensões.
2. No Mercado de Extensões, pesquise por GitHub Copilot para Azure. Quando aparecer a GitHub Copilot para Azure extensão, selecione Install.
3. Se for solicitado, inicie sessão na sua conta 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 à tua pergunta depende do que está atualmente a correr no Azure na tua subscrição.

4. Em seguida, use o seguinte prompt:

   What are your tools?
   

   A resposta de conclusão mostra uma lista de ferramentas específicas do GitHub Copilot para o 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 comandos sobre ferramentas específicas do Azure, experimente o seguinte comando:

   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

Pode querer desativar ou reativar certas ferramentas disponíveis pelo 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 ativar/desabilitar ferramentas (ou grupos de ferramentas).

   

Definir o inquilino predefinido

Se tiver vários inquilinos Microsoft Entra ID, pode definir um inquilino padrão usando o seguinte prompt:

@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 Atividade, selecione Extensões. Depois desce 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. No separador Settings, defina o inquilino Azure Resource Graph para o seu ID de inquilino Microsoft Entra. Pode encontrar o seu ID de inquilino Microsoft Entra no portal Azure.

   

Veja o ficheiro de instruções do GitHub Copilot para Azure

O ficheiro instructions (também referido como "Diretrizes Azure Copilot") contém orientações de alto nível para GitHub Copilot que são adicionadas à janela de contexto ao enviar prompts para GitHub Copilot para ferramentas Azure e ferramentas Azure MCP Server. As orientações deste ficheiro destinam-se a ser de natureza global, ou seja, destinam-se a todas as interações entre o 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. Não deve modificar este ficheiro porque pode degradar ou desativar o GitHub Copilot para Azure, e as suas alterações podem ser sobrescrevidas por novas atualizações do GitHub Copilot para Azure.

Consultar as "Diretrizes Azure Copilot" pode fornecer uma perspetiva sobre como as ferramentas GitHub Copilot para Azure e as ferramentas Azure MCP Server são introduzidas ao GitHub Copilot, ajudando-o assim 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 Azure e acesso a uma subscrição Azure. Para detalhes sobre como configurá-las, consulte a página de preços para contas Azure.

• Uma conta no GitHub e uma subscrição do GitHub Copilot. Para detalhes sobre como os configurar, veja Criar uma conta no GitHub e Quickstart para GitHub Copilot, respetivamente.

• Visual Studio 2022 (qualquer edição). Para detalhes sobre como descarregar e instalar, veja Install Visual Studio.

Importante

GitHub Copilot é uma subscrição separada gerida pelo GitHub. Para questões relacionadas com subscrições GitHub Copilot e Suporte, consulte Como começar com um plano GitHub Copilot.

Instalar o GitHub Copilot para Azure

O Azure MCP está integrado no Visual Studio 2022. Precisas de instalar a carga de trabalho de desenvolvimento do Azure para aceder às ferramentas MCP do Azure.

1. Se já instalaste Visual Studio 2022 e queres adicionar GitHub Copilot para Azure após a instalação inicial, abre Visual Studio Instalador e seleciona o botão Modificar, que mostra as cargas de trabalho disponíveis.

   

   Se estiver a instalar o Visual Studio 2022 pela primeira vez, o Instalador do Visual Studio mostra automaticamente as cargas de trabalho disponíveis.

2. No separador Cargas de Trabalho, certifique-se de que a carga de trabalho Azure desenvolvimento está selecionada.

   

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

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

5. Abra o GitHub Copilot Chat.

6. Se for solicitado, inicie sessão na sua conta GitHub.

7. Se for solicitado, inicie sessão na sua conta Azure.

8. Na área de chat, selecione o botão Selecionar ferramentas (ícone de duas chaves) para mostrar uma lista das ferramentas disponíveis. Ative todas as ferramentas de Azure verificando os nós superiores para Azure MCP Server v.x.x.x.

   

Observação

As ferramentas MCP do Azure estão desativadas por defeito no Visual Studio 2022 e precisam de ser ativadas manualmente antes de serem usadas. As ferramentas específicas para VS que estão disponíveis no Visual Studio 2026 não estão incluídas no Visual Studio 2022.

Escreva o seu primeiro prompt

1. Se a janela do Chat ainda não estiver aberta, certifique-se de que está aberta selecionando a opção de menu View>GitHub Copilot Chat. 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 defeito, o GitHub Copilot usa o modo ask. O modo Perguntar fornece respostas às suas solicitações no painel de chat. O modo Agent permite ao GitHub Copilot tomar ações no seu espaço de trabalho.

A resposta à tua pergunta depende do que está atualmente a correr no Azure na tua subscrição.

Modo de agente

No modo Agente, o GitHub Copilot pode executar tarefas em todo o seu espaço de trabalho do Visual Studio, fazendo edições, executando comandos de terminal, entre outros.

O GitHub Copilot para Azure fornece "ferramentas" ao GitHub Copilot para melhorar a experiência agente através 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

Pode querer desativar ou reativar certas ferramentas disponíveis pelo 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 ativar/desabilitar ferramentas (ou grupos de ferramentas).

Pré-requisitos

• Uma conta Azure e acesso a uma subscrição Azure. Para detalhes sobre como configurá-las, consulte a página de preços para contas Azure.

• Uma conta no GitHub e uma subscrição do GitHub Copilot. Para detalhes sobre como os configurar, veja Criar uma conta no GitHub e Quickstart para GitHub Copilot, respetivamente.

• Visual Studio 2026 (qualquer edição). Para detalhes sobre como descarregar e instalar, veja Install Visual Studio.

Importante

GitHub Copilot é uma subscrição separada gerida pelo GitHub. Para questões relacionadas com subscrições GitHub Copilot e Suporte, consulte Como começar com um plano GitHub Copilot.

Instalar o GitHub Copilot para Azure

1. Se já instalaste Visual Studio 2026 e quiseres adicionar GitHub Copilot para Azure após a instalação inicial, abre Visual Studio Instalador e seleciona o botão Modificar, que mostra as cargas de trabalho disponíveis.

   

   Se estiver a instalar o Visual Studio 2026 pela primeira vez, o Instalador do Visual Studio mostra automaticamente as cargas de trabalho disponíveis.

2.  No separador Workloads, certifique-se de que está selecionado "Desenvolvimento do Azure IA".

   

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

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

5. Abra o GitHub Copilot Chat.

6. Se for solicitado, inicie sessão na sua conta GitHub.

7. Se for solicitado, inicie sessão na sua conta 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. Ative todas as ferramentas do Azure ao verificar os nós principais do Azure.

   

   Também selecione o nó superior para Azure MCP Server.

   

Escreva o seu primeiro prompt

1. Se a janela do Chat ainda não estiver aberta, certifique-se de que está aberta selecionando a opção de menu View>GitHub Copilot Chat. 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 defeito, o GitHub Copilot usa o modo ask. O modo Perguntar fornece respostas às suas solicitações no painel de chat. O modo Agent permite que o GitHub Copilot aja no seu espaço de trabalho.

A resposta à tua pergunta depende do que está atualmente a correr no Azure na tua subscrição.

Modo de agente

No modo Agente, o GitHub Copilot pode executar tarefas em todo o seu espaço de trabalho do Visual Studio, fazendo edições, executando comandos de terminal, entre outros.

O GitHub Copilot para Azure fornece "ferramentas" ao GitHub Copilot para melhorar a experiência agente através 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

Pode querer desativar ou reativar certas ferramentas disponíveis pelo 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 ativar/desabilitar ferramentas (ou grupos de ferramentas).

Conteúdos relacionados

• Compreender o que é GitHub Copilot para Azure e como funciona.
• Siga o quickstart para perceber como incluir GitHub Copilot para Azure no seu fluxo de trabalho de desenvolvimento de software. O quickstart descreve como implementar serviços no Azure, monitorizar o seu estado e resolver problemas.
• Veja exemplos de prompts para aprender mais sobre Azure e compreender a sua conta de Azure, subscrição e recursos.
• Veja exemplos de prompts para design e desenvolvimento de aplicações para Azure.
• Veja exemplos de prompts para implantação da sua aplicação no Azure.
• Veja exemplos de prompts para resolução de problemas dos seus recursos do Azure.