Using plan mode in your IDE

Have Copilot research a task and draft an implementation plan for your review before any code is changed.

Tool navigation

Neste artigo

Introduction

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.

Plan mode is available in Visual Studio Code, JetBrains IDEs, Xcode, and Eclipse. It is not currently available in Visual Studio. Click the tabs above for instructions for your editor.

To run a task without planning it first, see Using agent mode in your IDE.

Using the plan agent

  1. If the chat view is not already displayed, select Open Chat from the Copilot Chat menu.

  2. At the bottom of the chat view, select Plan from the agents dropdown.

  3. Type a prompt that describes a task, such as adding a feature to an existing application, refactoring code, fixing a bug, or creating an initial version of a new application.

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

    After a few moments, the plan agent outputs a plan in the chat view. The plan provides a high-level summary and a breakdown of steps, including any open questions for clarification.

  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 Copilot Chat 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 Copilot Chat 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.

For more information, see Planning with agents in VS Code in the Visual Studio Code documentation.

Further reading

Using plan mode

  1. If it is not already displayed, open the Copilot Chat panel by clicking the GitHub Copilot Chat icon at the right side of the JetBrains IDE window.

  2. At the bottom of the Copilot Chat panel, select Plan from the agents dropdown.

  3. Type a prompt that describes a task, such as adding a feature to an existing application, refactoring code, fixing a bug, or creating an initial version of a new application.

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

  4. Submit the prompt.

    After a few moments, the plan agent outputs a plan in the chat panel. The plan provides a high-level summary and a breakdown of steps, including any open questions for clarification.

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

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

    • Clique em Iniciar Implementação para alternar Copilot Chat 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 Copilot Chat 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.

Further reading

Observação

Plan mode is currently in prévia pública and subject to change.

Using plan mode

  1. If it is not already displayed, open the Copilot Chat window by clicking Editor in the menu bar, then clicking GitHub Copilot then Open Chat.

  2. At the bottom of the Copilot Chat window, select Plan from the agents dropdown.

  3. Type a prompt that describes a task, such as adding a feature to an existing application, refactoring code, fixing a bug, or creating an initial version of a new application.

    For example: Create a simple to-do app with Swift files.

  4. Submit the prompt.

    After a few moments, the plan agent outputs a plan in the chat panel. The plan provides a high-level summary and a breakdown of steps, including any open questions for clarification.

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

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

    • Clique em Iniciar Implementação para alternar Copilot Chat 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 Copilot Chat 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.

Further reading

Observação

Plan mode is currently in prévia pública and subject to change.

Using plan mode

  1. If it is not already displayed, open the Copilot Chat panel by clicking the Copilot icon () in the status bar at the bottom of Eclipse, then clicking Open Chat.

  2. At the bottom of the chat panel, select Plan from the agents dropdown.

  3. Type a prompt that describes a task, such as adding a feature to an existing application, refactoring code, fixing a bug, or creating an initial version of a new application.

    For example: Create a simple to-do app using JavaFX.

  4. Submit the prompt.

    After a few moments, the plan agent outputs a plan in the chat panel. The plan provides a high-level summary and a breakdown of steps, including any open questions for clarification.

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

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

    • Clique em Iniciar Implementação para alternar Copilot Chat 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 Copilot Chat 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.

Further reading