Registrierung und Verwaltung von Subagenten

Überblick

Die Seite zur Subagenten-Verwaltung dient dazu, Subagenten mit einer bestimmten Konfiguration vorzuregistrieren. Vorregistrierte Subagenten werden automatisch in den System-Prompt des Haupt-Agenten eingefügt, und der Agent wählt sie bei passenden Aufgaben automatisch zum Aufruf aus.

Seite zur Subagenten-Verwaltung-CN

Konfiguration vorregistrierter Subagenten

Grundkonfiguration

Parameter	Beschreibung	Pflichtfeld
`name`	Name des Subagenten	Ja
`description`	Fähigkeitsbeschreibung (wird in den System-Prompt des übergeordneten Agenten eingefügt)	Ja
`systemPrompt`	Identitäts-/Rollendefinition	Ja

Werkzeugkonfiguration

Parameter	Beschreibung
`tools`	Werkzeug-Whitelist (bei Auslassung werden alle Werkzeuge des übergeordneten Agenten geerbt)
`disallowedTools`	Werkzeug-Blacklist (schließt auf Basis der geerbten Werkzeuge aus)
`skills`	Liste der verfügbaren Skill-IDs
`mcpServers`	Liste der verfügbaren MCP-Servernamen

Ausführungskonfiguration

Parameter	Beschreibung	Standardwert
`model`	Überschreibt das LLM-Modell des übergeordneten Agenten	Erbt vom übergeordneten Agenten
`maxTurns`	Maximale Anzahl an Schleifendurchläufen	50
`canSpawn`	Ob untergeordnete Subagenten erstellt werden dürfen	false
`maxSpawnDepth`	Maximale Verschachtelungstiefe (1-3)	1

Verwaltungsaktionen

Aktion	Beschreibung
Hinzufügen	Einen neuen vorregistrierten Subagenten erstellen
Bearbeiten	Die Konfiguration eines bestehenden Subagenten ändern
Löschen	Einen vorregistrierten Subagenten entfernen
Sortieren	Die Reihenfolge der Subagenten in der Liste anpassen

Zusammenspiel mit dem Work-Dialog

Vorregistrierte Subagenten wirken auf folgende Weise mit dem Work-Dialog zusammen:

System-Prompt-Einfügung: Der name und die description des Subagenten werden im System-Prompt des Haupt-Agenten aufgeführt
Automatische Zuordnung: Das LLM wählt anhand der Semantik der Benutzernachricht automatisch den passenden Subagenten aus
Manueller Aufruf: Der Benutzer kann im Dialog die Verwendung eines bestimmten Subagenten angeben

Beispiele für Anwendungsfälle

Name des Subagenten	Beschreibung	Spezialwerkzeuge
Code-Prüfer	Zuständig für Code-Reviews und Qualitätsanalysen	Read File, Search Files, Glob
Dokumentationsautor	Zuständig für das Verfassen und Formatieren von Dokumenten	Write File, Edit, Web Fetch
Recherche-Assistent	Zuständig für die Informationssuche und Materialsammlung	Web Fetch, Search Files
Datenanalyst	Zuständig für Datenverarbeitung und -analyse	Bash, Read File, Write File

Anleitung: Einen vorregistrierten Subagenten erstellen

Schritte

Öffnen Sie APP → Einstellungen → Subagenten
Klicken Sie auf Subagent hinzufügen
Füllen Sie die Grundinformationen aus:
- Name: z. B. „Code-Prüfer"
- Beschreibung: z. B. „Zuständig für die Prüfung der Codequalität, das Aufspüren potenzieller Bugs und Optimierungsvorschläge" (diese Beschreibung wird in den System-Prompt des Haupt-Agenten eingefügt und hilft dem Agenten zu entscheiden, wann er aufgerufen werden soll)
- System-Prompt: z. B. „Du bist ein erfahrener Code-Review-Experte, der auf Codequalität, Leistung, Sicherheit und Wartbarkeit achtet..."
(Optional) Werkzeug-Whitelist/-Blacklist konfigurieren
(Optional) Modell überschreiben oder maxTurns anpassen
Speichern

Konfigurationsbeispiel: Subagent „Code-Prüfer"

Name: Code-Prüfer Beschreibung: Zuständig für die Prüfung der Codequalität, das Aufspüren potenzieller Bugs und das Bereitstellen von Optimierungsvorschlägen. Spezialisiert auf mehrsprachige Codeanalyse. System-Prompt: Du bist ein erfahrener Code-Review-Experte. Deine Aufgaben sind: 1. Codequalität und Wartbarkeit analysieren 2. Potenzielle Bugs und Sicherheitslücken aufspüren 3. Konkrete Optimierungsvorschläge liefern Gib zu jedem Problem einen Schweregrad (niedrig/mittel/hoch) und einen Behebungsvorschlag an. Werkzeug-Whitelist: Read File, Search Files, Glob Files (nur Lesefähigkeit erforderlich, keine Änderungen nötig) Modell: Claude Sonnet 4 (starke Argumentationsfähigkeit) maxTurns: 30 canSpawn: false (keine weitere Delegation nötig)

                      
                      Name: Code-Prüfer
Beschreibung: Zuständig für die Prüfung der Codequalität, das Aufspüren potenzieller Bugs und das Bereitstellen von Optimierungsvorschlägen. Spezialisiert auf mehrsprachige Codeanalyse.
System-Prompt: Du bist ein erfahrener Code-Review-Experte. Deine Aufgaben sind:
  1. Codequalität und Wartbarkeit analysieren
  2. Potenzielle Bugs und Sicherheitslücken aufspüren
  3. Konkrete Optimierungsvorschläge liefern
  Gib zu jedem Problem einen Schweregrad (niedrig/mittel/hoch) und einen Behebungsvorschlag an.
Werkzeug-Whitelist: Read File, Search Files, Glob Files (nur Lesefähigkeit erforderlich, keine Änderungen nötig)
Modell: Claude Sonnet 4 (starke Argumentationsfähigkeit)
maxTurns: 30
canSpawn: false (keine weitere Delegation nötig)

Dieser Codeblock im schwebenden Fenster

Tatsächliche Auswirkung von maxSpawnDepth

Einstellung	Bedeutung	Anwendungsfall	Kostenauswirkung
1 (Standard)	Subagent kann keine untergeordneten Subagenten mehr erstellen	Einfache Spezialaufgaben	Niedrig
2	Subagent kann eine weitere Ebene von Subagenten erstellen	Mittelkomplexe Aufgaben, die eine zweite Zerlegung erfordern	Mittel
3	Maximale Verschachtelungstiefe, erlaubt Delegation über drei Ebenen	Hochkomplexe, mehrstufige Aufgaben	Hoch (jede Ebene von Subagenten verbraucht eigenständig Token)

Hinweis: Jede Ebene von Subagenten startet einen eigenständigen Agent Loop (standardmäßig 50 Durchläufe) und verbraucht eigenständige LLM-Token. Tiefe 3 bedeutet, dass maximal 4 Agenten gleichzeitig laufen können (Haupt-Agent + 3 Ebenen Subagenten), wodurch die Kosten ein Vielfaches eines einzelnen Agenten betragen können.

Vorregistrierung vs. automatische Erstellung: Wie wählt man?

Vergleich	Vorregistrierung (dispatch_sub_agent)	Automatische Erstellung (create_local_sub_agent)
Konfiguration	Vorab konfiguriert, ein für alle Mal	Der Agent erstellt bei Bedarf temporär
Konsistenz	Bei jeder Verwendung dieselbe Konfiguration, stabile Ergebnisse	Der Agent kann jedes Mal eine andere Identität und andere Werkzeuge vergeben
Geeigneter Anwendungsfall	Häufig wiederverwendete Fachrollen	Einmalige, temporäre Aufgabenzerlegung
System-Prompt	Wird automatisch in den Haupt-Agenten eingefügt, der Agent weiß, dass er ihn verwenden kann	Der Agent entscheidet selbstständig, ob er erstellt wird

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