Personalizzare le risposte di chat e impostare il contesto

È possibile chiedere a GitHub Copilot Chat di fornire suggerimenti sul codice, spiegare il codice, generare unit test e suggerire correzioni del codice. La chat in Visual Studio può fornire risposte e generare codice che corrisponda alle procedure di codifica e ai requisiti del progetto, se si fornisce il contesto corretto. Invece di aggiungere ripetutamente queste informazioni in ogni richiesta di chat, è possibile archiviare questo contesto nei file e includerlo automaticamente in ogni richiesta di chat.

In questo articolo si apprenderà come ottenere risposte migliori fornendo altre informazioni a Copilot Chat:

• Usare i comandi slash per specificare rapidamente attività comuni come /explain ottenere spiegazioni del codice
• Usare l'esperienza di chat guidata per perfezionare il contesto
• Usare istruzioni personalizzate e file di richiesta per personalizzare le risposte

Altre informazioni sullo sviluppo assistito da intelligenza artificiale in Visual Studio e su come usare Copilot Chat in Visual Studio.

Prerequisiti

Per iniziare a usare GitHub Copilot Chat in Visual Studio, è necessario:

• Visual Studio 2022 versione 17.10 o successiva
• Accedere a Visual Studio usando un account GitHub con accesso Copilot
  ^** È possibile iscriversi gratuitamente a GitHub Copilot.

Il supporto per GitHub Copilot Chat è fornito da GitHub e può essere raggiunto all'indirizzo https://support.github.com.

Richiesta di indicazioni

L'esperienza di chat guidata in Visual Studio 17.12 e versioni successive consente di perfezionare le richieste per chiarire il contesto per ottenere risposte migliori. GitHub Copilot Chat consente ora di chiarire le domande quando il contesto non è chiaro.

Usare istruzioni personalizzate

La funzionalità istruzioni personalizzate consente di aggiungere automaticamente dettagli contestuali prespecificati alle domande di chat. La chat di Copilot usa queste istruzioni personalizzate in base al contesto specifico, ad esempio il funzionamento del team, gli strumenti usati o le specifiche del progetto durante la generazione di risposte.

Usare un file .github/copilot-instructions.md

Per usare un .github/copilot-instructions.md file:

1. Creare/aggiungere un file di istruzioni personalizzato .github/copilot-instructions.md nella radice del repository.

2. Abilitare la funzionalità in Visual Studio dal riquadro Opzioni strumenti>. Espandere la sezione Tutte le impostazioni>GitHub>Copilot>Chat e selezionare la casella di controllo Abilita il caricamento di istruzioni personalizzate dai file .github/copilot-instructions.md e aggiungerle alle richieste.

Le istruzioni personalizzate non sono visibili nella visualizzazione Chat o nella chat inline. Tuttavia, se usato da Copilot, il file.github/copilot-instructions.md è elencato nell'elenco Riferimenti di una risposta.

Usare i file .instructions.md

Invece di usare un singolo file di istruzioni applicabile a tutte le richieste di chat, è possibile creare più *.instructions.md file che si applicano a tipi o attività di file specifici. Ad esempio, è possibile creare file di istruzioni per diversi linguaggi di programmazione, framework o tipi di progetto.

Per usare un .github/instructions/*.instructions.md file:

1. Creare la .github/instructions directory se non esiste già.

2. Aggiungere uno o più .github/instructions/*.instructions.md file.

3. Aggiungere la applyTo proprietà nella sezione frontmatter del file di istruzioni. Usare la sintassi GLOB per specificare i file o le cartelle a cui si applicano le istruzioni.

4. Abilitare la funzionalità in Visual Studio.

   Nel riquadro Strumenti>Opzioni, espandere la sezione Tutte le impostazioni>GitHub>Copilot>Chat e selezionare la casella di controllo Abilita il caricamento di istruzioni personalizzate dai file .github/copilot-instructions.md e la loro aggiunta alle richieste.

Formato del file delle istruzioni

I file di istruzioni di destinazione usano l'estensione .instructions.md e hanno questa struttura:

• Intestazione (facoltativo): frontmatter YAML
  • description: Descrizione visualizzata al passaggio del mouse nella visualizzazione Chat
  • applyTo: modello Glob che corrisponde ai file o alle cartelle a cui si desidera applicare le istruzioni
• Corpo: istruzioni in formato Markdown

Example

Ecco un'istruzione personalizzata C# di esempio:

## C# Instructions
---
applyTo: `**/*.cs`
---

- Write clear and concise comments for each function.
- Use PascalCase for component names, method names, and public members.
- Use camelCase for private fields and local variables.
- Add a newline before the opening curly brace of any code block  
  (such as after `if`, `for`, `while`, `foreach`, `using`, `try`, etc.).
- Ensure that the final `return` statement of a method is on its own line.

Copiare queste istruzioni nel .github/instructions/*.instructions.md file per usarle e applicarle automaticamente al comportamento di Copilot.

Per altri esempi di istruzioni personalizzate, vedere l'elenco di esempi di istruzioni in GitHub.

Funzionamento dei file di istruzioni

Quando si inizia a usare Copilot, rileva automaticamente quali file di istruzioni sono rilevanti per il contesto corrente e li allega come riferimenti. In questo modo, i suggerimenti di Copilot sono sempre allineati alle regole del progetto, indipendentemente dal punto in cui si lavora nella codebase.

I file di istruzioni usati da Copilot sono elencati nell'elenco Riferimenti della risposta.

Usare i file di richiesta

È ora possibile creare file di prompt riutilizzabili nel repository per eseguire o condividere le richieste usate di frequente.

Per creare un file di prompt:

1. Scrivere le richieste come si farebbe normalmente nella casella di richiesta, usando # riferimenti per includere informazioni specifiche della soluzione, ad esempio metodi, classi e file. È anche possibile fare riferimento ad altri file di richiesta per istruzioni condivise.
2. Copiare il prompt in un file markdown e salvarlo con l'estensione .prompt.md nella cartella .github/prompts nella directory principale del repository.

Per usare un file prompt:

1. Digitare #prompt: nell'input della chat per fare riferimento a qualsiasi file di prompt dalla cartella .github/prompts, o fare clic sull'icona ➕ all'interno dell'input della chat per aggiungerla come contesto.
2. Aggiungere eventuali dettagli aggiuntivi o semplicemente immettere il prompt così come è.

Screenshot dell'uso dei file prompt in GitHub Copilot Chat.

Usare i comandi slash per impostare il contesto per le attività comuni

I comandi Slash in Copilot Chat consentono di impostare rapidamente la finalità per le attività di sviluppo comuni. Usando comandi di barra specifici per formare la domanda, è possibile ottenere risposte migliori senza dover scrivere domande lunghe.

È possibile usare i comandi slash in una finestra di chat o direttamente nel codice che si desidera modificare, utilizzando l'assistenza per il codice inline . I comandi che consentono di modificare o aggiungere al file di codice aperto nell'editor funzionano sia nell'assistente codice inline che nelle finestre di chat, mentre i comandi per domande di codifica più generali funzionano solo nel riquadro della chat.

comando	Utilizzo	finestra chat	chat in linea
/dottore	Aggiungere commenti per il codice specificato o selezionato. Esempi: - /doc DeleteBasketAsync method in BasketService.cs : selezionare il codice desiderato e immettere /doc	Sì	Sì
/spiegare	Ottenere spiegazioni del codice. Esempi: - /explain the AddItemToBasket method in BasketService.cs : selezionare il codice desiderato e immettere /explain	Sì	Sì
/correzione	Proporre una correzione per i problemi nel codice selezionato. Esempi: - /fix the SetQuantities method in BasketService.cs : selezionare il codice desiderato e immettere /fix	Sì	Sì
/generare	Generare il codice per rispondere alla domanda specificata. Esempio: /generate code to add two numbers in Calculator.cs	Sì	Sì
/aiuto	Ottenere assistenza sull'uso di Copilot Chat. Esempio: /help	Sì	Sì
/ottimizzare	Analizzare e migliorare il tempo di esecuzione del codice selezionato. Esempi: - /optimize the AddItemToBasket method in BasketService.cs : selezionare il codice desiderato e immettere /optimize	Sì	Sì
/Test	Creare unit test per il codice selezionato. Esempio: selezionare il codice desiderato e immettere /tests using XUnit Framework Per .NET, è consigliabile testare GitHub Copilot per .NET	Sì	Sì

Con Visual Studio 2022 versione 17.13, quando l'utente digita un comando slash, il comando estende il prompt in linguaggio naturale per mostrare il contesto per il comando.

Usare le azioni di Copilot

È possibile usare le azioni di Copilot dal menu di scelta rapida per accedere rapidamente a prompt preconfigurati e comandi barra per le attività di sviluppo comuni.

Il comportamento di ogni azione dipende dal fatto che sia stato selezionato il codice quando si apre il menu di scelta rapida:

Action	Con il codice selezionato	Senza codice selezionato
Spiega	Illustra il codice selezionato	Illustra il codice vicino alla posizione del cursore
Ottimizza selezione	Ottimizza il codice selezionato per prestazioni, manutenibilità, affidabilità e architettura	Non applicabile
Generare commenti	Genera commenti per il codice selezionato	Generare commenti per il codice vicino alla posizione del cursore
Generare test	Genera test per il codice selezionato	Generare test per il codice vicino alla posizione del cursore
Aggiungi alla chat	Aggiunge il codice selezionato a Chat come riferimento	Aggiungere l'intero file a Chat come riferimento

Quando si seleziona un'azione ad eccezione di Ottimizza selezione, la finestra della chat si apre automaticamente e invia un comando slash a Copilot con il contesto delimitato appropriato. È quindi possibile esaminare e interagire con la risposta di Copilot nella finestra della chat.

Usare l'opzione Ottimizza selezione per migliorare il codice

Selezionare una sezione specifica del codice e scegliere Ottimizza selezione per fare in modo che Copilot analizzi e migliori solo quella sezione, anziché un intero file.

Copilot esamina il codice selezionato e il contesto circostante per fornire suggerimenti significativi e consapevoli del contesto. L'ottimizzazione mantiene lo stile, la struttura e le funzionalità del codice esistenti, mantenendo la codebase organizzata e coerente. A differenza di altre azioni che usano il pannello della chat, Ottimizza selezione presenta suggerimenti come differenze inline che è possibile esaminare, accettare o rifiutare direttamente.

Copilot offre suggerimenti di ottimizzazione in queste aree:

• Prestazione: Algoritmi più veloci, utilizzo ridotto della memoria, modelli asincroni
• Manutenibilità: Logica semplificata, struttura più chiara, denominazione migliore
• Affidabilità: Gestione degli errori, pulizia delle risorse, thread safety
• Architettura: Inserimento delle dipendenze, interfacce migliori, progettazione modulare

Passaggi successivi

• Esperienza di GitHub Copilot per Visual Studio
• esperienza di chat copilot di GitHub per Visual Studio
• Centro di fiducia di GitHub Copilot
• Inviare suggerimenti, feedback e problemi
• supporto di per la chat di GitHub Copilot
• Come usare GitHub Copilot: prompt, suggerimenti e casi d'uso