Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Antigravity CLI 2 – Subagenten & Multi-Agenten Orchestrierung¶

Subagenten sind eigenständige KI-Agenteninstanzen, die vom Haupt-Agenten im Antigravity CLI (agy) gestartet werden. Sie ermöglichen die parallele Bearbeitung komplexer Aufgaben, ohne das Haupt-Kontextfenster zu überlasten.

🤖 Das Subagenten-Konzept im Antigravity CLI¶

Ein Subagent läuft in einem separaten Ausführungskontext. Er kann über eigene Tools, ein spezialisiertes Modell (z. B. ein schnelleres flash-Modell für Suchen) und einen isolierten Workspace verfügen.

graph TD
    Parent[Haupt-CLI Agent 'agy'] -->|1. invoke_subagent| Sub1["Subagent: Code-Researcher"]
    Parent -->|1. invoke_subagent| Sub2["Subagent: Doc-Checker"]

    Sub1 -->|"Liest Dateien & sucht"| Res1[Recherche-Ergebnis]
    Sub2 -->|Führt Build aus| Res2[Build-Status]

    Res1 -->|"2. send_message / Auto-Notify"| Parent
    Res2 -->|"2. send_message / Auto-Notify"| Parent

🛠️ Werkzeuge zur Subagenten-Steuerung¶

Der Antigravity CLI stellt vier primäre Schnittstellen für die Subagenten-Verwaltung bereit:

Tool	Zweck
`invoke_subagent`	Startet einen oder mehrere Subagenten mit definierter Rolle, Modell und Prompt.
`define_subagent`	Definieren neuer Subagenten-Typen mit benutzerdefiniertem System-Prompt und Tools.
`send_message`	Sendet Nachrichten/Instruktionen an einen laufenden Subagenten via ConversationID.
`manage_subagents`	Listet laufende Subagenten auf (`list`) oder beendet sie (`kill`, `kill_all`).

🚀 Schritt-für-Schritt: Subagenten erstellen & aufrufen¶

1. Einen vordefinierten Subagenten starten (`invoke_subagent`)¶

Um einen Subagenten für eine spezifische Teilaufgabe zu starten, übergeben Sie die Parameter TypeName, Role und Prompt:

{
  "Subagents": [
    {
      "TypeName": "research",
      "Role": "Codebase Researcher",
      "Model": "flash",
      "Prompt": "Durchsuche das Verzeichnis src/auth nach allen Stellen, an denen JWT-Tokens validiert werden, und liefere eine Zusammenstellung der Dateipfade und Zeilen."
    }
  ]
}

2. Einen neuen Subagenten-Typ definieren (`define_subagent`)¶

Wenn ein spezialisierter Agententyp benötigt wird, der im Projekt noch nicht existiert, kann er dynamisch definiert werden:

{
  "name": "security-auditor",
  "description": "Prüft Codeänderungen auf OWASP Top 10 Sicherheitslücken.",
  "system_prompt": "Du bist ein erfahrener Security-Auditor. Prüfe allen eingehenden Code auf SQL-Injection, XSS und unsichere Deserialisierung.",
  "enable_write_tools": false,
  "enable_subagent_tools": false
}

Nach der Definition steht der Typ security-auditor sofort über invoke_subagent bereit.

⚙️ Workspace-Modi & Modell-Auswahl¶

Workspace-Isolierung¶

Beim Start eines Subagenten kann festgelegt werden, wie dieser auf das Dateisystem zugreift:

inherit (Default): Nutzt dasselbe Arbeitsverzeichnis wie der Haupt-Agent.
branch: Erstellt einen isolierten Workspace-Branch/Klon für gefahrlose Experimente.
share: Nutzt Verzeichnis-Sharing (Git Worktree Äquivalent) für unabhängige Branches ohne Speicherverdopplung.

Modell-Stufen (`Model`)¶

inherit: Nutzt das Modell des Haupt-Agenten.
flash_lite / flash: Sehr schnelle, kosteneffiziente Modelle für reine Suchen, File-Reads und Einfachaufgaben.
pro: Großes Modell mit tiefem Denkvermögen für komplexe Refactorings und Architekturplanung.

💡 Best Practices für Multi-Agenten-Workflows¶

Kein manuelles Polling erforderlich: Der Antigravity CLI nutzt ein reaktives Event-System. Sobald ein Subagent seine Aufgabe beendet oder eine Nachricht sendet, wird der Haupt-Agent automatisch aufgeweckt.
Gezielter Einsatz von flash-Modellen: Delegieren Sie aufwendige Datei-Suchläufe oder Log-Analysen an Subagenten mit Model: "flash", um Zeit und Token-Budget zu sparen.
Subagenten nach Abschluss aufräumen: Nutzen Sie manage_subagents mit Action="kill_all", um beendete Subagenten-Instanzen nach der Aufgabenfertigstellung sauber zu schließen.

🔗 Verwandte Themen¶