GitHub Copilot-agents gebruiken in Visual Studio

Toegang tot agents in Copilot Chat

Als u Copilot Chat wilt openen, selecteert u de GitHub Copilot badge in de rechterbovenhoek van Visual Studio en selecteert u Vervolgens Chat openen.

Toegang tot agents op twee manieren:

• Agentkiezer: Selecteer in het Copilot Chat-venster de vervolgkeuzelijst van de agentkiezer om beschikbare agenten te bekijken.
• @ syntaxis: Typ @ gevolgd door de naam van de agent in de chatinvoer (bijvoorbeeld @debugger).

Ingebouwde agents gebruiken

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.
@git	Beoordeelt uw lokale niet-doorgevoerde wijzigingen en geeft feedback weer als inline opmerkingen in de editor en in de ervaring Git Changes.
@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.
Planningsagent	Hiermee maakt en verfijnt u implementatieplannen voordat codewijzigingen beginnen met het verkennen van uw codebasis met alleen-lezenhulpprogramma's. Vervolgens wordt het plan afgestuurd naar de agentmodus met het implementatieplan.

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 @git agent gebruiken

Gebruik de @git agent om lokale niet-doorgevoerde wijzigingen te controleren zonder Copilot Chat te verlaten.

Voorbeeldprompts:

• @git Review my changes
• @git Explain this review comment and suggest a fix

Zie Lokale wijzigingen controleren met Copilot Chat voor de volledige lokale beoordelingswerkstroom.

Beoordelingsselectie vereist Visual Studio versie 18.8 of later. Als u alleen geselecteerde code wilt bekijken, selecteert u de code in de editor, klikt u met de rechtermuisknop op de selectie en selecteert u Copilot-acties>Selectie bekijken. Copilot voegt inlineopmerkingen toe en kan suggesties toepassen of genereren. Deze opdracht maakt gebruik van dezelfde GitHub Copilot-codebeoordelingservaring als de Git Changes-workflow. Zie Geselecteerde code controleren voor meer informatie.

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: doorloopt modernisatietaken met een bewerkbaar dynamisch takenbestand naarmate 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.

Cloudagents gebruiken

Start in Visual Studio versie 18.1 of hoger GitHub Cloud Agent-sessies vanuit de agentkiezer in Copilot Chat. Als u een opslagplaats wilt verbinden, opent u een lokale oplossing vanuit een GitHub opslagplaats en meldt u zich aan bij GitHub in Visual Studio. De GitHub Copilot coderingsagent zorgt voor deze externe sessies. Het kan problemen met de opslagplaats en pull-aanvragen in die opslagplaats maken.

Cloudagents werken alleen met opslagplaatsen die toegang hebben tot de GitHub Copilot coderingsagent. Als de opslagplaats nog niet beschikbaar is voor de coderingsagent, verleent u deze toegang in GitHub. Visual Studio wordt u mogelijk gevraagd om opslagplaatsmachtigingen te verlenen wanneer u voor het eerst een cloudsessie start of wanneer voor de sessie meer machtigingen zijn vereist. Controleer de aangevraagde machtigingen voordat u ze goedkeurt.

Aangepaste agents maken en gebruiken

Voor aangepaste agents is Visual Studio versie 18.4 of hoger vereist.

De ingebouwde agents hebben betrekking op algemene werkstromen, maar uw team kent de werkstroom het beste. Aangepaste agents bieden een basis voor agents die zijn afgestemd op de werkstroom van uw team: werkruimtebewustzijn, codekennis, uw favoriete AI-model en uw eigen hulpprogramma's.

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

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

In de agentkiezer markeert bijschrift 1 de knop voor het maken van een agent en bijschrift 2 markeert een aangepaste agent met de + naam my-agent.

Ingebouwde .NET- en Azure vaardigheden vereisen Visual Studio versie 18.8 of hoger. Visual Studio biedt deze vaardigheden wanneer u de bijbehorende workloads installeert. In tegenstelling tot ingebouwde agents of de agentvaardigheden die u maakt, worden deze workloadspecifieke vaardigheden weergegeven in de categorie Ingebouwde op het tabblad Vaardigheden en zijn deze standaard uitgeschakeld. Bekijk en schakel alleen de vaardigheden in die van toepassing zijn op uw taken. Zie Ingebouwde .NET- en Azure-vaardigheden gebruiken voor meer informatie.

Een aangepaste agent maken

Aangepaste agents op opslagplaatsniveau zijn alleen van toepassing op de opslagplaats waar u ze opslaat. Ga als volgende te werk om er handmatig een te maken:

1. Maak in de hoofdmap van de opslagplaats een .github/agents/ map als deze nog niet bestaat.
2. Maak in die map een bestand waarvan de naam eindigt .agent.md, zoals code-reviewer.agent.md.
3. Voeg YAML front matter en Markdown-instructies toe met behulp van de indeling die wordt beschreven in de bestandsindeling van de agent.
4. Sla het bestand op.

De resulterende mapstructuur ziet er als volgt uit:

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

Selecteer in Visual Studio versie 18.5 of hoger de + knop in de agentkiezer en volg de aanwijzingen om een aangepaste agent te maken.

Als u een agent op gebruikersniveau wilt maken die van toepassing is op al uw projecten, slaat u het .agent.md bestand standaard op %USERPROFILE%\.github\agents . Wijzig deze locatie in Extra-opties >> GitHub > Copilot.

Een aangepaste agent selecteren en verifiëren

Nadat u een aangepaste agent hebt gemaakt:

1. Open Copilot Chat.
2. Open de agentkiezer en controleer of de agent wordt weergegeven met de naam en beschrijving van de definitie.
3. Selecteer de agent of roep deze aan door de agentnaam in te voeren @ in de chatinvoer.
4. Voer een prompt in waarmee een van de instructies van de agent wordt getest.
5. Controleer of het antwoord de rol en instructies van de agent volgt. Als de definitie hulpmiddelen vermeldt, opent u het deelvenster Tools en controleert u of de verwachte hulpmiddelen beschikbaar zijn.

Aangepaste agents op organisatieniveau gebruiken

Aangepaste agents op organisatieniveau vereisen Visual Studio versie 18.9 of hoger en een opslagplaats die deel uitmaakt van een GitHub organisatie.

Eigenaren van GitHub-organisaties en -ondernemingen kunnen aangepaste agents publiceren zodat leden deze in repositories binnen een organisatie kunnen gebruiken. Wanneer u een opslagplaats in de organisatie opent, Visual Studio deze agents automatisch detecteert en toevoegt aan de agentkiezer.

Een aangepaste agent op organisatieniveau controleren voordat u deze gebruikt:

1. Open Copilot Chat en selecteer de agentkiezer.
2. Beweeg de aanwijzer over de agent om de beschrijving en de bronorganisatie te bekijken.
3. Selecteer de knop Definitie om het definitiebestand van de agent te openen.

Eigenaren van organisaties en ondernemingen configureren deze agents in GitHub. Zie Voorbereiden op het gebruik van aangepaste agents in uw organisatie of Voorbereiden op het gebruik van aangepaste agents in uw onderneming voor hulp bij het instellen.

Aangepaste instructies op organisatieniveau vereisen Visual Studio versie 18.8 of hoger. Ze staan los van aangepaste agents. Eigenaren van organisaties gebruiken aangepaste instructies om voorkeuren te definiëren die automatisch van toepassing Visual Studio zijn wanneer u in een opslagplaats van een organisatie werkt. Toegepaste instructies worden weergegeven in Verwijzingen. Schakel ze uit in Visual Studio instellingen. Zie Aangepaste instructies op organisatieniveau gebruiken voor meer informatie.

Agent-bestandsindeling

Elk agentbestand maakt gebruik van YAML-front-matter, gevolgd door Markdown-instructies:

---
name: Code Reviewer
description: Reviews PRs against our team's coding standards
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.

De beschikbare modellen variëren per Visual Studio versie en op basis van de modellen die beschikbaar zijn voor uw Copilot-abonnement. De model eigenschap is optioneel, dus laat deze weg om het model te gebruiken dat is geselecteerd in de modelkiezer. Als u de eigenschap opneemt, kiest u een model dat beschikbaar is in uw versie van Visual Studio.

Eigenschappen van front-matter

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. Geef op welke hulpprogramma's de agent moet gebruiken in de tools matrix.

Taalspecifieke hulpprogramma's voor C++

De agentmodus bevat over het algemeen hulpprogramma's voor het bewerken van C++-code. Als u de C++-workload installeert, kan uw aangepaste agent deze Visual Studio-specifieke hulpprogrammanamen in de tools matrix gebruiken:

• get_symbol_call_hierarchy voor navigatie door de aanroephiërarchie
• get_symbol_class_hierarchy voor navigatie in klasse- en typehiërarchie

Deze hulpprogramma's bieden agents taalbewuste navigatie voor C++ en helpen de precisie bij het analyseren en bewerken van C++-code te verbeteren.

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.

Voorbeeld van een planningsagent voor functionaliteiten

Gebruik een aangepaste agent voor functieplanning wanneer u een teamspecifieke planningswerkstroom of extra hulpprogramma's wilt buiten de ingebouwde planagent.

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

You are a feature 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.

.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 de agentmodus en selecteer de agent via de agentkiezer.

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 biedt door de community bijgedragen agentconfiguraties als uitgangspunt. 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

• Begin met GitHub Copilot-agentmodus
• Agentvaardigheden gebruiken
• MCP-servers gebruiken
• GitHub Copilot testen voor .NET
• Visual Studio update van juli: Maak kennis met de nieuwe agent, mogelijk gemaakt door de GitHub Copilot SDK

Ingebouwde agents gebruiken in Visual Studio 2022

U hebt Visual Studio 2022 versie 17.14 of hoger nodig.

Als u Copilot Chat wilt openen, selecteert u de GitHub Copilot badge in de rechterbovenhoek van Visual Studio en selecteert u vervolgens Chatvenster openen.

Krijg op twee manieren toegang tot ingebouwde agents:

• Agentkiezer: Selecteer in het Copilot Chat-venster de vervolgkeuzelijst van de agentkiezer om de beschikbare ingebouwde agenten weer te geven.
• @-syntaxis: Typ @ gevolgd door de naam van de agent in het chatinvoerveld (bijvoorbeeld @profiler).

De agentselector kan de volgende ingebouwde agents bevatten. Beschikbaarheid kan variëren per Visual Studio versie 2022 en geïnstalleerde workloads.

Vertegenwoordiger	Beschrijving
Context	Agent voor contextanalyse
GitHub	Chatten met GitHub
Profiler	Optimaliseer je code
VS	Vragen stellen over Visual Studio
Workspace	Vragen over uw werkruimte

De @context agent gebruiken

De @context agent analyseert de context voor uw aanvraag om u inzicht te geven in de code waarmee u werkt.

Voorbeeldprompts:

• @context Explain the code in the current file
• @context What code is relevant to this method?
• @context Summarize the context for the selected code

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

Verwante inhoud

• Begin met GitHub Copilot-agentmodus
• Chatantwoorden aanpassen en context instellen
• GitHub Copilot Chat gebruiken in Visual Studio