Share via

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 Copilot Chat-venster het selectiemenu voor agents 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 de 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.

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

Voor end-to-end richtlijnen over de modernisering van GitHub Copilot-apps, zie het overzicht van de modernisering van GitHub Copilot-apps.

Aangepaste agenten

Opmerking

Voor aangepaste agenten is Visual Studio 2026 versie 18.4 of hoger 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.

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

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

.NET-ontwikkelagents

Het .NET-team onderhoudt gecureerde aangepaste agents voor C# en Windows Forms-ontwikkeling in de awesome-copilot-opslagplaats . 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 selecteer de agent in agentkiezer.

Aanbeveling

SelecteerExtra-opties>>GitHub>Copilot en schakel vervolgens projectspecifieke .NET-instructies in, zoals Windows Forms-ontwikkeling, indien van toepassing om automatisch de juiste aangepaste agent toe te voegen voor uw codebasis.

C#-expert

De C# Expert-agent past moderne C#-conventies toe op de codegeneratie 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:

  • Beveiliging van ontwerpcode: hiermee voorkomt u .Designer.cs beschadiging, zodat de Windows Forms Designer blijft werken nadat Copilot is bewerkt.
  • Ontwerppatronen voor gebruikersinterface: MVVM- en MVP-patronen, waaronder Community Toolkit-gegevensbinding.
  • Modern .NET: Corrigeer InvokeAsync overbelastingen, donkere modus, hoge DPI-kennis en null-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.

Verwante inhoud

  • Last updated on