Condividi tramite

Usare agenti predefiniti e personalizzati con GitHub Copilot

Visual Studio include un set di agenti predefiniti curati che si integrano in modo approfondito con funzionalità dell'IDE, ad esempio debug, profilatura e test. È anche possibile creare agenti personalizzati su misura per il funzionamento del team.

Prerequisiti

Accedere agli agenti personalizzati

È possibile accedere agli agenti personalizzati in due modi:

  • Agent picker: nella finestra Copilot Chat selezionare l'elenco a discesa selezione agente per visualizzare gli agenti disponibili. Attualmente, questa opzione è disponibile solo nella build Visual Studio 2026 Insiders.
  • Sintassi @: digitare seguito dal nome dell'agente nell'input della chat (ad esempio, ).

È possibile accedere agli agenti personalizzati usando la sintassi @: digitare @ seguito dal nome dell'agente nel campo di input della chat (ad esempio, ).

Screenshot che mostra il selettore agenti con agenti personalizzati in Visual Studio.

Screenshot che mostra la selezione agente con agenti personalizzati.

Agenti integrati

Ogni agente predefinito è progettato intorno a un flusso di lavoro di sviluppo specifico e si integra con gli strumenti nativi di Visual Studio in modi che un assistente generico non può.

Agente Descrizione
@debugger Va oltre la lettura dei messaggi di errore. Usa gli stack di chiamate, lo stato delle variabili e gli strumenti di diagnostica per analizzare sistematicamente la diagnosi degli errori nella tua soluzione.
@profiler Si connette all'infrastruttura di profilatura di Visual Studio per identificare i colli di bottiglia e suggerire ottimizzazioni mirate basate sulla tua codebase, non consigli generici.
@test Genera test unitari ottimizzati per il framework e i modelli del tuo progetto, non boilerplate che il tuo sistema di integrazione continua rifiuterà.
@modernize (solo .NET e C++) Gestisce gli aggiornamenti del framework e delle dipendenze con la consapevolezza del grafico effettivo del progetto. Contrassegna le modifiche che causano un'interruzione, genera codice di migrazione e segue i modelli esistenti.
Agente Descrizione
@profiler Si connette all'infrastruttura di profilazione di Visual Studio per identificare i colli di bottiglia e suggerire ottimizzazioni mirate basate sulla tua codebase, non consigli generici.

Usare l'agente

L'agente consente di diagnosticare gli errori sistematicamente analizzando il contesto di debug.

Prompt di esempio:

  • @debugger Why is this exception being thrown?
  • @debugger Analyze the current call stack and explain what went wrong
  • @debugger What's causing the null reference in this method?

Usare l'agente

L'agente @profiler si connette agli strumenti di profilatura di Visual Studio per identificare e risolvere i problemi di prestazioni.

Prompt di esempio:

  • @profiler Find the performance bottlenecks in my application
  • @profiler Why is this method taking so long to execute?
  • @profiler Suggest optimizations for the hot path

Utilizzare l'agente

L'agente genera unit test che corrispondono al framework e alle convenzioni di test del progetto.

Prompt di esempio:

  • @test Generate unit tests for the selected method
  • @test Create tests that cover edge cases for this class
  • @test Write integration tests for this API endpoint

Per un supporto di test più completo per .NET, vedere GitHub Copilot per i test di .NET.

Usare l'agente

L'agente @modernize consente di eseguire migrazioni del framework e aggiornamenti delle dipendenze per progetti .NET e C++.

Prompt di esempio:

  • @modernize Upgrade this project to .NET 8
  • @modernize What breaking changes should I expect when migrating?
  • @modernize Update deprecated API calls in this file

Agenti personalizzati

Annotazioni

Gli agenti personalizzati richiedono Visual Studio 2026 versione 18.4 o successiva.

Gli agenti predefiniti coprono flussi di lavoro comuni, ma il team conosce meglio il flusso di lavoro. Gli agenti personalizzati consentono di creare elementi personalizzati usando la stessa base: consapevolezza dell'area di lavoro, comprensione del codice, modello di intelligenza artificiale preferito e strumenti personalizzati.

Gli agenti personalizzati diventano particolarmente potenti se combinati con MCP (Model Context Protocol). È possibile connettere gli agenti a origini di informazioni esterne, ad esempio documentazione interna, sistemi di progettazione, API e database, in modo che l'agente non sia limitato a ciò che si trova nel repository.

Creare un agente personalizzato

Gli agenti personalizzati vengono definiti come file nella cartella del repository:

your-repo/
└── .github/
    └── agents/
        └── code-reviewer.agent.md

Formato del file dell'agente

Ogni file dell'agente usa un modello semplice con frontmatter YAML seguito dalle istruzioni markdown:

---
name: Code Reviewer
description: Reviews PRs against our team's coding standards
model: claude-opus-4-6
tools: ["code_search", "readfile", "find_references"]
---

You are a code reviewer for our team. When reviewing changes, check for:

- Naming conventions: PascalCase for public methods, camelCase for private
- Error handling: all async calls must have try/catch with structured logging
- Test coverage: every public method needs at least one unit test

Flag violations clearly and suggest fixes inline.

Proprietà frontmatter

Proprietà Obbligatorio Descrizione
name NO Nome visualizzato per l'agente nel selettore di agenti. Se non specificato, il nome dell'agente viene derivato dal nome del file , ad esempio diventa .
description Sì Breve descrizione visualizzata quando si passa il puntatore del mouse sull'agente
model NO Modello di intelligenza artificiale da usare. Se non specificato, usa il modello selezionato nella selezione del modello.
tools NO Matrice di nomi degli strumenti che l'agente può usare. Se non specificato, tutti gli strumenti disponibili sono abilitati.

Specificare gli strumenti

Gli strumenti estendono le operazioni che l'agente personalizzato può eseguire. È possibile specificare gli strumenti che l'agente deve usare nella matrice.

Importante

I nomi degli strumenti variano in base alle piattaforme GitHub Copilot. Controllare gli strumenti disponibili in Visual Studio specificamente per assicurarsi che l'agente funzioni come previsto. Selezionare l'icona Strumenti nella finestra di chat per visualizzare i nomi degli strumenti disponibili.

Connettersi a fonti esterne con MCP

Con i server MCP, gli agenti personalizzati possono accedere a origini di informazioni esterne:

  • Documentazione interna e wiki
  • Progettare sistemi e librerie di componenti
  • API e database
  • Guide di stile e repository ADR

Ad esempio, un agente di revisione del codice può verificare le PR rispetto alle tue convenzioni reali connettendosi alla guida di stile tramite MCP.

Esempi di agenti personalizzati

Agente di revisione del codice

---
name: Code Reviewer
description: Reviews code against our team's coding standards
tools: ["code_search", "readfile"]
---

You are a code reviewer for our team. Review changes for:

1. **Naming conventions**: PascalCase for public methods, camelCase for private fields
2. **Error handling**: All async calls must have try/catch with structured logging
3. **Test coverage**: Every public method needs at least one unit test
4. **Documentation**: Public APIs must have XML documentation comments

Flag violations clearly and suggest fixes inline.

Agente di pianificazione

---
name: Feature Planner
description: Helps plan features before writing code
tools: ["code_search", "readfile", "find_references"]
---

You are a planning assistant. When asked about a feature:

1. Gather requirements by asking clarifying questions
2. Identify affected files and components in the codebase
3. Break down the work into discrete tasks
4. Flag potential risks or dependencies
5. Create a structured plan that can be handed off for implementation

Focus on understanding scope before suggesting solutions.

Progettare l'agente di sistema

---
name: Design System
description: Enforces UI design patterns and component usage
tools: ["code_search", "readfile"]
---

You are a design system expert. When reviewing UI code:

1. Check that standard components are used instead of custom implementations
2. Verify spacing and layout follow the design token system
3. Ensure accessibility requirements are met (ARIA labels, keyboard navigation)
4. Flag any UI drift from established patterns

Reference the component library documentation when suggesting fixes.

Agente di sviluppo full-stack con strumenti di Visual Studio

Nell'esempio seguente vengono usati nomi di strumenti specifici di Visual Studio.

---
name: Full Stack Dev
description: Full-stack development assistant with search, file editing, and terminal access
tools: ["code_search", "readfile", "editfiles", "find_references", "runcommandinterminal", "getwebpages"]
---

You are a full-stack development assistant. Help with:

1. Searching the codebase to understand existing patterns
2. Reading and editing files to implement changes
3. Running build and test commands to verify your work
4. Looking up documentation when needed

Always check existing code conventions before making changes.

Suggerimento

Selezionare l'icona Tools nella finestra Copilot Chat per visualizzare tutti i nomi degli strumenti disponibili nella versione di Visual Studio.

Configurazioni della community

Il repository awesome-copilot include configurazioni dell'agente fornite dalla community che è possibile usare come punti di partenza. Quando si usano configurazioni da questo repository, verificare che i nomi degli strumenti funzionino in Visual Studio prima della distribuzione nel team.

Limitazioni e note

  • Se non si specifica un modello, l'agente usa qualsiasi modello selezionato nella selezione del modello.
  • I nomi degli strumenti variano in base alle piattaforme GitHub Copilot. Verificare che i nomi degli strumenti funzionino in Visual Studio prima di eseguire la distribuzione nel team.

Condividere commenti e suggerimenti

Condividere le configurazioni dell'agente personalizzato nel repository awesome-copilot o inviare commenti e suggerimenti tramite Visual Studio Developer Community. I flussi di lavoro consentono di modellare le funzionalità future.

Contenuti correlati

  • Last updated on