Introdução ao modo de agente do GitHub Copilot

Com o modo de agente do GitHub Copilot no Visual Studio, você pode usar 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 toda a sua base de código. Ele monitora resultados, como resultados de compilação, falhas de teste de unidade ou saídas de ferramentas, e itera conforme necessário.

Ao contrário do modo ask, o modo agente não para após uma única resposta. Ele continua executando e refinando etapas até que você atinja o objetivo em seu prompt ou mais entradas sejam necessárias.

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 sua solicitação.

Siga estes passos para começar:

1. Abra a janela Copilot Chat, selecione Perguntar para expandir o menu suspenso do modo e, em seguida, selecione Agente.

   

2. Digite seu prompt e selecione Enviar ou selecione a tecla Enter para enviá-lo. 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 copiloto solicita confirmação antes de executar um comando de terminal ou usar uma ferramenta que não esteja incorporada.

   

5. O Copilot deteta automaticamente problemas em edições de código ou comandos de terminal e, em seguida, toma medidas. O processo se repete até que os problemas sejam resolvidos.

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

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

     

   • Reveja diferenciais de arquivos individuais e aplique-os seletivamente.

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

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

     

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

     

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

Compreender as ferramentas do modo de agente

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

• Ferramentas incorporadas
• Ferramentas MCP (Model Context Protocol)

Para visualizar 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 alterações de código diferentes.

As 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 ferramentas

Quando o Copilot invoca uma ferramenta, ele solicita confirmação para executá-la. O motivo é que as ferramentas podem ser executadas localmente em sua máquina e executar ações que modificam arquivos ou dados.

Na janela de chat, após invocar uma ferramenta, utilize o menu suspenso Permitir para confirmar automaticamente a ferramenta específica para a sessão ou solução atual, ou para todas as utilizações futuras.

Você pode redefinir as seleções de confirmação de ferramentas no painelOpções de>. Expanda a seção Todas as configurações>do GitHub>Copilot>Tools .

Aceitar ou descartar edições

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

Selecione cada arquivo para revisar 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 as alterações que você não deseja.

Atualmente, o agente do Visual Studio Copilot não oferece suporte para realizar desfazer ou refazer passo-a-passo.

Interromper uma solicitação de modo de agente

Para interromper um pedido em curso, pode cancelá-lo. O cancelamento de uma solicitação interrompe todas as ferramentas em execução e os comandos do terminal.

Para parar uma compilação, 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 (Visualização)

Observação

O planejamento está disponível em visualização pública com o Visual Studio 2022 versão 17.14. Este recurso está em desenvolvimento ativo e pode evoluir com base no feedback dos usuários.

O planejamento no modo 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, o Copiloto:

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

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

Como funciona

Solicitar análise

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

Criação de planos

• Plano de marcação: descreve a tarefa, as etapas e o progresso em um formato legível.
• Plano JSON: um formato estruturado, legível por LLM, que captura o mesmo plano em formato analisável por máquina. Este arquivo JSON permite que o Copilot atualize e interprete o plano de forma consistente em todos os turnos.

Execução e iteração

O Copilot executa cada etapa do plano, atualizando ambos os arquivos à medida que prossegue.

• O plano de markdown é atualizado de forma visível no editor.
• O plano JSON evolui nos bastidores à medida que o Copilot refina, reordena ou adapta etapas.

Armazenamento

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

Ferramentas utilizadas no Planeamento

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

Tool	Description
Plano	Gera o plano estruturado inicial a partir da solicitação do usuário.
adapt_plan	Refina ou ajusta o plano com base em novo contexto ou feedback.
atualizar_progresso_plano	Atualiza o status de conclusão da etapa e sincroniza o estado do plano.
Gravar_observação	Captura resultados de tempo de execução ou insights que influenciam as próximas ações.
concluir_plan	Finaliza o plano assim que todas as etapas forem 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 permaneça alinhado com a intenção do usuário.

Habilitando e gerenciando ferramentas de planejamento

Para habilitar o Planejamento:

1. Abra o painelOpções de > e expanda a seção All Settings>GitHub>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 desativar seletivamente o conjunto de ferramentas de planejamento diretamente na lista Ferramentas na janela de chat. Se você precisar desativar as ferramentas de planejamento, recomendamos desativar todas, não apenas uma. As alterações aplicam-se imediatamente à sua sessão de chat atual.

Sugestão

A desativação de 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 ligeira sobrecarga de latência devido à monitorização estruturada do estado.
• Alguns agentes especializados podem ainda não dar suporte ao planejamento.

Enviar comentários

Estamos melhorando ativamente o planejamento no modo de agente. Compartilhe seus comentários, relate problemas ou sugira melhorias aqui: Planejando no bate-papo do Copilot – Comunidade de desenvolvedores do Visual Studio

Perguntas frequentes

Que visibilidade tem o modo agente nos meus ficheiros?

O modo de agente pode manipular apenas:

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

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

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. Analise cuidadosamente os comandos de terminal propostos antes de executá-los.

Não vejo o modo ask e o modo agent na janela Copilot Chat

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

1. Certifique-se de que está a utilizar o Visual Studio 17.14 ou posterior.

   • Verifique a versão em Ajuda>sobre o Visual Studio.

   • Se você não estiver usando a versão 17.14 ou posterior, abra o instalador do Visual Studio e atualize sua compilação.

2. Confirme se a opção Ativar modo Agente no painel de chat está selecionada.

   No painelFerramentas>Opções, expanda a secção Todas as definições>GitHub>Copilot>Copilot Chat e verifique se a opção está selecionada.

3. Tente reiniciar o Visual Studio.

Quando devo usar o modo ask vs. o modo agente?

• O modo Ask é excelente quando você quer 100% confiança de que nenhuma edição de código é feita, a menos que você selecione explicitamente Aplicar ou copie e cole 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á-los, 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 as edições do Copilot no Visual Studio?

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

Como administrador, como faço para 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 dessa 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

• Copiloto do GitHub edita
• GitHub Copilot Grátis