Verwenden von integrierten und benutzerdefinierten Agents mit GitHub Copilot

Visual Studio enthält eine Reihe von kuratierten integrierten Agents, die sich tief in IDE-Funktionen wie Debuggen, Profilerstellung und Tests integrieren. Sie können auch benutzerdefinierte Agents erstellen, die auf die Funktionsweise Ihres Teams zugeschnitten sind.

Voraussetzungen

• Visual Studio 2026 oder Visual Studio 2022, Version 17.14 (mit der neuesten Wartungsversion, die für die meisten up-to-date-Features empfohlen wird)
• Ein GitHub Copilot-Abonnement

Zugreifen auf benutzerdefinierte Agents

Integrierte Agenten

Jeder integrierte Agent konzentriert sich auf einen bestimmten Entwicklerworkflow. Diese Agents integrieren sich auf eine Weise in die nativen Tools von Visual Studio, wie es ein generischer Assistent nicht kann.

Verwenden Sie den @profiler Agent

Der @profiler Agent stellt eine Verbindung mit den Profilerstellungstools von Visual Studio bereit, um Leistungsprobleme zu identifizieren und zu beheben.

Beispielaufforderungen:

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

Benutzerdefinierte Agents

Die integrierten Agents decken allgemeine Workflows ab, aber Ihr Team kennt Ihren Workflow am besten. Mit benutzerdefinierten Agents können Sie Ihre eigenen Agents mit derselben Grundlage erstellen: Arbeitsbereichsbewusstsein, Codeverständnis, Ihr bevorzugtes KI-Modell und Ihre eigenen Tools.

Benutzerdefinierte Agents werden besonders leistungsfähig, wenn sie mit MCP (Model Context Protocol) kombiniert werden. Sie können Agents mit externen Wissensquellen wie internen Dokumentationen, Entwurfssystemen, APIs und Datenbanken verbinden, sodass der Agent nicht auf die Elemente in Ihrem Repository beschränkt ist.

Einen benutzerdefinierten Agent erstellen

Definieren Sie benutzerdefinierte Agents als .agent.md Dateien im Ordner Ihres Repositorys .github/agents/ :

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

Agent-Dateiformat

Jede Agentdatei verwendet eine einfache Vorlage mit YAML-Frontmatter gefolgt von Markdown-Anweisungen:

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

Frontmatter-Eigenschaften

Angeben von Tools

Tools erweitern, was Ihr benutzerdefinierter Agent tun kann. Sie können angeben, welche Tools der Agent im tools Array verwenden soll.

Herstellen einer Verbindung mit externen Quellen mit MCP

Mithilfe von MCP-Servern können Ihre benutzerdefinierten Agents auf externe Wissensquellen zugreifen, z. B.:

• Interne Dokumentation und Wikis
• Entwerfen von Systemen und Komponentenbibliotheken
• APIs und Datenbanken
• Styleguides und ADR-Repositorien

Beispielsweise kann ein Code-Review-Agent PRs anhand Ihrer tatsächlichen Konventionen überprüfen, indem er über MCP eine Verbindung zu Ihrem Styleguide herstellt.

Beispiele für benutzerdefinierte Agenten

Codeüberprüfungs-Agent

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

Planungs-Agent

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

Entwerfen des System-Agents

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

Full-Stack-Entwicklungs-Agent mit Visual Studio-Tools

Im folgenden Beispiel werden Visual Studio spezifischen Toolnamen verwendet:

---
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-Entwicklungs-Agents

Das .NET-Team verwaltet zusammengestellte benutzerdefinierte Agenten für die C#- und Windows Forms-Entwicklung im awesome-copilot-Repository. Um loszulegen:

1. Laden Sie CSharpExpert.agent.md und WinFormsExpert.agent.md herunter.
2. Fügen Sie die Dateien zum Ordner Ihres Repositorys .github/agents/ hinzu.
3. Öffnen Sie den Copilot-Chat im Agentmodus, und wählen Sie den Agent aus der Agentauswahl aus.

C#-Experte

Der C#-Experten-Agent wendet moderne C#-Konventionen auf die Codegenerierung von Copilot an:

• Syntax und Leistung: Folgen Sie den aktuellen bewährten Methoden, während sie den vorhandenen Konventionen Ihres Repositorys entsprechen.
• Minimale Änderungen: Generiert nur den benötigten Code, wobei async/await mit der richtigen Abbruch- und Ausnahmebehandlung verwendet wird. Vermeidet nicht verwendete Schnittstellen, Methoden oder Parameter.
• Tests: Unterstützt verhaltensgesteuerte Komponententests, Integrationstests und TDD-Workflows.

WinForms-Experte

Der WinForms Expert-Agent zielt auf die Entwicklung von Windows Forms auf .NET 8 bis .NET 10 ab:

• Designercodeschutz: Verhindert .Designer.cs Beschädigungen, sodass der Windows-Forms-Designer nach Copilot-Bearbeitungen weiterhin funktioniert.
• Ui-Entwurfsmuster: MVVM- und MVP-Muster, einschließlich Community-Toolkit-Datenbindung.
• Moderne .NET: Korrigieren Sie InvokeAsync Überladungen, dunklen Modus, Sensibilisierung für hohen DPI-Wert und nullfähige Referenztypen.
• Layout: TableLayoutPanel und FlowLayoutPanel für reaktionsfähige, DPI-fähige Layouts.
• CodeDOM Serialisierung: [DefaultValue] Attribute und ShouldSerialize*() Methoden für die ordnungsgemäße Verarbeitung von Designereigenschaften.
• Ausnahmebehandlung: Asynchrone Ereignishandlermuster und Ausnahmebehandlung auf Anwendungsebene.

Communitykonfigurationen

Das awesome-copilot-Repository enthält agentenkonfigurationen, die von der Community beigesteuert wurden, und die Sie als Ausgangspunkte verwenden können. Wenn Sie Konfigurationen aus diesem Repository verwenden, überprüfen Sie, ob die Toolnamen in Visual Studio funktionieren, bevor Sie sie in Ihrem Team bereitstellen.

Einschränkungen und Hinweise

• Wenn Sie kein Modell angeben, verwendet der Agent das in der Modellauswahl ausgewählte Modell.
• Die Toolnamen variieren auf GitHub Copilot Plattformen. Überprüfen Sie, ob die Toolnamen in Visual Studio funktionieren, bevor Sie sie für Ihr Team bereitstellen.

Feedback teilen

Teilen Sie Ihre benutzerdefinierten Agent-Konfigurationen im repository awesome-copilot oder senden Sie Feedback über Visual Studio Developer Community. Ihre Workflows helfen bei der Gestaltung zukünftiger Features.

Verwandte Inhalte

• Anfangen mit dem Agentenmodus von GitHub Copilot
• Verwenden von MCP-Servern
• Anpassen von Chatantworten und Festlegen des Kontexts
• GitHub Copilot-Tests für .NET
• Übersicht über die GitHub Copilot-App-Modernisierung