Partilhar via

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 da extensão GitHub Copilot for Azure no Visual Studio Code, para que você possa escrever seu primeiro prompt.

Pré-requisitos

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

Importante

O GitHub Copilot não está incluído nas Assinaturas do Visual Studio e é uma assinatura separada gerenciada pelo GitHub. Para perguntas sobre assinaturas e suporte do GitHub Copilot, consulte Assinaturas individuais ou Assinaturas comerciais.

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

    Captura de tela que mostra o menu Alternar bate-papo aberto e selecionando a opção do menu Abrir bate-papo.

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

    @azure Do I have any resources currently running?

    Captura de tela que mostra o estado padrão do modo de pergunta do painel de bate-papo com um prompt de exemplo.

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.

No modo de pergunta, a @azure parte indica que você deseja incluir o participante do chat do Azure na conversa. Ele define o escopo de seu prompt para um domínio específico, ou seja, sua conta do Azure.

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

Modo de agente

A partir do Visual Studio Code versão 1.99, o GitHub Copilot introduziu o modo agente, uma experiência de agente que pode executar tarefas em todo o espaço de trabalho do Visual Studio Code, fazendo edições, executando comandos de terminal e assim por diante.

O Copiloto do GitHub para Azure fornece "ferramentas" ao copiloto do GitHub para aprimorar a experiência de agente por meio da integração profunda com o Azure.

No modo de agente, você não precisa instruir o GitHub Copilot a usar o GitHub Copilot para Azure com o prefixo @azure .

Ativar o modo de agente

Talvez seja necessário habilitar o modo de agente.

  1. No Visual Studio Code, abra Configurações usando o ícone Gerenciar (engrenagem).

    Captura de tela que mostra o menu de configurações do Visual Studio Code selecionando o botão Gerenciar.

  2. Na barra de pesquisa das Configurações, procure por chat.agent.enabled.

  3. Marque a caixa ao lado de Agente de chat > : Ativado.

    Captura de tela que mostra a caixa de diálogo de configurações com as configurações filtradas para chat.agent.enabled.

Usar o modo de agente

Existem três modos: ask (padrão), edit e agente. Para usar o modo de agente, você deve selecioná-lo no painel de chat.

  1. No painel de chat, na caixa de diálogo, selecione a opção de modo e escolha Agente.

    Captura de tela que mostra o menu pop-up na caixa Bate-papo com Agente selecionado.

  2. O painel de bate-papo confirma que você está atualmente no modo de agente.

    Captura de tela que mostra o painel de bate-papo confirmando que você está agora no modo de agente.

  3. Para ver o modo de agente funcionando, 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 can assist you with various tasks using a range of tools. Here are the main tools I have available:

1. Search and Navigation
  Semantic search for code or documentation
  File search using glob patterns
  Text search (grep)
  List directory contents
  Read file contents
  List code usages/references

2. Code Editing and Analysis
  Insert edits into files
  Get errors in code files
  Test search (find test files)

3. Terminal and Git Operations
  Run commands in terminal
  Get terminal output
  Get Git diffs and changed files

4. Project Creation
  Create new workspaces
  Get project setup information
  Install VS Code extensions
  Create new Jupyter Notebooks

5. Web and API Tools
  Fetch webpage content
  Get VS Code API references

6. Azure Tools
  Azure development best practices
  Microsoft Learn documentation
  Azure resource management
  Azure authentication tools
  AI model deployment and management
  Azure Bicep schemas
  Service configuration and deployment
  Azure Developer CLI tools

Would you like me to explain any specific tool in more detail or help you with a particular task?

  4. A última entrada, Azure Developer CLI tools, pode ser empregada com 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 help you generate the Azure CLI command to list all your storage accounts ordered by location. Let me use the Azure CLI generator tool to get the correct syntax for this command.

To list all your storage accounts ordered by location in Azure, you can use the following Azure CLI command:

az storage account list --query "sort_by(@, &location)"

This command will:

1. Retrieve all storage accounts you have access to in your Azure subscription
2. Sort the results based on the location (Azure region) of each storage account
3. Display the full details of each storage account in the sorted order

If you'd prefer a more concise output focusing on specific fields, you could modify the query. For example, to show only the name and location in a table format:

az storage account list --query "sort_by(@, &location)[].[name,location]" -o table

Make sure you're logged into the Azure CLI before running this command. If you're not logged in yet, you can do so with az login.

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.

    Captura de ecrã do painel de chat com realce à volta do ícone da ferramenta.

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

    Captura de tela da lista de ferramentas no Visual Studio Code.

Práticas recomendadas para trabalhar no modo de agente

Para obter melhores resultados de agente, considere as seguintes práticas recomendadas.

  • Quando solicitado, adicione o copilot-instructions.md arquivo ao seu espaço de trabalho.

    Captura de tela da notificação de código do Visual Studio para adicionar o arquivo de instruções do copiloto ao espaço de trabalho.

  • Mantenha seus prompts o mais granulares possível. Em vez de um prompt como Generate a Python web application and deploy it to Azure, você deve dividir isso em alguns prompts, cada um com um escopo menor de responsabilidade.

  • Permita que o GitHub Copilot trabalhe (em vez de fazê-lo sozinho). Ocasionalmente, o GitHub Copilot pede permissão para executar uma tarefa com um botão "Continuar". Embora seja possível executar essa tarefa fora da janela de bate-papo, você deve permitir que o GitHub Copilot execute a tarefa. Isso permite que o GitHub Copilot mantenha o contexto do estado atual de seu plano maior.

  • Permita que o GitHub Copilot se repita. Ocasionalmente, o Copilot do GitHub pede permissão para executar uma tarefa repetidamente. Ele faz isso para entender melhor o estado dos arquivos de projeto e o que ele deve fazer em seguida. Você deve permitir que o GitHub Copilot repita as tarefas que precisa executar.

  • Expresse as suas preferências. Se o GitHub Copilot quiser executar uma ação, mas você preferir que ele execute uma ação diferente , você pode instruí-lo a fazê-lo da maneira que preferir. Por exemplo, se quiser criar uma pasta para conter arquivos chamados bicep \.azure, você pode intervir e sugerir que utilize uma pasta diferente com um prompt como:

    Instead of naming the folder `.azure`, please name it `infra`

Opcional: defina seu locatário padrão

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.

    Captura de tela que mostra o GitHub Copilot para Azure na lista de extensões no Visual Studio Code.

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

    Captura de tela que mostra o menu pop-up do GitHub Copilot for Azure.

  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.

    Captura de ecrã que mostra o separador Definições com uma opção para definir o inquilino do Azure Resource Graph.

Conteúdos relacionados