Gemini CLI Subagents

Was sind Gemini CLI Subagents?

Subagents sind spezialisierte Expert-Agenten, die parallel zu Ihrer primären Gemini CLI-Sitzung laufen. Wenn Sie Gemini CLI eine umfassende oder komplexe Aufgabe geben, kann der Hauptagent spezifische Unteraufgaben an den relevantesten Subagenten delegieren und als Orchestrator fungieren.

Jeder Subagent läuft isoliert mit eigenem Kontextfenster, individuellen Systemanweisungen und einem kuratierten Tool-Set. Ihre Arbeit – potenziell mit vielen Tool-Aufrufen, Suchen oder Testläufen – wird zu einer einzigen Antwort konsolidiert, die an die Hauptsitzung zurückgegeben wird.

Wichtige Funktionen

• Delegation an Spezialisten: Gemini CLI zerlegt große Aufgaben in Unteraufgaben und leitet sie an gezielte Subagents weiter.
• Isolierte Ausführungsumgebungen: Jeder Subagent hat eigenes Kontextfenster, Systemanweisungen und kuratiertes Tool-Set, um die Hauptsitzung übersichtlich zu halten.
• Konsolidierung von Tools und Kontext: Zwischenschritte der Subagents werden zu einer Antwort für den Hauptagenten zusammengefasst.
• Parallele Subagent-Ausführung: Gemini CLI unterstützt das gleichzeitige Ausführen mehrerer Subagents (unterschiedliche oder mehrere Instanzen desselben).
• Eigene Subagent-Definitionen: Erstellen Sie eigene Subagents mit einfachen Markdown-Dateien inklusive YAML-Frontmatter.

So verwenden Sie Gemini CLI Subagents

1. Erstellen Sie eine Subagent-Definition in einer Markdown-Datei (.md) mit YAML-Frontmatter, das Felder wie name, description, tools und model angibt (wie im Beispiel für einen „frontend-specialist“ gezeigt).
2. Legen Sie die Definition in einem unterstützten Ordner ab:
   • Für persönliche Workflows: ~/.gemini/agents
   • Für Team-/Projekt-Sharing: .gemini/agents
   • Für Erweiterungen: Fügen Sie Agent-Definitionen in das agents/-Verzeichnis der Erweiterung ein.
3. Nutzen Sie Gemini CLI wie gewohnt: Geben Sie Ihre Gesamtaufgabe in der Hauptsitzung ein; Gemini CLI verteilt dann relevante Unteraufgaben an Subagents.
4. (Bei Bedarf) Parallele Ausführung: Bei Aufgaben, die sich in unabhängige Recherche-/Refactoring-/Test-Tracks aufteilen, startet Gemini CLI mehrere Subagents gleichzeitig.

Anwendungsfälle

• Recherche zu mehreren Themen: Delegieren Sie separate Recherche-Threads an verschiedene Subagents, führen Sie sie parallel aus und erhalten Sie konsolidierte Ergebnisse in der Hauptsitzung.
• Refactoring mehrerer Komponenten: Teilen Sie ein Refactoring in komponentenspezifische Aufgaben auf und lassen Sie spezialisierte Subagents jede bearbeiten, ohne das primäre Kontextfenster zu überladen.
• Code-Erkundung und -Analyse: Nutzen Sie Expert-Subagents zur Untersuchung von Code-Abschnitten und erhalten Sie Zusammenfassungen oder formatierte Ergebnisse, während der Hauptagent Entscheidungen trifft und die Synthese übernimmt.
• Testing und Validierung: Lagern Sie Test-Sequenzen (mit vielen Tool-Aufrufen) an Subagents aus, damit die Hauptsitzung responsiv bleibt.
• Workflow-spezifische Automatisierung mit Custom Personas: Erstellen Sie wiederverwendbare Spezialagenten (z. B. Frontend/UI-UX-Persona), um konsistente Ansätze und Tool-Nutzung in wiederkehrenden Projekten zu gewährleisten.

FAQ

Wie unterscheiden sich Subagents von der Hauptsitzung von Gemini CLI?
Subagents sind spezialisierte Expert-Agenten, die parallel zur primären Sitzung laufen. Sie arbeiten isoliert mit eigenem Kontextfenster, Systemanweisungen und Tools und liefern konsolidierte Ergebnisse zurück.

Kann Gemini CLI mehrere Subagents gleichzeitig ausführen?
Ja. Gemini CLI unterstützt parallele Ausführung, inklusive mehrerer Subagents oder Instanzen desselben Subagents.

Wie werden eigene Subagents konfiguriert?
Eigene Subagents werden mit Markdown-Dateien (.md) inklusive YAML-Frontmatter definiert. Platzieren Sie sie in ~/.gemini/agents für persönliche Nutzung, .gemini/agents für Projekt-Sharing oder im agents/-Verzeichnis einer Erweiterung.

Was passiert mit der Zwangsarbeit der Subagents?
Subagents führen viele Tool-Aufrufe, Dateisuche oder Testläufe aus, aber alles wird zu einer einzigen Antwort für den Hauptagenten konsolidiert.

Haben Subagents eigene Tools und Systemanweisungen?
Ja. Jeder Subagent hat ein eigenes kuratiertes Tool-Set und individuelle Systemanweisungen, unabhängig von der primären Sitzung.

Alternativen

• Single-Agent-Prompting ohne Delegation: Sie können Gemini CLI bitten, alles in einem Kontext zu handhaben. Das vermeidet die Einrichtung benutzerdefinierter Agenten, kann aber längere Prompts erfordern oder unter Kontextwachstum leiden.
• Manuelles Aufteilen des Workflows: Sie können separate, unabhängige Prompts für jede Unteraufgabe ausführen und die Ergebnisse selbst zusammenführen. Das kann Delegation nachahmen, aber Sie übernehmen Orchestrierung und Konsolidierung.
• Allgemeine Multi-Agent-Frameworks: Tool- oder Framework-basierte Multi-Agent-Ansätze können Aufgaben ebenfalls an spezialisierte Rollen routen, wobei Workflow und Konfiguration jedoch von den Subagent-Definitionen und dem Isolationsmodell von Gemini CLI abweichen.
• Chat-basierte Agentenrollen (keine Subagents): Wenn Ihr Anwendungsfall primär rollenbasierte Unterstützung statt isolierter paralleler Tool-Ausführung ist, reicht einfaches Roll-Prompting möglicherweise aus – mit weniger Kontrolle über Isolation und konsolidierte Unterergebnisse.