Usa o agente de planos do GitHub Copilot

Ao usar o agente de plano GitHub Copilot no Visual Studio, pode criar e iterar sobre um plano de implementação antes de fazer alterações no código. O agente do plano explora a sua base de código usando ferramentas de apenas leitura, faz perguntas esclarecedoras quando necessário e elabora um plano que pode rever e refinar usando o Copilot.

Ao contrário do modo agente, o agente do plano não edita ficheiros nem executa passos de implementação enquanto planeas. Quando estiver satisfeito com o plano, pode passá-lo para o modo agente para o executar.

Pré-requisitos

• Instala a versão mais recente do Visual Studio.
• Entre no Visual Studio usando uma conta do GitHub com acesso Copilot.

Quando utilizar o agente de planeamento

O agente do plano é útil quando se quer alinhar numa abordagem antes de começar a implementação.

• Grandes funcionalidades: Divida trabalhos complexos em passos claros e revisíveis antes de começarem as alterações ao código.
• Bases de código desconhecidas: Deixe-Copilot inspecionar a solução e explicar os prováveis pontos de contacto antes de editar qualquer coisa.
• Colaboração da equipa: Partilhe o plano em Markdown guardado para revisão antes de o passar para implementação.

Iniciar um plano

1. Abre a janela do Copilot Chat.

2. No seletor de agentes, selecione Plan.

   

3. Introduza um prompt que descreva o que quer construir, refatorar ou investigar.

4. O Copilot explora a sua base de código com ferramentas de apenas leitura. Se a tarefa for ambígua, coloca perguntas esclarecedoras antes de elaborar um plano.

Rever e refinar o plano

Depois de reunir contexto suficiente, o Copilot cria um plano de implementação que podem rever juntos no chat.

Ao rever o rascunho, pode pedir ao Copilot para:

• Divide um grande passo em tarefas mais pequenas.
• Adicione casos excecionais ou passos de validação.
• Reconsidere quais ficheiros ou componentes alterar.
• Revise a ordem de implementação.

Também pode editar o plano diretamente selecionando Editar markdown na vista do plano, ou editando manualmente o ficheiro de plano guardado no seu repositório.

Para pedidos simples, o Copilot pode elaborar o plano imediatamente, sem fazer perguntas de seguimento.

Trabalhar com planos guardados

Por defeito, Copilot guarda cada plano como ficheiro markdown em .copilot/plans/plan-{title}.md. Pode alterar a localização de gravação em Tools>Options>GitHub>Copilot>Copilot Chat no diretório de saída Plan.

Este ficheiro de planos é a fonte de verdade para a tarefa. É possível:

• Edita o ficheiro markdown diretamente no editor.
• Continua a refinar o plano através do chat.
• Partilhe o plano com os colegas antes de começar a implementação.

Quando editas manualmente o ficheiro do plano, o Copilot deteta as alterações e mantém o estado do chat sincronizado com o plano atualizado.

Implemente o plano com o modo agente

Quando estiver pronto para passar do planeamento à execução, selecione Implementar plano.

O Copilot passa o plano para o modo agente, que segue os passos e começa a fazer alterações no código. Não há alterações na implementação até que escolha explicitamente implementar o plano.

Agente de planeamento versus Planeamento em modo agente

O agente do Plano e o Planeamento em modo agente estão relacionados, mas não são a mesma funcionalidade.

Para detalhes sobre planeamento dentro do modo agente, veja Planeamento no modo agente.

Conteúdo relacionado

• Introdução ao GitHub Copilot
• Comece a usar o modo agente do Copilot do GitHub
• O que é o GitHub Copilot Edits?
• Personalize as respostas do chat e defina o contexto