---
description: "Squads sind Teams von Agenten unter einer Leitung, die Arbeit an Mitglieder delegiert."
---

# Squads

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](/documentation/blume-assets/content/docs/img/screenshots/04-agents.png)

## 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](/documentation/blume-assets/content/docs/img/screenshots/04-agents.png)

## 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](/documentation/blume-assets/content/docs/img/screenshots/04-agents.png)

### 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