Benutzerdefinierte Agenten in VS Code

Benutzerdefinierte Agenten ermöglichen es Ihnen, die KI so zu konfigurieren, dass sie unterschiedliche Personas annimmt, die auf bestimmte Entwicklungsrollen und Aufgaben zugeschnitten sind. Sie könnten zum Beispiel Agenten für einen Sicherheitsprüfer, einen Planer, einen Lösungsarchitekten oder andere spezialisierte Rollen erstellen. Jede Persona kann ihr eigenes Verhalten, verfügbare Werkzeuge und Anweisungen haben.

Sie können auch Übergaben verwenden, um geführte Arbeitsabläufe zwischen Agenten zu erstellen, sodass Sie mit einem einzigen Klick nahtlos von einem spezialisierten Agenten zu einem anderen wechseln können. Sie könnten beispielsweise vom Planungsagenten direkt zum Implementierungsagenten wechseln oder die Aufgabe mit dem relevanten Kontext an einen Code-Prüfer übergeben.

Dieser Artikel beschreibt, wie Sie benutzerdefinierte Agenten in VS Code erstellen und verwalten.

Was sind benutzerdefinierte Agenten?

Die eingebauten Agenten bieten Allzweckkonfigurationen für den Chat in VS Code. Für ein stärker individualisiertes Chat-Erlebnis können Sie Ihre eigenen benutzerdefinierten Agenten erstellen.

Benutzerdefinierte Agenten bestehen aus einer Reihe von Anweisungen und Werkzeugen, die angewendet werden, wenn Sie zu diesem Agenten wechseln. Zum Beispiel könnte ein "Plan"-Agent Anweisungen zur Erstellung eines Implementierungsplans enthalten und nur schreibgeschützte Werkzeuge verwenden. Durch die Erstellung eines benutzerdefinierten Agenten können Sie schnell zu dieser spezifischen Konfiguration wechseln, ohne jedes Mal manuell die relevanten Werkzeuge und Anweisungen auswählen zu müssen.

Benutzerdefinierte Agenten werden in einer .agent.md Markdown-Datei definiert und können in Ihrem Arbeitsbereich zur Verwendung durch andere oder in Ihrem Benutzerprofil gespeichert werden, wo Sie sie über verschiedene Arbeitsbereiche hinweg wiederverwenden können.

Sie können Ihre benutzerdefinierten Agenten in Hintergrundagenten und Cloud-Agenten wiederverwenden, wodurch Sie autonome Aufgaben mit denselben spezialisierten Konfigurationen ausführen können.

Warum benutzerdefinierte Agenten verwenden?

Unterschiedliche Aufgaben erfordern unterschiedliche Fähigkeiten. Ein Planungsagent benötigt möglicherweise nur schreibgeschützte Werkzeuge für Recherche und Analyse, um versehentliche Codeänderungen zu verhindern, während ein Implementierungsagent vollständige Bearbeitungsfunktionen benötigt. Benutzerdefinierte Agenten ermöglichen es Ihnen, genau anzugeben, welche Werkzeuge für jede Aufgabe verfügbar sind, und stellen sicher, dass die KI über die richtigen Fähigkeiten für die jeweilige Aufgabe verfügt.

Benutzerdefinierte Agenten ermöglichen es Ihnen auch, spezialisierte Anweisungen bereitzustellen, die definieren, wie die KI agieren soll. Zum Beispiel könnte ein Planungsagent der KI anweisen, den Projektkontext zu sammeln und einen detaillierten Implementierungsplan zu erstellen, während sich ein Code-Review-Agent auf die Identifizierung von Sicherheitslücken und die Vorschläge zur Verbesserung konzentrieren könnte. Diese spezialisierten Anweisungen gewährleisten jedes Mal konsistente, aufgabenbezogene Antworten, wenn Sie zu diesem Agenten wechseln.

Übergaben

Übergaben ermöglichen es Ihnen, geführte sequentielle Arbeitsabläufe zu erstellen, die zwischen Agenten mit vorgeschlagenen nächsten Schritten wechseln. Nach Abschluss einer Chat-Antwort erscheinen Übergabe-Schaltflächen, die es den Benutzern ermöglichen, mit relevantem Kontext und einer vorausgefüllten Eingabeaufforderung zum nächsten Agenten zu wechseln.

Übergaben sind nützlich für die Orchestrierung von Multi-Step-Workflows, die Entwicklern die Kontrolle über die Überprüfung und Genehmigung jedes Schritts geben, bevor sie zum nächsten übergehen. Zum Beispiel

• Planung → Implementierung: Einen Plan im Planungsagenten erstellen, dann an den Implementierungsagenten übergeben, um mit dem Codieren zu beginnen.
• Implementierung → Überprüfung: Implementierung abschließen, dann zu einem Code-Review-Agenten wechseln, um Qualität und Sicherheitsprobleme zu prüfen.
• Fehlgeschlagene Tests schreiben → Erfolgreiche Tests schreiben: Fehlgeschlagene Tests generieren, die einfacher zu überprüfen sind als große Implementierungen, dann übergeben, um diese Tests durch Implementierung der erforderlichen Codeänderungen erfolgreich zu machen.

Um Übergaben in Ihrer Agenten-Datei zu definieren, fügen Sie sie dem Frontmatter hinzu. Jede Übergabe gibt den Zielagenten, die Beschriftung der Schaltfläche und eine optionale Eingabeaufforderung zum Senden an.

---
description: Generate an implementation plan
tools: ['search', 'fetch']
handoffs:
  - label: Start Implementation
    agent: implementation
    prompt: Now implement the plan outlined above.
    send: false
---

Wenn Benutzer die Übergabe-Schaltfläche sehen und diese auswählen, wechseln sie zum Zielagenten mit der vorausgefüllten Eingabeaufforderung. Wenn send: true gesetzt ist, wird die Eingabeaufforderung automatisch gesendet, um den nächsten Schritt des Workflows zu starten.

Dateistruktur für benutzerdefinierte Agenten

Dateien für benutzerdefinierte Agenten sind Markdown-Dateien und verwenden die Erweiterung .agent.md. Sie haben die folgende Struktur.

Kopfzeile (optional)

Die Kopfzeile ist im YAML-Frontmatter-Format mit den folgenden Feldern formatiert

Hauptteil

Der Body der Datei für benutzerdefinierte Agenten enthält die Implementierung des benutzerdefinierten Agenten, formatiert als Markdown. Hier geben Sie spezifische Eingabeaufforderungen, Richtlinien oder andere relevante Informationen an, denen die KI folgen soll, wenn sie sich in diesem benutzerdefinierten Agenten befindet.

Sie können auf andere Dateien verweisen, indem Sie Markdown-Links verwenden, z. B. um Anleitungsdateien wiederzuverwenden.

Um Agent-Tools im Haupttext zu referenzieren, verwenden Sie die Syntax #tool:<tool-name>. Um beispielsweise das Tool githubRepo zu referenzieren, verwenden Sie #tool:githubRepo.

Wenn Sie den benutzerdefinierten Agenten in der Chat-Ansicht auswählen, werden die Richtlinien im Body der Datei des benutzerdefinierten Agenten der Benutzereingabeaufforderung im Chat vorangestellt.

Beispiel für einen benutzerdefinierten Agenten

Der folgende Code-Schnipsel zeigt ein Beispiel für eine "Plan"-Datei für einen benutzerdefinierten Agenten, die einen Implementierungsplan erstellt und keine Codeänderungen vornimmt. Weitere von der Community beigesteuerte Beispiele finden Sie im Awesome Copilot Repository.

---
description: Generate an implementation plan for new features or refactoring existing code.
name: Planner
tools: ['fetch', 'githubRepo', 'search', 'usages']
model: Claude Sonnet 4
handoffs:
  - label: Implement Plan
    agent: agent
    prompt: Implement the plan outlined above.
    send: false
---
# Planning instructions
You are in planning mode. Your task is to generate an implementation plan for a new feature or for refactoring existing code.
Don't make any code edits, just generate a plan.

The plan consists of a Markdown document that describes the implementation plan, including the following sections:

* Overview: A brief description of the feature or refactoring task.
* Requirements: A list of requirements for the feature or refactoring task.
* Implementation Steps: A detailed list of steps to implement the feature or refactoring task.
* Testing: A list of tests that need to be implemented to verify the feature or refactoring task.

Einen benutzerdefinierten Agenten erstellen

Sie können eine Datei für benutzerdefinierte Agenten in Ihrem Arbeitsbereich oder Benutzerprofil erstellen.

1. Wählen Sie Benutzerdefinierte Agenten konfigurieren aus dem Agenten-Dropdown und wählen Sie dann Neuen benutzerdefinierten Agenten erstellen oder führen Sie den Befehl Chat: Neuer benutzerdefinierter Agent in der Befehlspalette aus (⇧⌘P (Windows, Linux Ctrl+Shift+P)).

2. Wählen Sie den Speicherort aus, an dem die Datei für den benutzerdefinierten Agenten erstellt werden soll.

   • Arbeitsbereich: Erstellen Sie die Definitionsdatei für den benutzerdefinierten Agenten im Verzeichnis .github/agents Ihres Arbeitsbereichs, um sie nur innerhalb dieses Arbeitsbereichs zu verwenden.

   • Benutzerprofil: Erstellen Sie die Definitionsdatei für den benutzerdefinierten Agenten im aktuellen Profilordner, um sie über alle Ihre Arbeitsbereiche hinweg zu verwenden.

3. Geben Sie einen Dateinamen für den benutzerdefinierten Agenten ein. Dies ist der Standardname, der im Agenten-Dropdown angezeigt wird.

4. Geben Sie die Details für den benutzerdefinierten Agenten in der neu erstellten .agent.md-Datei an.

   • Füllen Sie das YAML-Frontmatter am oberen Rand der Datei aus, um den Namen, die Beschreibung, die Werkzeuge und andere Einstellungen des benutzerdefinierten Agenten zu konfigurieren.
   • Fügen Sie Anweisungen für den benutzerdefinierten Agenten in den Body der Datei ein.

Um eine Definitionsdatei für einen benutzerdefinierten Agenten zu aktualisieren, wählen Sie Benutzerdefinierte Agenten konfigurieren aus dem Agenten-Dropdown und wählen Sie dann einen benutzerdefinierten Agenten aus der Liste aus, um ihn zu ändern.

Die Dropdown-Liste für Agenten anpassen

Wenn Sie mehrere benutzerdefinierte Agenten haben, können Sie anpassen, welche davon im Dropdown-Menü für Agenten angezeigt werden. Um bestimmte benutzerdefinierte Agenten anzuzeigen oder auszublenden

1. Wählen Sie Benutzerdefinierte Agenten konfigurieren aus dem Dropdown-Menü für Agenten.

2. Fahren Sie mit der Maus über einen benutzerdefinierten Agenten in der Liste und wählen Sie dann das Augen-Symbol aus, um ihn im Dropdown-Menü für Agenten anzuzeigen oder auszublenden.

Tool-Listen-Priorität

Sie können die Liste der verfügbaren Werkzeuge sowohl für einen benutzerdefinierten Agenten als auch für eine Eingabeaufforderungsdatei mithilfe des Metadatenfelds tools angeben. Eingabeaufforderungsdateien können auch einen benutzerdefinierten Agenten mithilfe des Metadatenfelds agent referenzieren.

Die Liste der im Chat verfügbaren Werkzeuge wird nach der folgenden Prioritätsreihenfolge bestimmt:

1. Werkzeuge, die in der Eingabeaufforderungsdatei angegeben sind (falls vorhanden).
2. Werkzeuge aus dem referenzierten benutzerdefinierten Agenten in der Eingabeaufforderungsdatei (falls vorhanden).
3. Standard-Werkzeuge für den ausgewählten Agenten (falls vorhanden).

Benutzerdefinierte Agenten teamsübergreifend teilen (experimentell)

Um benutzerdefinierte Agenten teamübergreifend zu teilen, können Sie einen benutzerdefinierten Agenten auf Arbeitsbereichsebene erstellen (.github/agents-Ordner). Wenn Sie benutzerdefinierte Agenten über mehrere Arbeitsbereiche innerhalb Ihrer Organisation hinweg teilen möchten, können Sie diese auf Ebene der GitHub-Organisation definieren.

VS Code erkennt automatisch benutzerdefinierte Agenten, die auf Organisationsebene definiert sind und auf die Ihr Konto Zugriff hat. Diese Agenten werden im Agenten-Dropdown im Chat neben den integrierten Agenten sowie Ihren persönlichen und benutzerdefinierten Agenten des Arbeitsbereichs angezeigt.

Um die Erkennung von benutzerdefinierten Agenten auf Organisationsebene zu aktivieren, setzen Sie github.copilot.chat.customAgents.showOrganizationAndEnterpriseAgents auf true.

Erfahren Sie, wie Sie benutzerdefinierte Agenten für Ihre Organisation erstellen in der GitHub-Dokumentation.

Häufig gestellte Fragen

Sind benutzerdefinierte Agenten anders als Chat-Modi?

Benutzerdefinierte Agenten waren früher als benutzerdefinierte Chat-Modi bekannt. Die Funktionalität bleibt gleich, aber die Terminologie wurde aktualisiert, um ihren Zweck bei der Anpassung des KI-Verhaltens für bestimmte Aufgaben besser widerzuspiegeln.

VS Code erkennt weiterhin alle vorhandenen .chatmode.md-Dateien als benutzerdefinierte Agenten. Sie können eine Schnelle Korrektur-Aktion verwenden, um sie umzubenennen und in den neuen Ordner .github/agents mit der Erweiterung .agent.md zu verschieben.

Verwandte Ressourcen

• Passen Sie die KI mit benutzerdefinierten Anweisungen an
• Wiederverwendbare Prompt-Dateien erstellen
• Werkzeuge im Chat verwenden