Použití integrovaných a vlastních agentů s GitHub Copilot

Visual Studio zahrnuje sadu kurátorovaných integrovaných agentů, kteří se hluboce integrují s funkcemi integrovaného vývojového prostředí, jako je ladění, profilace a testování. Můžete také vytvořit vlastní agenty přizpůsobené tomu, jak váš tým funguje.

Předpoklady

Přístup k vlastním agentům

K vlastním agentům můžete přistupovat dvěma způsoby:

  • Agent picker: V okně Copilot Chat vyberte rozevírací seznam pro výběr agenta a zobrazte dostupné agenty. V současné době je tato možnost dostupná jenom v buildu Visual Studio 2026 Insider.
  • Syntaxe @: Zadejte @ název agenta ve vstupu chatu (například @debugger).

K vlastním agentům můžete přistupovat pomocí syntaxe @: Zadejte @, za kterým následuje název agenta ve vstupu chatu (například @profiler).

Screenshot zobrazující výběr agenta s vlastními agenty v Visual Studio.

Snímek obrazovky znázorňující výběr agenta s vlastními agenty

Předdefinované agenty

Každý integrovaný agent se zaměřuje na konkrétní pracovní postup vývojáře. Tito agenti se integrují s nativními nástroji Visual Studio způsobem, který nemůže použít obecný asistent.

Agenta Description
@debugger Přesahuje čtení chybových zpráv. Používá zásobníky volání, proměnné a diagnostické nástroje k systémové diagnostice chyb napříč vaším řešením.
@profiler Připojí se k infrastruktuře profilace Visual Studio, aby bylo možné identifikovat kritické body a navrhnout cílené optimalizace uzemněné v základu kódu, nikoli obecné rady.
@test Generuje jednotkové testy vyladěné na rámec a vzory projektu, nikoli univerzální šablony, které váš CI systém odmítá.
@modernize (pouze .NET a C++) Zpracovává upgrady architektur a závislostí s vědomím skutečného grafu projektu. Označí zásadní změny, vygeneruje kód migrace a řídí se vašimi stávajícími vzory.
Agenta Description
@profiler Připojí se k infrastruktuře profilace Visual Studio, aby bylo možné identifikovat kritické body a navrhnout cílené optimalizace uzemněné v základu kódu, nikoli obecné rady.

Použijte agenta @debugger

Agent @debugger vám pomůže systematicky diagnostikovat chyby analýzou kontextu ladění. Podporuje také komplexní agentně řízený pracovní postup, který reprodukuje chyby, nástrojuje vaši aplikaci s trasovacími body a podmíněnými zarážkami a ověřuje opravy pomocí živých běhových dat. Další informace najdete v tématu Řešení chyb ladicího agenta.

Ukázkové výzvy:

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

Použijte agenta @profiler

Agent @profiler se připojuje k nástrojům pro profilaci Visual Studio, které pomáhají identifikovat a opravit problémy s výkonem.

Ukázkové výzvy:

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

Použijte agenta @test

Agent @test generuje testy jednotek, které odpovídají testovacímu rozhraní a konvencím projektu.

Ukázkové výzvy:

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

Pro komplexnější podporu testování pro .NET viz Testování .NET GitHub Copilot.

Použijte agenta @modernize

Agent @modernize pomáhá s migrací architektury a upgrady závislostí pro projekty .NET a C++.

V případě pracovních postupů modernizace .NET podporuje agent třífázový proces:

  • Posouzení: Zkontroluje verze balíčků, možnosti cílové architektury, inventář projektu a rizika kompatibility rozhraní API.
  • Plán: Vygeneruje plán migrace, který odpovídá aktuálním prioritám posouzení a aktualizací.
  • Provádění úkolů: Funguje prostřednictvím modernizačních úloh s dynamickým souborem úkolů, který můžete upravovat při provádění práce.

Ukázkové výzvy:

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

Kompletní pokyny k modernizaci aplikace Copilot GitHubu pro .NET najdete v tématu Přehled modernizace aplikace Copilot GitHubu.

Vlastní agenti

Poznámka:

Uživatelské agenty vyžadují Visual Studio verze 2026 18.4 nebo novější.

Předdefinované agenty pokrývají běžné pracovní postupy, ale váš tým zná váš pracovní postup nejlépe. Vlastní agenti umožňují vytvářet vlastní agenty pomocí stejného základu: povědomí o pracovním prostoru, porozumění kódu, preferovaný model AI a vlastní nástroje.

Vlastní agenti se stávají zvláště výkonnými v kombinaci s MCP (Model Context Protocol). Agenty můžete připojit k externím zdrojům znalostí, jako jsou interní dokumentace, systémy návrhu, rozhraní API a databáze, takže agent není omezen na to, co je ve vašem úložišti.

Můžete také definovat opakovaně použitelné dovednosti agenta , které každý agent může automaticky zjišťovat a používat. Zatímco agenti definují sadu osob a nástrojů, dovednosti poskytují prioritní pokyny specifické pro úkoly.

Vytvoření vlastního agenta

Definujte vlastní agenty jako .agent.md soubory ve složce úložiště .github/agents/ :

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

Můžete také definovat agenty na úrovni uživatele, kteří se vztahují na všechny vaše projekty. Agenti na úrovni uživatele jsou ve výchozím nastavení uloženi ve složce %USERPROFILE%\.github\agents. Toto umístění můžete změnit v>nástrojích Možnosti>GitHub>Copilotu.

Formát souboru agenta

Každý soubor agenta používá jednoduchou šablonu s frontmatterem YAML následovanou pokyny markdownu:

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

Vlastnosti frontmatteru

Vlastnictví Povinné Description
name Ne Zobrazovaný název agenta v nástroji pro výběr agenta Pokud tuto vlastnost nezadáte, název agenta pochází z názvu souboru (například code-reviewer.agent.md se stane code-reviewer).
description Yes Stručný popis zobrazený při najetí myší na agenta
model Ne Model AI, který se má použít. Pokud tuto vlastnost nezadáte, použije se model vybraný v nástroji pro výběr modelu.
tools Ne Pole názvů nástrojů, které může agent použít. Pokud tuto vlastnost nezadáte, jsou povoleny všechny dostupné nástroje.

Zadání nástrojů

Nástroje rozšiřují možnosti vlastního agenta. Můžete určit nástroje, které má agent použít v tools poli.

Důležité

Názvy nástrojů se liší v různých GitHub Copilot platformách. Zkontrolujte nástroje dostupné v Visual Studio konkrétně a ujistěte se, že váš agent funguje podle očekávání. Výběrem ikony Nástroje v okně chatu zobrazíte dostupné názvy nástrojů.

Připojení k externím zdrojům pomocí MCP

Pomocí serverů MCP můžou vlastní agenti přistupovat k externím zdrojům znalostí, jako jsou:

  • Interní dokumentace a wikiweby
  • Návrh systémů a knihoven komponent
  • Rozhraní API a databáze
  • Průvodce stylu a úložiště ADR

Agent kontroly kódu může například kontrolovat pull requesty proti vašim aktuálním konvencím připojením k průvodci stylů prostřednictvím MCP.

Příklad vlastních agentů

Agent pro kontrolu kódu

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

Agent plánování

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

Návrh systémového agenta

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

Plnohodnotný vývojový agent s nástroji Visual Studio

Následující příklad používá názvy nástrojů specifické pro 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.

Návod

Výběrem ikony Tools v okně Copilot Chat zobrazíte všechny dostupné názvy nástrojů ve vaší verzi Visual Studio.

.NET vývojoví agenti

Tým .NET udržuje kurátorované vlastní agenty pro vývoj v jazyce C# a model Windows Forms v úložišti awesome-copilot. Jak začít:

  1. Stáhněte si CSharpExpert.agent.md a WinFormsExpert.agent.md.
  2. Přidejte soubory do složky úložiště .github/agents/ .
  3. Otevřete Copilot Chat v režimu agenta a vyberte agenta z výběru agenta.

Návod

Vyberte Nástroje>Možnosti>GitHub>Copilot, a potom povolte Pokud je to možné, povolit pokyny specifické pro projekt .NET, jako je vývoj v prostředí model Windows Forms k automatickému přidání odpovídajícího vlastního agenta pro základ kódu.

Expert na C#

Agent C# Expert používá moderní konvence jazyka C# pro generování kódu Copilot:

  • Syntaxe a výkon: Při porovnávání existujících konvencí úložiště se řídí aktuálními osvědčenými postupy.
  • Minimální změny: Generuje pouze potřebný kód pomocí async/await se správným zrušením a zpracováním výjimek. Vyhněte se nepoužívaným rozhraním, metodám nebo parametrům.
  • Testování: Podporuje testování jednotek řízené chováním, testování integrace a pracovní postupy TDD.

WinForms Odborník

Agent WinForms Expert cílí na vývoj model Windows Forms na .NET 8 až .NET 10:

  • Ochrana návrhového kódu: Zabraňuje poškození .Designer.cs, aby model Windows Forms Návrhář po úpravách pomocí Copilot nadále fungoval.
  • Vzory návrhu uživatelského rozhraní: vzory MVVM a MVP, včetně datové vazby Community Toolkit.
  • Moderní .NET: Správné přetížení InvokeAsync, tmavý režim, podpora vysokého DPI a odkazy s možnou hodnotou null.
  • Rozložení: TableLayoutPanel a FlowLayoutPanel pro responzivní rozložení s podporou DPI.
  • Serializace CodeDOM: [DefaultValue] atributy a ShouldSerialize*() metody pro správné zpracování vlastností návrháře.
  • Zpracování výjimek: Vzory obslužné rutiny asynchronních událostí a zpracování výjimek na úrovni aplikace.

Konfigurace komunity

Úložiště awesome-copilot má agentní konfigurace přispěné komunitou, které můžete použít jako výchozí body. Pokud používáte konfigurace z tohoto úložiště, před nasazením do týmu ověřte, že názvy nástrojů fungují v Visual Studio.

Omezení a poznámky

  • Pokud model nezadáte, agent použije v nástroji pro výběr modelu jakýkoli model.
  • Názvy nástrojů se liší v různých GitHub Copilot platformách. Před nasazením do týmu ověřte, že názvy nástrojů fungují v Visual Studio.

Sdílení zpětné vazby

Sdílejte vlastní konfigurace agenta v úložišti awesome-copilot nebo zpětnou vazbu k souborům prostřednictvím Visual Studio Developer Community. Pracovní postupy pomáhají utvářet budoucí funkce.