Introdução ao modo de agente do GitHub Copilot

Com o modo de agente do GitHub Copilot no Visual Studio, você pode usar a linguagem natural para especificar uma tarefa de alto nível. A IA cria um plano, faz edições de código, executa comandos de terminal, invoca ferramentas e aplica alterações em sua base de código. Ele monitora resultados, como resultados de build, falhas de teste de unidade ou saídas de ferramenta, e itera conforme necessário.

Ao contrário do modo de solicitação, o modo de agente não é interrompido após uma única resposta. Ele continua executando e refinando processos até que você atinja a meta no prompt ou sejam necessários mais dados.

Prerequisites

Você precisa do Visual Studio 2022 versão 17.14 ou posterior.

Usar o modo de agente

No modo de agente, o Copilot opera de forma autônoma e determina o contexto relevante para o prompt.

Siga estas etapas para iniciar:

1. Abra a janela do Copilot Chat, selecione Perguntar para expandir a lista suspensa do modo e, em seguida, selecione Agente.

   

2. Insira seu prompt e selecione Enviar ou selecionar a chave Enter para enviá-la. Você pode especificar um requisito de alto nível e não precisa especificar em quais arquivos trabalhar.

3. O modo de agente pode invocar várias ferramentas para realizar tarefas diferentes. Opcionalmente, selecione o ícone Ferramentas para configurar quais ferramentas adicionais o agente pode usar para responder à sua solicitação.

   

4. O Copilot solicita confirmação antes de executar um comando de terminal ou usar uma ferramenta que não está interna.

   

5. O Copilot detecta automaticamente problemas em edições de código ou comandos de terminal e, em seguida, executa uma ação. O processo é repetido até que os problemas sejam resolvidos.

6. À medida que o Copilot processa sua solicitação, ela transmite as edições de código sugeridas diretamente no editor. Examine as edições sugeridas e ou:

   • Mantenha ou descarte as edições sugeridas como um todo no Total de alterações na janela de chat.

     

   • Examine as diferenças de arquivo individuais e aplique-as seletivamente.

7. Se você quiser examinar as alterações de código individuais feitas pelo agente, poderá:

   • Examine a alteração específica em cada etapa.

     

   • Examine as alterações cumulativas da última vez em que as alterações foram mantidas ou desfeitas.

     

8. Continue iterando nas alterações de código para refinar as edições ou implementar mais recursos.

Entender as ferramentas do modo agente

O modo de agente pode usar as seguintes ferramentas para responder a uma solicitação:

• Ferramentas integradas
• Ferramentas do PROTOCOLO MCP (Model Context Protocol)

Para exibir e gerenciar as ferramentas disponíveis no modo de agente, selecione o ícone Ferramentas na janela de chat.

Com base no resultado de uma ferramenta, o Copilot pode invocar outras ferramentas para realizar a solicitação geral. Por exemplo, se uma edição de código resultar em erros de sintaxe no arquivo, o Copilot poderá explorar outra abordagem e sugerir diferentes alterações de código.

Ferramentas adicionais que você adiciona executando servidores MCP não são habilitadas automaticamente. Suas caixas de seleção são desmarcadas por padrão e você deve selecioná-las para ativar as ferramentas.

Gerenciar aprovações de ferramenta

Quando o Copilot invoca uma ferramenta, ele solicita confirmação para executar a ferramenta. O motivo é que as ferramentas podem ser executadas localmente em seu computador e executar ações que modifiquem arquivos ou dados.

Na janela de chat, após a invocação de uma ferramenta, use a lista suspensa Permitir para confirmar automaticamente a ferramenta específica para a sessão ou solução atual, ou para todas as invocações futuras.

Você pode redefinir as seleções de confirmação da ferramenta no painelOpções de >. Expanda a seção Todas as Configurações> doGitHub>Copilot>Tools.

Aceitar ou descartar edições

Copilot lista os arquivos editados na lista Total de alterações na janela de chat.

Selecione cada arquivo para examinar as alterações individualmente. Você pode manter ou desfazer edições feitas em cada parte do código.

Como alternativa, na lista Total de alterações , selecione Manter ou Desfazer para todas as edições feitas desde a última vez que você selecionou Manter ou Desfazer.

Reverter edições

Ao solicitar edições de código, convém reverter algumas alterações. Para reverter, selecione Restaurar ao lado do ponto de verificação antes do prompt que inclui alterações que você não deseja.

Atualmente, o agente Copilot do Visual Studio não dá suporte a desfazer ou refazer passo a passo.

Interromper uma solicitação de modo de agente

Para interromper uma solicitação em andamento, você pode cancelá-la. Cancelar uma solicitação interrompe todas as ferramentas em execução e comandos de terminal.

Para interromper um build, selecione Compilar na barra de ferramentas superior e, em seguida, selecione Cancelar. Ou use o atalho de teclado Ctrl+Break .

Planejamento no modo de agente (versão prévia)

Observação

O planejamento está disponível em versão prévia pública com o Visual Studio 2022 versão 17.14. Esse recurso está em desenvolvimento ativo e pode evoluir com base nos comentários do usuário.

O planejamento no modo de agente permite que o Copilot divida solicitações complexas ou de várias etapas em tarefas estruturadas e rastreáveis antes da execução.

Quando o Planejamento estiver ativo, Copilot:

• Cria um plano de markdown voltado para o usuário que descreve metas e progresso.
• Mantém um plano JSON interno (plan-{sessionId}.json) que serve como um scratchpad legível por LLM para acompanhamento de etapas, raciocínio e coordenação.

Essa estrutura ajuda o Copilot a se manter consistente, atualizar seu plano dinamicamente e fornecer aos desenvolvedores visibilidade do que ele está fazendo.

Como funciona

Análise de solicitação

Quando uma tarefa requer várias etapas, o Copilot entra no modo de planejamento.

Criação de plano

• Plano markdown: Descreve a tarefa, as etapas e o progresso em um formato legível.
• Plano JSON: um formato estruturado e legível por LLM que captura o mesmo plano em um formato legível por máquina. Esse arquivo JSON permite que o Copilot atualize e interprete o plano consistentemente entre turnos.

Execução e iteração

O Copilot executa cada etapa do plano, atualizando ambos os arquivos conforme ele prossegue.

• O plano de markdown é atualizado visivelmente no editor.
• O plano JSON evolui nos bastidores à medida que Copilot refina, reordena ou adapta as etapas.

Armazenamento

Ambos os arquivos são armazenados em C:\Users\username\AppData\Local\Temp\VisualStudio\copilot-vs.

Ferramentas usadas no Planejamento

Quando você habilita o Planejamento, um conjunto dedicado de ferramentas internas se torna ativo. Essas ferramentas coordenam como o Copilot cria, atualiza e finaliza os planos durante a execução.

Tool	Description
plan	Gera o plano estruturado inicial a partir da solicitação do usuário.
adapt_plan	Refina ou ajusta o plano com base em novos contextos ou comentários.
atualizar_progresso_do_plano	Atualiza o status de conclusão da etapa e sincroniza o estado do plano.
record_observation	Captura resultados de runtime ou insights que influenciam as próximas ações.
finish_plan	Finaliza o plano depois que todas as etapas são concluídas.

Essas ferramentas permitem que o Copilot gerencie fluxos de trabalho de várias etapas de forma incremental, mantenha o estado de execução e mantenha-se alinhado com a intenção do usuário.

Habilitar e gerenciar ferramentas de planejamento

Para habilitar o Planejamento:

1. Abra o painel Opções de Ferramentas> e expanda a seção All Settings>>Copilot>Copilot Chat.

2. Marque a caixa de seleção Habilitar Planejamento .

Depois de habilitar o planejamento, as ferramentas de planejamento aparecem na lista Ferramentas na janela de chat:

Você pode desabilitar seletivamente a ferramenta de planejamento definida diretamente na lista Ferramentas na janela de chat. Se você precisar desabilitar as ferramentas de planejamento, recomendamos desabilitar todas, não apenas uma. As alterações se aplicam imediatamente à sessão de chat atual.

Dica

Desabilitar ferramentas individuais permite que você experimente diferentes comportamentos de planejamento ou depure etapas específicas durante o desenvolvimento.

Limitações

• Os planos são armazenados temporariamente e excluídos quando a sessão termina, a menos que sejam salvos manualmente.
• Existe uma leve sobrecarga de latência devido ao rastreamento estruturado do estado.
• Alguns agentes especializados ainda podem não dar suporte ao planejamento.

Fornecer comentários

Estamos melhorando ativamente o planejamento no modo de agente. Compartilhe seus comentários, problemas de relatório ou sugira melhorias aqui: Planejamento no Copilot Chat – Comunidade de Desenvolvedores do Visual Studio

Perguntas frequentes

Qual visibilidade o modo de agente tem em meus arquivos?

O modo de agente só pode manipular:

• Arquivos locais que fazem parte da solução.
• Arquivos locais que estão no diretório de solução aberta ou em seus subdiretórios.

O modo de agente não pode acessar arquivos e diretórios excluídos por meio da exclusão de arquivo.

Para comandos de terminal, o modo de agente tem as mesmas permissões que o processo do Visual Studio em execução e não está limitado às restrições anteriores. Examine cuidadosamente os comandos de terminal propostos antes de executá-los.

Não vejo o modo de solicitação e o modo de agente na janela de Chat do Copilot

Execute as seguintes etapas de solução de problemas na ordem especificada:

1. Verifique se você está usando o Visual Studio 17.14 ou posterior.

   • Verifique a versão no Help>About Visual Studio.

   • Se você não estiver usando a versão 17.14 ou posterior, abra o Instalador do Visual Studio e atualize seu build.

2. Confirme se o modo Habilitar Agente na opção de painel de chat está selecionado.

   No painelOpções de >, expanda a seção All Settings>GitHub>Copilot>Copilot Chat e verifique se a opção está selecionada.

3. Tente reiniciar o Visual Studio.

Quando devo usar o modo de solicitação versus o modo de agente?

• O modo de pergunta é excelente quando você deseja 100% confiança de que nenhuma edição de código é feita, a menos que você selecione Explicitamente Aplicar ou copiar e colar o código por conta própria.
• O modo de agente pode lidar com as mesmas perguntas conceituais e gerar exemplos de código sem aplicá-las, juntamente com seus recursos de agente de edição de código.
• Se você quiser usar os recursos do MCP, deverá ter o modo de agente selecionado.

O que aconteceu com o Copilot Edits no Visual Studio?

O modo de agente é uma evolução das edições do Copilot, com maior capacidade de realizar iterações sobre erros, usar ferramentas e aplicar automaticamente alterações de código.

Como administrador, como posso controlar o uso do modo de agente para usuários do Visual Studio?

O modo de agente no Visual Studio é regido pelo sinalizador de recursos de visualização do Editor no painel do GitHub Copilot para administradores. Se o administrador desativar essa configuração, os usuários nessa assinatura não poderão usar o modo de agente no Visual Studio.

Para obter mais informações, consulte Gerenciando políticas e recursos para o GitHub Copilot em sua empresa.

Conteúdo relacionado

• edições do GitHub Copilot
• GitHub Copilot Gratuito