Subagents
Spezialisierte Experten-Agents, die der Hauptagent bei Bedarf hinzuziehen kann
Ein Subagent ist ein spezialisierter „Experte", den der Hauptagent (Worker) während der Aufgabenausführung jederzeit hinzuziehen kann. Jeder Subagent verfügt über eigenes Fachwissen, einen eigenen Prompt und kann sogar auf einem anderen Modell laufen. Geben Sie im Chat einfach @SubagentName ein, und er unterstützt Sie – genau wie das Erwähnen eines Kollegen in einem Gruppenchat.
Integrierte Subagents
Verdent wird standardmäßig mit 6 Subagents ausgeliefert, die die häufigsten Anforderungen in der Softwareentwicklung abdecken:
| Name | Standardmodell | Wofür er sich eignet |
|---|---|---|
| General | Folgt dem Hauptagenten | Ein universeller Recherche-Agent für komplexe Probleme, Codesuche und mehrstufige Aufgaben – hilft bei fast allem |
| Fast Context | Gemini 3 Flash | Schnelles Auffinden von Code und Sammeln von Kontextbelegen; spezialisiert auf Codebase-Indexierung und extrem schnell |
| Verifier | Sonnet 4.6 | Schnelle Code-Review – nach Änderungen einfach erwähnen, um offensichtliche Probleme zu erkennen |
| Verdent Helper | Haiku 4.5 | Ein Nutzungsassistent für Verdent; fragen Sie ihn alles zur Funktionsweise von Verdent |
| Multi-Model Planner | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Erstellt Pläne mit mehreren Modellen (Claude, GPT, Gemini) und führt deren Ergebnisse zusammen |
| Reviewer | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Vollständige Code-Review: Logikfehler, Randfälle, verborgene Risiken |
Zwei Subagents sind besonders: Multi-Model Planner und Reviewer führen 2–3 Modelle parallel aus. Jedes Modell denkt unabhängig, erzeugt eine eigene Ausgabe, und die Ergebnisse werden anschließend zusammengeführt. Alle anderen Subagents nutzen nur ein einzelnes Modell.
Verwendung von Subagents
Geben Sie in einer beliebigen Konversation @ ein, um das Auswahlmenü für Subagents zu öffnen (unscharfe Suche wird unterstützt). Wählen Sie den gewünschten Subagenten aus, und er übernimmt den aktuellen Kontext.
Beispiele:
- Nach dem Schreiben komplexer Authentifizierungslogik:
@Reviewer please review this→ Reviewer prüft sie aus Sicherheits-, Logik- und Randfall-Perspektive. - Bei einer schwierigen Architekturentscheidung:
@Multi-Model Planner→ mehrere Modelle schlagen Lösungen vor, und Sie wählen die beste aus. - Nach dem Programmieren schnell
@Verifierausführen → schneller als vollständige Testsuiten für eine grundlegende Validierung.
Benutzerdefinierte Subagents
Die integrierten Subagents decken die meisten Anforderungen ab, aber manchmal wünschen Sie sich einen Spezialisten, der genau auf Ihr Projekt zugeschnitten ist. Sie können eigene erstellen.
Speicherort
Benutzerdefinierte Subagents werden als Markdown-Dateien gespeichert unter:
~/.verdent/subagents/Zur Organisation werden bis zu 5 Ebenen von Unterverzeichnissen unterstützt.
Dateiformat
Jeder Subagent ist eine Markdown-Datei mit YAML-Frontmatter:
---
name: SQL-Expert
description: Specializes in SQL optimization and database design, good at analyzing slow queries and indexing strategies
color: blue
model: claude-sonnet-4-6
---
You are a senior database expert focused on PostgreSQL performance optimization.
When users provide SQL queries, you should:
1. Analyze the query execution plan
2. Identify performance bottlenecks (full table scans, missing indexes, etc.)
3. Provide concrete optimization suggestions and rewritten SQL
...Wichtige Details
- Name: darf nur Buchstaben, Zahlen und Bindestriche enthalten (z. B.
SQL-Expert,MyAgent123). Keine Leerzeichen oder Nicht-ASCII-Zeichen. - Farbe: eine von
dark-green,light-green,red-orange,amber,cyan,blue,pink,purple,verdent– zur einfacheren visuellen Erkennung. - Hot Reload: Das Speichern der Datei
.mdwirkt sich sofort aus – ein Neustart von Verdent ist nicht erforderlich.
Verwaltung von Subagents in den Einstellungen
Die gesamte Verwaltung von Subagents erfolgt unter Einstellungen → Subagents.
| Aktion | Beschreibung |
|---|---|
| Liste anzeigen | Alle Subagents werden als Karten dargestellt. Integrierte sind mit „Integriert" gekennzeichnet, plugin-basierte zeigen die Plugin-Namen. |
| Aktivieren / Deaktivieren | Schalten Sie jeden Subagenten ein oder aus, ohne die anderen zu beeinflussen. |
| Neu erstellen | Wählen Sie Subagent hinzufügen und geben Sie Bezeichner (eindeutiger Name), Modell, Beschreibung und Prompt ein. |
| Bearbeiten | Bewegen Sie den Mauszeiger über eine Karte, um sie zu bearbeiten. Bei integrierten Subagents können nur Modell und Beschreibung geändert werden. |
| Duplizieren | Kopieren Sie einen beliebigen benutzerdefinierten Subagenten (Duplikate sind standardmäßig deaktiviert, bis sie aktiviert werden). |
| Löschen | Benutzerdefinierte Subagents können entfernt werden (mit Bestätigung). Integrierte können nicht gelöscht werden. |
Unterschiede bei der Modellauswahl
- Multi-Model Planner und Reviewer unterstützen die Auswahl mehrerer Modelle gleichzeitig (2–3 Modelle).
- Andere Subagents verwenden die Auswahl eines einzelnen Modells.
- General verfügt über eine besondere Option: Er kann automatisch dem Modell des Hauptagenten folgen, sodass keine separate Konfiguration gepflegt werden muss.
Anwendungsfälle
Code-Review
Nach der Implementierung komplexer Logik @Reviewer erwähnen. Er prüft Korrektheit, Randfälle und mögliche Fehler – und erspart Ihnen die manuelle zeilenweise Kontrolle.
Architekturentwurf aus mehreren Perspektiven
Für wichtige Entscheidungen (z. B. Einführung von Microservices, Datenbankauswahl) nutzen Sie @Multi-Model Planner, um unabhängige Vorschläge von mehreren Top-Modellen zu erhalten und das Entscheidungsrisiko zu verringern.
Schnelle Validierung
Nach Codeänderungen prüft @Verifier schnell Syntax, Typen und grundlegende Probleme – schneller als vollständige Testsuiten und zuverlässiger als gar keine Prüfung.
Benutzerdefinierte Fachexperten
Erstellen Sie Subagents, die auf Ihr Projekt zugeschnitten sind:
- SQL-Optimierungsexperte mit Kenntnis Ihres Schemas und Ihrer Abfragemuster
- Wächter für Frontend-Coderichtlinien, der Ihre ESLint- und Design-System-Regeln durchsetzt
- Dokumentationsassistent, der technische Inhalte in klare, leserfreundliche Texte umwandelt
Hinweise
- Benutzerdefinierte Subagents müssen mit einem gültigen Modell konfiguriert sein, um aktiviert werden zu können. Wenn Sie BYOK verwenden und der Schlüssel abläuft oder das Modell eingestellt wird, wird der Subagent automatisch deaktiviert.
- Die Modelle integrierter Subagents können geändert werden, aber die Standardeinstellungen sind optimiert – Änderungen können die Leistung verschlechtern.
- Die Beschreibung ist entscheidend: Sie wird in den Kontext des Hauptagenten eingefügt und beeinflusst, wann Subagents aufgerufen werden. Bessere Beschreibungen führen zu intelligenterem Routing.
- Subagents können sich nicht gegenseitig aufrufen. Sie können nur vom Hauptagenten (Worker) aufgerufen werden – eine tiefere Verschachtelung ist nicht möglich.