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

• Visual Studio 2026 o Visual Studio 2022 versione 17.14 (con la versione di manutenzione più recente consigliata per le funzionalità più up-to-date)
• Sottoscrizione GitHub Copilot

Accedere agli agenti personalizzati

Agenti integrati

Ogni agente predefinito è incentrato su un flusso di lavoro specifico per sviluppatori. Questi agenti si integrano con gli strumenti nativi di Visual Studio in modi che un assistente generico non può.

Utilizzare l'agente @profiler

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

Agenti personalizzati

Gli agenti predefiniti coprono flussi di lavoro comuni, ma il team conosce meglio il flusso di lavoro. Gli agenti personalizzati consentono di creare agenti 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.

È anche possibile definire competenze dell'agente riutilizzabili che qualsiasi agente può individuare e usare automaticamente. Mentre gli agenti definiscono una persona e un set di strumenti, le competenze forniscono istruzioni specifiche per l'attività.

Creare un agente personalizzato

Definire agenti personalizzati come .agent.md file nella cartella .github/agents/ 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

Specificare gli strumenti

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

Connettersi a fonti esterne con MCP

Usando i server MCP, gli agenti personalizzati possono accedere a origini di informazioni esterne, ad esempio:

• 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ò controllare le pull request rispetto alle convenzioni effettive 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 utilizzati i 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.

.NET agenti di sviluppo

Il team .NET gestisce agenti personalizzati curati per lo sviluppo di C# e Windows Forms nel repository awesome-copilot. Per iniziare:

1. Scarica CSharpExpert.agent.md e WinFormsExpert.agent.md.
2. Aggiungere i file alla cartella .github/agents/ del repository.
3. Aprire Copilot Chat in modalità agente e selezionare l'agente dal selettore agente.

Esperto C#

L'agente C# Expert applica le convenzioni C# moderne alla generazione di codice di Copilot:

• Sintassi e prestazioni: segue le procedure consigliate correnti corrispondenti alle convenzioni esistenti del repository.
• Modifiche minime: genera solo il codice necessario, usando async/await con l'annullamento e la gestione delle eccezioni appropriate. Evita interfacce, metodi o parametri inutilizzati.
• Test: supporta unit test basati sul comportamento, test di integrazione e flussi di lavoro TDD.

Esperto di WinForms

L'agente WinForms Expert è destinato allo sviluppo di Windows Forms su .NET 8 fino a .NET 10:

• protezione del codice Designer: impedisce il danneggiamento del codice in .Designer.cs per far sì che il Windows Forms Designer continui a funzionare dopo le modifiche di Copilot.
• Modelli di progettazione dell'interfaccia utente: modelli MVVM e MVP, incluso il data binding di Community Toolkit.
• Modern .NET: correggere gli overload di InvokeAsync, la modalità scura, la consapevolezza con valori DPI elevati e i tipi riferimento nullable.
• Layout: TableLayoutPanel e FlowLayoutPanel per layout reattivi e consapevoli del DPI.
• Serializzazione CodeDOM: [DefaultValue] attributi e ShouldSerialize*() metodi per la corretta gestione delle proprietà del designer.
• Gestione delle eccezioni: modelli del gestore eventi asincroni e gestione delle eccezioni a livello di applicazione.

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

• Introduzione alla modalità agente Copilot di GitHub
• Usare le competenze dell'agente
• Usare i server MCP
• Personalizzare le risposte di chat e impostare il contesto
• GitHub Copilot testing per il .NET
• Panoramica modernizzazione dell'app GitHub Copilot