Fazendo perguntas ao GitHub Copilot no seu IDE

Pré-requisitos

• Acesso a GitHub Copilot. Confira O que é GitHub Copilot?.
• Versão mais recente do Visual Studio Code. Confira a página de download do Visual Studio Code.
• Inicie a sessão do GitHub no Visual Studio Code. Se estiver enfrentando problemas de autenticação, confira Solução de problemas comuns com GitHub Copilot.

Se você tiver acesso ao GitHub Copilot por meio de sua organização ou empresa, não poderá usar o Copilot Chat do GitHub se o proprietário da organização ou o administrador corporativo tiver desabilitado a conversa. Confira Gerenciando políticas e recursos para GitHub Copilot em sua organização.

          Bate-papo do Copilot Agentes

Você pode usar Bate-papo do Copilot nos seguintes modos:

• Modo de agente: para fazer com que Copilot cumpram uma tarefa pré-determinada autonomamente.
• Modo de plano: para criar Copilot planos de implementação detalhados para garantir que todos os requisitos sejam atendidos.

•           [Modo Perguntar](#ask-mode): para obter respostas a perguntas de codificação e obter Copilot sugestões de código.
  

Para alternar entre os modos, use a lista suspensa dos agentes na parte inferior da janela de chat.

Modo de agente

Use o modo de agente quando tiver uma tarefa específica em mente e quiser habilitar o Copilot para editar seu código de modo autônomo. No modo de agente, o Copilot determina em quais arquivos fazer alterações, oferece alterações de código e comandos de terminal para concluir a tarefa e itera para corrigir problemas até que a tarefa original seja concluída.

O modo de agente é mais adequado para casos de uso em que:

• A tarefa é complexa e envolve várias etapas, iterações e tratamento de erro.
• Você deseja que o Copilot determine as etapas necessárias a serem tomadas para concluir a tarefa.
• A tarefa requer que o Copilot integre a aplicativos externos, como um servidor MCP.

Usando agentes

1. Se a visualização de chat não estiver já sendo exibida, selecione Abrir Chat no Bate-papo do Copilot menu.
2. Na parte inferior do modo de exibição de chat, verifique se o Agente está selecionado na lista suspensa de agentes.
3. Envie um prompt. Em resposta ao prompt, Copilot transmite as edições no editor, atualiza o conjunto de trabalho e, se necessário, executa comandos de terminal, se necessário.
4. Revise e itere sobre as alterações e/ou execute uma revisão de código.

Você também pode clique neste link para ir diretamente para o modo agente em VS Code.

Para obter mais informações, consulte a visão geral do Chat na Visual Studio Code documentação.

Quando você usa o modo de agente, cada prompt inserido conta como uma solicitação premium, multiplicada pelo multiplicador do modelo. Por exemplo, se você estiver usando o modelo incluído (que tem um multiplicador de 0), seus prompts não consumirão nenhuma solicitação premium. O Copilot pode executar várias ações de acompanhamento para concluir a tarefa, mas essas ações de acompanhamento não contam para o uso da solicitação Premium. Somente as solicitações inseridas são cobradas – as chamadas de ferramenta ou as etapas em segundo plano executadas pelo agente não são cobradas.

O número total de solicitações Premium que você usa depende de quantos prompts você insere e qual modelo você seleciona. Confira Solicitações no GitHub Copilot.

Usando subagentes

Você pode usar subagentes para delegar tarefas a um agente isolado com sua própria janela de contexto em sua sessão de chat. O Subagente opera de forma independente, sem pausar para receber feedback do usuário, e retorna o resultado final para a sessão de bate-papo principal.

Subagentes são mais adequados para situações em que:

• Você deseja delegar tarefas complexas e de várias etapas, como pesquisa ou análise, sem interromper sua sessão principal.
• Você precisa processar grandes quantidades de informações ou vários documentos que desorganizam sua janela de contexto principal.
• Você deseja explorar diferentes abordagens ou perspectivas de forma independente sem misturar contextos.

Subagentes usam as mesmas ferramentas e o mesmo modelo de IA da sessão principal, mas não podem criar outros subagentes.

Habilitando o subagentes

1.        Bate-papo do Copilot Na janela, clique no ícone de ferramentas.
   

2. Habilite a runSubagent ferramenta.

Se você usar arquivos de prompt personalizado ou agentes personalizados, especifique a ferramenta runSubagent na propriedade tools frontmatter. Consulte Criando agentes personalizados para agente de nuvem Copilot e Utilize arquivos de prompt no VS Code na Visual Studio Code documentação.

Chama-se subagentes

Subagentes podem ser invocados de maneiras diferentes:

• Delegação automática. Copilot analisará a descrição da sua solicitação, o campo de descrição dos seus agentes personalizados, o contexto atual, e as ferramentas disponíveis para escolher automaticamente um Subagente. Por exemplo, esse prompt delegaria automaticamente a tarefa a um especialista em refatoração agente personalizado:

  Suggest ways to refactor this legacy code.
  

• Invocação direta. Você pode chamar diretamente o Subagente em seu prompt:

  Use the testing subagent to write unit tests for the authentication module.
  

• Chamando a ferramenta #runSubagent.

  Evaluate the #file:databaseSchema using #runSubagent and generate an optimized data-migration plan.
  

Quando o Subagente concluir sua tarefa, seus resultados aparecerão novamente na sessão de chat principal, prontos para perguntas subsequentes ou próximas etapas.

Modo planejamento

O modo de plano ajuda você a criar planos de implementação detalhados antes de executá-los. Isso garante que todos os requisitos sejam considerados e resolvidos antes que quaisquer alterações de código sejam feitas. O agente de plano não faz nenhuma alteração de código até que o plano seja revisado e aprovado por você. Depois de aprovado, você pode entregar o plano ao agente padrão ou salvá-lo para mais refinamento, revisão ou discussões em equipe.

O agente de plano foi projetado para:

• Pesquise a tarefa de forma abrangente usando ferramentas somente leitura e análise de base de código para identificar requisitos e restrições.
• Divida a tarefa em etapas gerenciáveis e acionáveis e inclua perguntas abertas sobre requisitos ambíguos.
• Apresentar um rascunho de plano conciso, com base em um formato de plano padronizado, para revisão e iteração do usuário.

Usando o agente do plano

1. Se a visualização de chat não estiver já sendo exibida, selecione Abrir Chat no Bate-papo do Copilot menu.

2. Na parte inferior da janela de chat, selecione Planejamento na lista suspensa de agentes.

3. Digite um prompt que descreve uma tarefa, como adicionar um recurso a um aplicativo existente, refatorar código, corrigir um bug ou criar uma versão inicial de um novo aplicativo.

   Por exemplo: Create a simple to-do web app with HTML, CSS, and JS files.

   Após alguns instantes, o agente de plano gera um plano na janela de chat. O plano fornece um resumo de alto nível e um detalhamento das etapas, incluindo quaisquer perguntas abertas para esclarecimentos.

4. Examine o plano e responda a todas as perguntas feitas pelo agente.

   Você pode iterar várias vezes para esclarecer os requisitos, ajustar o escopo ou responder a perguntas.

5. Depois que o plano for concluído, você poderá:

   • Clique em Iniciar Implementação para alternar Bate-papo do Copilot para o modo de agente e iniciar uma sessão de agente para implementar as alterações necessárias, com base no plano de implementação.
   • Clique em Abrir no Editor para mudar Bate-papo do Copilot para o modo de agente e iniciar uma sessão de agente que gere Markdown, em uma guia do seu editor, incluindo os detalhes do plano de implementação. Você pode começar a trabalhar no plano por conta própria ou salvar o plano como um arquivo Markdown para uso posterior.

Para obter mais informações, consulte Planejamento com agentes no VS Code na Visual Studio Code documentação.

Modo de pergunta

O modo de pergunta é otimizado para responder perguntas sobre sua base de código, codificação e conceitos gerais de tecnologia. Use o modo de pergunta quando quiser entender como algo funciona, explorar ideias ou obter ajuda com tarefas de codificação.

Usando o agente de solicitação

1. Se a visualização de chat não estiver já sendo exibida, selecione Abrir Chat no Bate-papo do Copilot menu.
2. Na parte inferior da janela de chat, selecione Perguntar na lista suspensa de agentes.
3. Digite um prompt na caixa de prompt e pressione Enter.

Enviar prompts

Você pode dar ao agente uma descrição de alto nível do que você deseja construir, e ele começa a trabalhar. Cada tarefa é executada dentro de uma sessão de agente, uma conversa persistente que você pode acompanhar, pausar, retomar ou entregar a outro agente.

1. Para abrir o modo de exibição de chat, clique no ícone de chat na barra de título de Visual Studio Code. Se o ícone de chat não for exibido, clique com o botão direito do mouse na barra de título e verifique se o Centro de Comando está selecionado.

   

2. Digite um prompt na caixa de prompt. Para ver uma introdução aos tipos de prompts que você pode usar, confira Começando com prompts para o GitHub Copilot Chat no seu IDE.

3. Avalie Copilota resposta e faça uma solicitação de acompanhamento, se necessário.

   A resposta pode conter texto, blocos de código, botões, imagens, URIs e árvores de arquivos. A resposta geralmente inclui elementos interativos. Por exemplo, a resposta pode incluir um menu para inserir um bloco de código ou um botão para invocar um Visual Studio Code comando.

   Para ver os arquivos que Bate-papo do Copilot usou para gerar a resposta, selecione a lista suspensa de Usadas n referências na parte superior da resposta. As referências podem incluir um link para um arquivo de instruções personalizado para seu repositório. Esse arquivo contém informações extras que são adicionadas automaticamente a todas as suas perguntas de chat para aprimorar a qualidade das respostas. Para obter mais informações, consulte Adicionando instruções personalizadas do repositório para GitHub Copilot.

Usar palavras-chave em seu prompt

Você pode usar palavras-chave especiais para ajudar Copilot a entender seu prompt. Para ver exemplos, confira Começando com prompts para o GitHub Copilot Chat no seu IDE.

Participantes do chat

Os participantes do chat são como especialistas no domínio que têm uma especialidade com a qual podem ajudar você.

          Bate-papo do Copilot pode inferir participantes de chat relevantes com base em seu prompt de linguagem natural, melhorando a descoberta de funcionalidades avançadas sem que você precise especificar explicitamente o participante que deseja usar em seu prompt.

Como alternativa, você pode especificar manualmente um participante do chat para definir o escopo da solicitação para um domínio específico. Para fazer isso, digite @ na caixa de prompt de chat, seguido pelo nome de um participante do chat.

Para ver a lista de todos os participantes do chat disponíveis, digite @ na caixa de solicitação do chat. Consulte também guia rápido do GitHub Copilot Chat ou Participantes do Chat na Visual Studio Code documentação.

Comandos de barra "/"

Utilize comandos com barra para evitar escrever prompts complexos para cenários comuns. Para usar um comando de barra, digite / na caixa de prompt do chat, seguido de um comando.

Para ver todos os comandos de barra disponíveis, digite / na caixa de prompt do chat. Consulte também guia rápido do GitHub Copilot Chat ou comandos Slash na documentação Visual Studio Code.

Variáveis de chat

Use variáveis do chat para incluir contexto específico em seu prompt. Para usar uma variável do chat, digite # na caixa de prompt do chat, seguida de uma variável do chat.

Para ver todas as variáveis do chat disponíveis, digite # na caixa de prompt do chat. Consulte também guia rápido do GitHub Copilot Chat.

Usando as habilidades de GitHub para Copilot

As habilidades específicas do Copilot do GitHub expandem o tipo de informação que o Copilot pode fornecer. Para acessar essas habilidades no Bate-papo do Copilot, inclua @github em sua pergunta.

Quando você adiciona @github a uma pergunta, Copilot seleciona dinamicamente uma habilidade apropriada, com base no conteúdo da pergunta. Você também pode pedir explicitamente que o Bate-papo do Copilot use uma habilidade específica. É possível fazer isso de duas formas:

• Use linguagem natural para pedir que o Bate-papo do Copilot use uma habilidade. Por exemplo, @github Search the web to find the latest GPT model from OpenAI.
• Para invocar especificamente uma pesquisa na Web, você pode incluir a #web variável em sua pergunta. Por exemplo, @github #web What is the latest LTS of Node.js?

Você pode gerar uma lista de habilidades disponíveis atualmente fazendo a pergunta Copilot: @github What skills are available?

Usando servidores MCP (Model Context Protocol)

É possível usar o MCP para estender as funcionalidades do Bate-papo do Copilot integrando-o a uma ampla gama de ferramentas e serviços existentes. Para obter mais informações, confira Sobre o Protocolo de Contexto de Modelo (MCP).

Modelos de IA para Bate-papo do Copilot

Você pode alterar o modelo que o Copilot usa para gerar respostas para prompts de chat. Você pode achar que diferentes modelos têm um desempenho melhor ou fornecem respostas mais úteis, dependendo do tipo de perguntas feitas. As opções incluem modelos Premium com funcionalidades avançadas. Confira Alterando o modelo de IA para GitHub Copilot Chat.

Maneiras adicionais de acessar Bate-papo do Copilot

Além de enviar prompts por meio da exibição do chat, você pode enviar prompts de outras maneiras:

•           **Chat rápido:** para abrir a lista suspensa de chat rápido, pressione <kbd>Shift</kbd>+<kbd>Option</kbd>+<kbd>Command</kbd>+<kbd>L</kbd> (Mac)/<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>L</kbd> (Windows/Linux).
  

• Inline: Para iniciar um chat embutido diretamente no editor ou terminal integrado, insira Command+i (Mac) / Ctrl+i (Windows/Linux).
• Ações inteligentes: Para enviar prompts por meio do menu de contexto, clique com o botão direito do mouse no editor, selecione Copilot no menu exibido e selecione uma das ações. As ações inteligentes também podem ser acessadas por meio do ícone de brilho que às vezes aparece quando você seleciona uma linha de código.

Consulte chat embutido, chat rápido e ações inteligentes de chat na Visual Studio Code documentação para obter mais detalhes.

Usando imagens em Bate-papo do Copilot

Você pode anexar imagens aos prompts do chat e fazer perguntas ao Copilot sobre elas. Por exemplo, você pode anexar:

• Uma captura de tela de um trecho de código e pedir que o Copilot explique o código.
• Uma simulação da interface do usuário de um aplicativo e solicitar que o Copilot gere o código.
• Um fluxograma e pedir que o Copilot descreva os processos mostrados na imagem.
• Uma captura de tela de uma página da Web e pedir que o Copilot gere HTML para uma página semelhante.

Como anexar imagens ao seu prompt de chat

1. Realize um dos seguintes procedimentos:

   • Copie uma imagem e cole-a no modo de exibição de chat.
   • Arraste e solte um ou mais arquivos de imagem do explorador de arquivos do sistema operacional ou do Explorer em VS Code na janela de chat.
   • Clique com o botão direito do mouse em um arquivo de imagem no VS Code Explorer e clique Copilot em Adicionar Arquivo ao Chat.

2. Digite seu prompt na exibição de chat para acompanhar a imagem. Por exemplo, explain this diagram, describe each of these images in detail, what does this error message mean.

Compartilhando feedback

Para indicar se uma resposta foi útil, use os ícones polegares para cima e polegares para baixo que aparecem ao lado da resposta.

Para deixar feedback sobre a Copilot Chat do GitHub extensão, abra uma issue no repositório microsoft/vscode-copilot-release.

Leitura adicional

• Engenharia de prompts para o GitHub Copilot Chat

•           [Usando Bate-papo do Copilot em VS Code](https://code.visualstudio.com/docs/copilot/copilot-chat) e [Iniciando com GitHub Copilot em VS Code](https://code.visualstudio.com/docs/copilot/getting-started) na documentação Visual Studio Code
  

• Fazer perguntas ao GitHub Copilot no GitHub
• Uso responsável do GitHub Copilot Chat em seu IDE
• Termos do GitHub para produtos e recursos adicionais
• GitHub Copilot Central de Confiabilidade
• GitHub Copilot Perguntas Freqüentes

          Visual Studio 2022 versão 17.8 ou posterior**. Consulte [Instalar Visual Studio](https://learn.microsoft.com/visualstudio/install/install-visual-studio) na documentação Visual Studio.

          CopilotAs habilidades específicas de GitHub expandem o tipo de informação que Copilot pode fornecer. Para acessar essas habilidades em Bate-papo do Copilot em Visual Studio, inclua `@github` em sua pergunta.

          Copilot Edits permite que você faça alterações em vários arquivos de um único Bate-papo do Copilot prompt