Usare l'agente di piano GitHub Copilot

Usando l'agente di piano GitHub Copilot in Visual Studio, è possibile creare ed eseguire l'iterazione in un piano di implementazione prima di apportare modifiche al codice. L'agente di piano esplora la codebase usando strumenti di sola lettura, pone domande chiare quando necessario e crea una bozza di piano che è possibile esaminare e perfezionare usando Copilot.

A differenza della modalità agente, l'agente di piano non modifica i file o esegue i passaggi di implementazione durante la pianificazione. Quando si è soddisfatti del piano, è possibile passare alla modalità agente per eseguirla.

Prerequisiti

Quando usare l'agente di pianificazione

L'agente di piano è utile quando si vuole allinearsi a un approccio prima di iniziare l'implementazione.

  • Funzionalità di grandi dimensioni: suddividere il lavoro complesso in passaggi chiari e verificabili prima dell'avvio delle modifiche al codice.
  • Base di codice sconosciute: consentire Copilot esaminare la soluzione e spiegare i punti di tocco probabili prima di modificare qualsiasi elemento.
  • Collaborazione in team: condividere il piano markdown salvato per la revisione prima di consegnarlo per l'implementazione.

Inizia un piano

  1. Aprire la finestra Copilot Chat.

  2. Nel selettore dell'agente, selezionare Piano.

    Schermata di Copilot Chat con Plan selezionato nel menu a discesa mode.

  3. Inserisci un prompt che descriva ciò che vuoi creare, eseguire il refactoring o indagare.

  4. Copilot esplora la codebase con strumenti di sola lettura. Se l'attività è ambigua, chiede chiarimenti prima di elaborare un piano.

Rivedere e perfezionare il piano

Dopo aver raccolto un contesto sufficiente, Copilot crea un piano di implementazione che è possibile esaminare insieme in chat.

Schermata di Copilot Chat che mostra un piano di implementazione creato dall'agente di pianificazione.

Quando si esamina la bozza, è possibile chiedere Copilot a:

  • Suddividere un passaggio di grandi dimensioni in attività più piccole.
  • Aggiungere casi perimetrali o passaggi di convalida.
  • Riconsiderare i file o i componenti da modificare.
  • Rivedere l'ordine di implementazione.

È anche possibile modificare il piano direttamente selezionando Modifica markdown nella visualizzazione del piano o modificando manualmente il file del piano salvato nel repository.

Per le richieste semplici, Copilot potrebbe elaborare immediatamente il piano senza porre domande di completamento.

Gestire i piani salvati

Per impostazione predefinita, Copilot salva ogni piano come file markdown in .copilot/plans/plan-{title}.md. È possibile modificare il percorso di salvataggio in Tools>Options>GitHub>Copilot>Copilot Chat nella directory di output Plan.

Questo file del piano è la fonte autorevole per l'attività. È possibile:

  • Modificare il file markdown direttamente nell'editor.
  • Continuare a perfezionare il piano tramite chat.
  • Condividere il piano con i colleghi prima dell'avvio dell'implementazione.

Quando si modifica manualmente il file di piano, Copilot rileva le modifiche e mantiene sincronizzato lo stato della chat con il piano aggiornato.

Implementare il piano con la modalità agente

Quando si è pronti per passare dalla pianificazione all'esecuzione, selezionare Implementa piano.

Schermata di Copilot Chat che mostra la modalità agente mentre esegue un piano salvato.

Copilot passa il piano ad Agent Mode, che esegue i passaggi e inizia ad apportare modifiche al codice. Non vengono apportate modifiche all'implementazione fino a quando non si sceglie esplicitamente di implementare il piano.

Agente di pianificazione rispetto alla pianificazione in modalità agente

L'agente di piano e la pianificazione in modalità agente sono correlati, ma non sono la stessa funzionalità.

Caratteristica / Funzionalità Uso ottimale quando Behavior
Agente di pianificazione Si vuole allinearsi a un approccio prima dell'avvio dell'implementazione. Funziona come modalità di chat separata, esegue l’esplorazione usando strumenti di sola lettura, salva i file di pianificazione in .copilot/plans/ e passa il controllo usando Implement plan.
Pianificazione in modalità agente Hai già attivato la modalità agente e questa utilizza automaticamente la pianificazione strutturata all'interno della sessione per le attività complesse. Viene eseguito in modalità agente e tiene traccia dello stato di pianificazione dell'esecuzione durante la sessione.

Per informazioni dettagliate sulla pianificazione all'interno della modalità agente, vedere Pianificazione in modalità agente.