Ingebouwde en aangepaste agents gebruiken met GitHub Copilot

Visual Studio bevat een set gecureerde ingebouwde agents die diep kunnen worden geïntegreerd met IDE-mogelijkheden, zoals foutopsporing, profilering en testen. U kunt ook aangepaste agents maken die zijn afgestemd op de werking van uw team.

Vereiste voorwaarden

Aangepaste agents openen

U kunt op twee manieren toegang krijgen tot aangepaste agents:

  • Agent picker: Selecteer in het venster Copilot Chat de vervolgkeuzelijst agentkiezer om de beschikbare agents weer te geven. Deze optie is momenteel alleen beschikbaar in de build van Visual Studio 2026 Insiders.
  • @ syntaxis: Typ @ gevolgd door de naam van de agent in de chatinvoer (bijvoorbeeld @debugger).

U kunt toegang krijgen tot aangepaste agents met behulp van @-syntaxis: Typ @ gevolgd door de naam van de agent in de chat-invoer (bijvoorbeeld @profiler).

Schermafbeelding van de agentkiezer met aangepaste agents in Visual Studio.

Schermopname van de agentkiezer met aangepaste agents.

Ingebouwde agents

Elke ingebouwde agent is gericht op een specifieke werkstroom voor ontwikkelaars. Deze agents kunnen worden geïntegreerd met systeemeigen hulpprogramma's van Visual Studio op een manier die een algemene assistent niet kan.

Vertegenwoordiger Beschrijving
@debugger Gaat verder dan het lezen van foutberichten. Gebruikt uw aanroepstacks, variabele status en diagnostische hulpprogramma's om foutdiagnose systematisch in uw oplossing te doorlopen.
@profiler Maakt verbinding met de profileringsinfrastructuur van Visual Studio om knelpunten te identificeren en gerichte optimalisaties te suggereren die zijn gebaseerd op uw codebasis, niet algemeen advies.
@test Hiermee worden eenheidstests gegenereerd die zijn afgestemd op het framework en de patronen van uw project, niet standaard dat uw CI weigert.
@modernize (alleen .NET en C++ verwerkt framework- en afhankelijkheidsupgrades met kennis van uw werkelijke projectgrafiek. Markeert belangrijke wijzigingen, genereert migratiecode en volgt uw bestaande patronen.
Vertegenwoordiger Beschrijving
@profiler Maakt verbinding met de profileringsinfrastructuur van Visual Studio om knelpunten te identificeren en gerichte optimalisaties te suggereren die zijn gebaseerd op uw codebasis, niet algemeen advies.

De @debugger agent gebruiken

De @debugger agent helpt u bij het systematisch diagnosticeren van fouten door uw foutopsporingscontext te analyseren. Het ondersteunt ook een end-to-end agentische werkstroom die bugs reproduceert, uw app instrumenteert met tracepoints en voorwaardelijke onderbrekingspunten en oplossingen valideert met behulp van live runtime-gegevens. Zie Agentic bugoplossing met de Debugger-agent voor meer informatie.

Voorbeeldprompts:

  • @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?

De @profiler agent gebruiken

De @profiler-agent maakt verbinding met de profileringshulpprogramma's van Visual Studio om prestatieproblemen te identificeren en op te lossen.

Voorbeeldprompts:

  • @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

De @test agent gebruiken

De @test agent genereert eenheidstests die overeenkomen met het testframework en de conventies van uw project.

Voorbeeldprompts:

  • @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

Zie GitHub Copilot testen voor .NET voor uitgebreidere .NET testen.

De @modernize agent gebruiken

De @modernize-agent helpt bij frameworkmigraties en afhankelijkheidsupgrades voor .NET- en C++-projecten.

Voor .NET moderniseringswerkstromen ondersteunt de agent een proces met drie fasen:

  • Evaluatie: Beoordeel pakketversies, doelframeworkopties, projectinventaris en API-compatibiliteitsrisico's.
  • Plan: Genereert een migratieplan dat overeenkomt met de huidige evaluatie- en updateprioriteiten.
  • Taakuitvoering: Werkt via moderniseringstaken met een dynamisch taakbestand dat u kunt bewerken wanneer het werk vordert.

Voorbeeldprompts:

  • @modernize Upgrade this project to .NET 8
  • @modernize What breaking changes should I expect when migrating?
  • @modernize Update deprecated API calls in this file
  • @modernize Assess this solution, generate a migration plan, and create execution tasks

Zie GitHub Copilot-app modernization overview voor end-to-end-richtlijnen voor de modernisering van GitHub Copilot-apps voor .NET.

Aangepaste agenten

Opmerking

Voor aangepaste agents is Visual Studio 2026, versie 18.4 of later, vereist.

De ingebouwde agents hebben betrekking op algemene werkstromen, maar uw team kent uw werkstroom het beste. Met aangepaste agents kunt u uw eigen agents bouwen met behulp van dezelfde basis: werkruimtebewustzijn, codekennis, uw favoriete AI-model en uw eigen hulpprogramma's.

Aangepaste agents worden vooral krachtig in combinatie met MCP (Model Context Protocol). U kunt agents verbinden met externe kennisbronnen, zoals interne documentatie, ontwerpsystemen, API's en databases, zodat de agent niet beperkt is tot wat zich in uw opslagplaats bevindt.

U kunt ook herbruikbare agentvaardigheden definiëren die elke agent automatisch kan detecteren en gebruiken. Terwijl agents een persona en hulpprogrammaset definiëren, bieden vaardigheden gerichte, taakspecifieke instructies.

Een aangepaste agent maken

Definieer aangepaste agents als .agent.md bestanden in uw .github/agents/ map van de repository:

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

U kunt ook agents op gebruikersniveau definiëren die van toepassing zijn op al uw projecten. Agents op gebruikersniveau worden standaard opgeslagen in %USERPROFILE%\.github\agents. U kunt deze locatie wijzigen in Extra>Opties>GitHub>Copilot.

Agent-bestandsindeling

Elk agentbestand maakt gebruik van een eenvoudige sjabloon met YAML-frontmatter, gevolgd door Markdown-instructies:

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

Eigenschappen van frontmatter

Vastgoed Verplicht Beschrijving
name Nee. Weergavenaam van de agent in de agent selectie. Als u deze eigenschap niet opgeeft, komt de agentnaam voort uit de bestandsnaam (bijvoorbeeld code-reviewer.agent.md naar code-reviewer).
description Ja Korte beschrijving die wordt weergegeven wanneer u over de agent hovert
model Nee. AI-model om te gebruiken. Als u deze eigenschap niet opgeeft, wordt het model dat is geselecteerd in de modelkiezer gebruikt.
tools Nee. Matrix van hulpprogrammanamen die de agent kan gebruiken. Als u deze eigenschap niet opgeeft, zijn alle beschikbare hulpprogramma's ingeschakeld.

Hulpmiddelen specificeren

Hulpprogramma's breiden uit wat uw aangepaste agent kan doen. U kunt opgeven welke hulpprogramma's de agent moet gebruiken in de tools matrix.

Belangrijk

Namen van hulpprogramma's verschillen per GitHub Copilot platform. Controleer de hulpprogramma's die beschikbaar zijn in Visual Studio om ervoor te zorgen dat uw agent werkt zoals verwacht. Selecteer het pictogram Hulpmiddelen in het chatvenster om de beschikbare namen van hulpmiddelen weer te geven.

Verbinding maken met externe bronnen met MCP

Met behulp van MCP-servers hebben uw aangepaste agents toegang tot externe kennisbronnen, zoals:

  • Interne documentatie en wiki's
  • Systemen en onderdeelbibliotheken ontwerpen
  • API's en databases
  • Stijlhulplijnen en ADR-opslagplaatsen

Een codebeoordelingsagent kan bijvoorbeeld PRs controleren volgens uw gebruikelijke conventies door via MCP verbinding te maken met uw stijlgids.

Voorbeeld van aangepaste agents

Software voor codebeoordeling

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

Planningsagent

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

Systeemagent ontwerpen

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

Ontwikkelagent voor volledige stack met Visual Studio-hulpprogramma's

In het volgende voorbeeld worden Visual Studio-specifieke hulpprogrammanamen gebruikt:

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

Aanbeveling

Selecteer het pictogram Tools in het venster Copilot Chat om alle beschikbare hulpprogrammanamen in uw versie van Visual Studio weer te geven.

.NET ontwikkelagenten

Het .NET-team onderhoudt verzamelde aangepaste agents voor C# en ontwikkeling met Windows Forms in de repository awesome-copilot. Om aan de slag te gaan:

  1. Download CSharpExpert.agent.md en WinFormsExpert.agent.md.
  2. Voeg de bestanden toe aan de .github/agents/ map van uw opslagplaats.
  3. Open Copilot Chat in agentmodus en kies de agent uit de agentkiezer.

Aanbeveling

Selecteer Tools>Options>GitHub>Copilot, en schakel Inschakelen van project specifieke .NET instructies, zoals Windows Forms-ontwikkeling indien toepasselijk om automatisch de juiste aangepaste agent voor uw codebasis toe te voegen.

C#-expert

De C# Expert-agent past moderne C#-conventies toe op het genereren van code van Copilot:

  • Syntaxis en prestaties: volgt de huidige aanbevolen procedures terwijl deze overeenkomen met de bestaande conventies van uw opslagplaats.
  • Minimale wijzigingen: genereert alleen de code die nodig is, met behulp van async/await met de juiste annulerings- en uitzonderingsafhandeling. Vermijd ongebruikte interfaces, methoden of parameters.
  • Testen: ondersteunt gedraggestuurde eenheidstests, integratietests en TDD-werkstromen.

WinForms Expert

De WinForms Expert-agent is gericht op Windows Forms ontwikkeling op .NET 8 tot en met .NET 10:

  • Designer-codebeveiliging: voorkomt .Designer.cs beschadiging, zodat de Windows Forms Designer blijft werken na Copilot bewerkingen.
  • Ontwerppatronen voor gebruikersinterface: MVVM- en MVP-patronen, waaronder Community Toolkit-gegevensbinding.
  • Modern .NET: Corrigeer InvokeAsync overloads, donkere modus, hoge DPI-kennis en nullable referentietypen.
  • Indeling: TableLayoutPanel en FlowLayoutPanel voor responsieve, DPI-compatibele indelingen.
  • CodeDOM-serialisatie: [DefaultValue] kenmerken en ShouldSerialize*() methoden voor de juiste verwerking van ontwerpeigenschappen.
  • Afhandeling van uitzonderingen: Async-gebeurtenishandlerpatronen en verwerking van uitzonderingen op toepassingsniveau.

Community-configuraties

De awesome-copilot-opslagplaats heeft door de community bijgedragen agentconfiguraties die u als uitgangspunt kunt gebruiken. Wanneer u configuraties uit deze opslagplaats gebruikt, controleert u of de namen van hulpprogramma's in Visual Studio werken voordat u deze implementeert in uw team.

Beperkingen en opmerkingen

  • Als u geen model opgeeft, gebruikt de agent het model dat is geselecteerd in de modelkiezer.
  • Namen van hulpprogramma's verschillen per GitHub Copilot platform. Controleer of de namen van hulpprogramma's in Visual Studio werken voordat ze in uw team worden geïmplementeerd.

Feedback delen

Deel uw aangepaste agentconfiguraties in de awesome-copilot-opslagplaats of stuur feedback via Visual Studio Developer Community. Uw werkstromen helpen bij het vormgeven van toekomstige functies.