Schwärme
Ein Schwarm ist eine Gruppe von Agenten, mit der eine Benutzerin oder ein
Benutzer gemeinsam in einem Chat-Raum spricht. Schwärme sind privat: Jeder
Schwarm gehört der Person, die ihn erstellt hat, und nur sie kann ihn sehen,
bearbeiten und darin chatten. Die Seite „Schwärme“ (/admin/swarms) ist deshalb
eine reine Übersicht für Administratoren — Sie sehen jeden Schwarm der
Instanz und können ihn löschen, aber weder öffnen noch bearbeiten. Wie sich ein
Schwarm im Gespräch verhält, beschreibt das Konzept
Schwarm-Chat.
Schwärme sind nicht zu verwechseln mit den Teams: Ein Team ist eine Gruppe von Menschen mit gemeinsamem Arbeitsbereich, ein Schwarm eine Gruppe von Agenten.

Die Schwarmliste
Die Übersicht zeigt alle vorhandenen Schwärme in einer Tabelle mit den Spalten:
| Spalte | Beschreibung |
|---|---|
| Name | Der Name des Schwarms |
| Eigentümer | Die Person, die den Schwarm erstellt hat. Eigene Schwärme erscheinen als Sie; Schwärme, die vor der Einführung privater Schwärme entstanden sind, zeigen Kein Eigentümer (angelegt, bevor Schwärme privat wurden) |
| Mitglieder | Die Anzahl der Schwarmmitglieder |
Die Zeilen sind nicht anklickbar: Das Recht, Schwärme aufzulisten und zu löschen, gewährt keinen Lesezugriff auf den Schwarm einer anderen Person. Sind noch keine Schwärme vorhanden, erscheint der Hinweis Noch keine Schwärme.
Ist die Funktion für Ihre Instanz nicht freigeschaltet, zeigt die Seite stattdessen den Hinweis Schwärme sind für diese Instanz nicht freigeschaltet. Schwärme sind eine Premium-Funktion.
Einen Schwarm löschen
Über die Zeilenaktion Löschen entfernen Administratoren einen Schwarm samt allen seinen Gesprächen. Eine Rückfrage („Schwarm löschen?“) schützt vor Versehen; das Löschen lässt sich nicht rückgängig machen.
Wer Schwärme erstellt und nutzt
Schwärme werden nicht im Admin-Bereich, sondern von den Benutzerinnen und Benutzern selbst angelegt:
- Wer die Berechtigung Schwärme erstellen (
team:create) hat, sieht in der linken Seitenleiste den Abschnitt Schwärme mit der Schaltfläche Neuer Schwarm. Administratoren besitzen die Berechtigung ohnehin. - Im Dialog vergeben Sie einen Namen, wählen die Agenten des Schwarms — es stehen nur Agenten zur Auswahl, die Sie selbst nutzen dürfen — und legen fest, welcher davon die Leitung ist. Mindestens ein Agent und eine Leitung sind erforderlich.
- Der Schwarm erscheint danach in der Seitenleiste der Person, die ihn erstellt
hat, und ist unter
/swarm/<schwarm-id>erreichbar. Fremde Personen — auch Administratoren — erhalten dort den Hinweis „Schwarm nicht gefunden“.
Die Berechtigung Schwärme verwalten (team:manage) ist ein schmaler
Mandanten-Hebel: Sie erlaubt, die Schwärme aller Benutzer aufzulisten und jeden
davon zu löschen — nicht aber, sie zu lesen oder darin zu chatten.
Hop-Limit und Kostenobergrenze
Zwei Obergrenzen pro Gesprächsrunde lassen sich am Schwarm hinterlegen. Der
Dialog in der Oberfläche bietet dafür keine Felder an; sie werden über die
Management-API als Felder hopCap und
costCeiling des Schwarms gesetzt:
- Hop-Limit (
hopCap) — die maximale Anzahl an Mitglied-Aktivierungen pro Runde. - Kostenobergrenze (
costCeiling) — der maximale Gesamt-Tokenverbrauch pro Runde.
Für beide gilt: 0 = unbegrenzt. Wird eine Grenze während eines laufenden Gesprächs erreicht, stoppt BasePeak.AI die Runde automatisch und hinterlässt im Raum einen Systemhinweis (z. B. „Stopped: hop cap reached (5 / 5).“), statt unkontrolliert weiterzulaufen. Einmal gesetzte Werte bleiben beim Bearbeiten des Schwarms in der Oberfläche erhalten.
Ein Mitglied läuft stets mit dem eigenen Wissen und den eigenen Werkzeugen des zugrunde liegenden Agenten. Sie stellen einen Schwarm also aus bestehenden Agenten zusammen; deren Konfiguration bleibt unverändert und wird für den Schwarm-Chat wiederverwendet.