Registrierung und Verwaltung von Subagenten

Überblick

Die Seite SubAgent (Settings → GWork Settings → SubAgent) dient dazu, Subagenten mit bestimmten Konfigurationen vorzuregistrieren. Vorregistrierte Subagenten werden automatisch in den Systemprompt des Haupt-Agenten injiziert, und der Haupt-Agent delegiert Aufgaben an sie (über dispatch_sub_agent), wenn er auf eine passende Aufgabe trifft.

Seite SubAgent

Bis Sie einen erstellen, zeigt die Seite „No sub-agents registered yet“ — das Werkzeug dispatch_sub_agent wird für den Haupt-Agenten erst aktiviert, wenn mindestens ein Subagent existiert.

Konfiguration eines Subagenten

Klicken Sie auf + SubAgent, um das Formular Create sub-agent zu öffnen:

Feld	Beschreibung	Erforderlich
ID	Eindeutiger Bezeichner, z. B. `code-reviewer`	Ja
Name	Anzeigename, z. B. `Code Reviewer`	Ja
Description	Was der Subagent tut. Der Haupt-Agent liest dies, um zu entscheiden, wann er an ihn delegiert — halten Sie es präzise und knapp	Ja
System prompt	Wird beim Delegieren geladen; wird zur Identität des Subagenten und beeinflusst die Aufgabenqualität direkt	Ja
Max turns	Maximale Schleifendurchläufe pro Delegation. Leer lassen, um den App-Standard (50) zu verwenden	Nein
Can spawn sub-agents	Ob dieser Subagent weitere Subagenten erstellen darf	Nein (standardmäßig aktiviert)

Klicken Sie auf Save, um ihn zu registrieren. Subagenten erben Modell und Werkzeuge des Haupt-Agenten, sofern der Aufgabenkontext nichts anderes vorgibt.

Verwaltungsoperationen

Operation	Beschreibung
+ SubAgent	Einen neuen vorregistrierten Subagenten erstellen
Edit	Einen bestehenden Subagenten öffnen und seine Konfiguration ändern
Delete	Einen vorregistrierten Subagenten entfernen

Interaktion mit Konversationen

Injektion in den Systemprompt: Name und Description jedes Subagenten werden im Systemprompt des Haupt-Agenten aufgeführt
Automatische Zuordnung: Der Haupt-Agent wählt den passenden Subagenten anhand der Semantik der Aufgabe aus
Manueller Aufruf: Sie können einen Subagenten in Ihrer Nachricht benennen, um ihn explizit anzufordern

Subagenten-Läufe werden durch Max turns hier und durch das Sub-agent timeout (minutes) unter Settings → Task Control begrenzt (Standard 30 Minuten; abgeschlossene Arbeit bleibt erhalten, wenn ein Subagent abgebrochen wird).

Anwendungsbeispiele

Subagent	Beschreibung	Typische Werkzeuge
Code Reviewer	Prüft Code auf Korrektheit, Leistung und Sicherheit	Read file, Search in files, Find files
Document Writer	Schreibt und formatiert Dokumente	Write file, Fähigkeiten docx / pptx
Research Assistant	Sucht und sammelt Informationen	Browser, Fähigkeit web-search
Data Analyst	Verarbeitet und analysiert Daten	Run command, Read file, Write file

Anleitung: Einen vorregistrierten Subagenten erstellen

Öffnen Sie App → ⚙ Settings → SubAgent
Klicken Sie auf + SubAgent
Füllen Sie aus:
- ID: code-reviewer
- Name: Code Reviewer
- Description: „Prüft Code auf Korrektheit, Leistung und Sicherheit. Gut in mehrsprachiger Codeanalyse.“
- System prompt: „Du bist ein erfahrener Code-Reviewer. Analysiere Code auf Korrektheit, Leistung, Sicherheit und Wartbarkeit. Gib für jedes Problem einen Schweregrad (niedrig / mittel / hoch) und einen Korrekturvorschlag an.“
(Optional) Setzen Sie Max turns (z. B. 30) und schalten Sie Can spawn sub-agents aus, wenn keine weitere Delegation nötig ist
Klicken Sie auf Save

Die praktische Auswirkung der Delegationstiefe

Einstellung	Bedeutung	Kostenauswirkung
Can spawn sub-agents: aus	Der Subagent kann keine untergeordneten Subagenten erstellen	Niedrig
Can spawn sub-agents: ein	Der Subagent darf weiter delegieren	Höher — jede Ebene führt ihre eigene Agent-Schleife aus und verbraucht eigene Tokens / Credits

Hinweis: Jede Subagenten-Ebene startet eine unabhängige Agent-Schleife (standardmäßig 50 Durchläufe). Tiefe Delegation kann die Kosten einer einzelnen Aufgabe vervielfachen; lassen Sie das Erzeugen weiterer Subagenten für einfache spezialisierte Rollen ausgeschaltet.

Vorregistrierung vs. automatische Erstellung: Wie wählen?

Vergleich	Vorregistrierung (`dispatch_sub_agent`)	Automatische Erstellung (`create_local_sub_agent`)
Konfiguration	Im Voraus konfiguriert, ein für alle Mal	Bei Bedarf jedes Mal vorübergehend vom Agenten erstellt
Konsistenz	Verwendet jedes Mal dieselbe Konfiguration, mit stabilen Ergebnissen	Der Agent weist möglicherweise jedes Mal andere Identitäten und Werkzeuge zu
Geeignete Szenarien	Professionelle Rollen, die häufig und wiederholt verwendet werden	Einmalige, temporäre Aufgabenzerlegung
Systemprompt	Wird automatisch in den Haupt-Agenten injiziert, sodass der Agent weiß, dass er verwendet werden kann	Der Agent entscheidet selbst, ob er einen erstellt

Empfehlung: Wenn Sie eine bestimmte Art von Aufgabe häufig benötigen (z. B. Code-Review, Dokumentenerstellung oder Datenanalyse), erstellen Sie einen vorregistrierten Subagenten. Für gelegentliche temporäre Aufgabenzerlegung lassen Sie den Agenten einfach automatisch einen erstellen.