Zum Inhalt springen
Agent Orchestrator Docs
Esc
↑↓navigieren↵öffnen⌘Jvorschau
Auf dieser Seite

Squads

Squads sind Teams von Agenten unter einer Leitung, die Arbeit an Mitglieder delegiert.

Squads sind Teams von Agenten unter einer Leitung, die Arbeit an Mitglieder delegiert. Weise einem Squad eine Aufgabe zu, und die Leitung zerlegt sie, verteilt Teilaufgaben und fasst die Ergebnisse zusammen.

Squads

Konzept

Task → Squad Leader → delegates to Members → each = child Run
                              ↓
                        synthesizes → single result

Jede Delegation ist eine vollwertige untergeordnete Ausführung — nachvollziehbar, nutzungsbezogen erfasst, mit eigenem Chat und eigenen Logs.

Squad erstellen

  1. Seite Squads → Neuer Squad (Seitenkopf) — der Dialog Squad erstellen öffnet sich im Modus Manuell
  2. Fülle aus:
    • Name — z. B. „Frontend-Team“, „Migrations-Squad“
    • Beschreibung — Wofür dieser Squad zuständig ist
  3. Wähle die Leitung — muss ein Agent sein (erhält die Aufgabe, delegiert)
  4. Füge Mitglieder hinzu — ein oder mehrere Agenten (führen die delegierte Arbeit aus)
  5. Squad erstellen

Squad Creation

Squad exportieren und importieren

  • Export — Öffne das Menü auf einer Squad-Karte → Squad exportieren. Du erhältst eine .ao-Datei mit dem Squad und allen seinen Mitglieds-Agenten (mit deren Skills und Einstellungen). Agent-Secrets sind nie enthalten.
  • Import — Neuer Squad → .ao importieren → Datei auswählen. Es wird eine Vorschau angezeigt; drücke Importieren, um den Squad und alle seine Mitglieds-Agenten in diesem Workspace anzulegen.
  • Importierte Agenten kommen deaktiviert an. Aktiviere jeden einzelnen — und stelle sicher, dass er eine Runtime hat —, bevor der Squad laufen kann.

Squad-Details

Klicke auf einen Squad (auf der Agenten-Seite oder über den Link zu den Squad-Details), um Folgendes zu öffnen:

Squad Org Chart

Organigramm (Desktop)

Visueller Baum von der Leitung zu den Mitgliedern:

  • SVG-Canvas — Verschieben (Ziehen), Zoomen (Mausrad), Bézier-Verbindungen
  • Knotenkarten — Agent-Avatar + Name + Rolle
  • Klick auf Knoten → Wechsel zu den Agent-Details

Telefonansicht

Flache Mitgliederliste mit Löschen-Funktion (das Organigramm ist auf Mobilgeräten ausgeblendet).

Übersichtsbereich

  • Beschreibung
  • Anzeige der Leitung (immer sichtbar)

Tab Aktivität

Alle Ausführungen aus Aufgaben, die diesem Squad zugewiesen sind — wie die Aktivität eines Agenten.

Aufgaben Squads zuweisen

Vom Aufgaben-Board

  1. Neue Aufgabe → Zuständig: Squad → Squad auswählen
  2. Oder bestehende Aufgabe → Zuweisen → Squad → auswählen

Aus den Aufgabendetails

Klicke auf den Chip Zuständig → Squad → Squad auswählen.

So funktioniert die Delegation

  1. Aufgabe wird dem Squad zugewiesen → erzeugt die Ausführung der Leitung
  2. Die Leitung analysiert → zerlegt die Arbeit in Teilaufgaben
  3. Die Leitung delegiert → Tool delegate_to_member → erzeugt untergeordnete Ausführungen
  4. Mitglieder arbeiten → parallel, jedes in einer eigenen Ausführung
  5. Mitglieder schließen ab → Ergebnisse fließen zur Leitung zurück
  6. Die Leitung fasst zusammen → kombiniert zu einem einzigen Ergebnis
  7. Die Leitung schließt ab → Aufgabe wechselt in Prüfung

Statuskaskade

  • Nur die Ausführung der Leitung steuert den Aufgabenstatus
  • Abschlüsse von Mitgliedern = Zwischenschritte (verschieben die Aufgabe nicht)
  • Leitung schließt ab → Aufgabe → Prüfung
  • Leitung scheitert → Aufgabe → Fehlgeschlagen

Abbruchkaskade

  • Stoppen bei der Aufgabe → bricht die Leitung und alle untergeordneten Ausführungen ab
  • Sendet run.status_changed / task.status_changed → die Oberfläche aktualisiert sich live

Sichtbarkeit der Mitglieder-Ergebnisse

Die Leitung kann auf Ergebnisse der Mitglieder zugreifen:

  • Automatisch eingespeist — Die Zusammenfassung der Leitung sieht die Ausgaben der Mitglieder
  • Manuell abrufen — Das Tool collect_results holt gezielt Ausgaben einzelner untergeordneter Ausführungen
  • Dateien — Artefakte der Mitglieder werden in das Arbeitsverzeichnis der Leitung kopiert, unter member_outputs/<member>_<run8>/

Squad-Berechtigungen

Aktion Wer
Squad erstellen Workspace-Administrator
Squad bearbeiten Workspace-Administrator
Squad löschen Workspace-Administrator
Aufgabe einem Squad zuweisen Jedes Mitglied (wenn der Squad existiert)
Squad-Details ansehen Jedes Mitglied

Squads vs. einzelne Agenten

Aspekt Einzelner Agent Squad
Komplexität Einzelne Aufgabe Komplexe, mehrteilige Arbeit
Parallelität Sequenziell Parallele Ausführung durch Mitglieder
Nachvollziehbarkeit Eine Ausführung Leitung + N untergeordnete Ausführungen
Kosten Ein Modellaufruf Mehrere (pro untergeordneter Ausführung erfasst)
Am besten für Fokussierte, klar definierte Aufgaben Mehrstufige Aufgaben mit unterschiedlichem Skill-Bedarf

Letzte Neuerungen

  • Agenten-Squads — Teambasierte Delegationen mit Leitung und Mitgliedern
  • Organigramm — Visueller SVG-Baum mit Verschieben/Zoomen
  • Statuskaskade — Nur die Leitung verschiebt den Aufgabenstatus
  • Abbruchkaskade — Stoppen bricht den gesamten Delegationsbaum ab
  • Sichtbarkeit der Mitglieder-Ergebnisse — Die Leitung greift auf alle Ergebnisse der untergeordneten Ausführungen zu