---
description: "Agenten sind konfigurierte KI-Mitarbeiter mit Name, System-Prompt, Modell, zugewiesenen Skills, MCP-Servern und expliziten Tool-Berechtigungen."
---

# Agenten

Agenten sind konfigurierte KI-Mitarbeiter mit Name, System-Prompt, Modell, zugewiesenen Skills, MCP-Servern und expliziten Tool-Berechtigungen. Jeder Agent ist ein wiederholbarer, kontrollierter Experte – kein einmaliger Chat-Prompt.

![Agenten-Übersicht](/documentation/blume-assets/content/docs/img/screenshots/04-agents.png)

## Agentenliste

Die Seite **Agenten** zeigt ein Kartenraster aller Agenten im aktuellen Workspace.

![Agentenkarte](/documentation/blume-assets/content/docs/img/screenshots/04-agents.png)

Jede Karte zeigt:
- **Avatar** – eigenes Bild hochladen oder generierte Initialen verwenden
- **Name** – Klick öffnet die Agent-Details
- **Squad-Label** – falls der Agent zu einem oder mehreren Squads gehört
- **Beschreibung** – auf 4 Zeilen gekürzt (auf Mobilgeräten 2)
- **Kartenmenü** – **Chat öffnen** und **Aufgabe erstellen** (beides nur bei einem aktiven Agenten) sowie **Agent deaktivieren** / **Agent aktivieren**

## Agent-Details

Ein Klick auf eine Agentenkarte öffnet die vollständige Detailansicht mit Tabs:

![Agent-Details Profil](/documentation/blume-assets/content/docs/img/screenshots/05-agent-detail.png)

### Tab „Profil“

- **Identität** – Name, Beschreibung, Avatar
- **System-Prompt** – vollständiger Prompt-Editor mit Syntaxhervorhebung
- **Ausführung** – Runtime-Auswahl, Modell, Temperatur, maximale Tokens
- **Squad-Mitgliedschaften** – zu welchen Squads dieser Agent gehört

### Tab „System-Prompt“

Vollbild-Editor für den System-Prompt des Agenten. Das ist die zentrale Anweisung, die das Verhalten des Agenten festlegt.

### Tab „Skills“

![Agent-Skills](/documentation/blume-assets/content/docs/img/screenshots/05b-agent-detail-skills.png)

- **Zugewiesene Skills** – Liste mit Version, Kategorie und Schalter zum Aktivieren/Deaktivieren
- **Skill hinzufügen** – suchen und aus der Skill-Registry des Workspace zuweisen
- **Skill entfernen** – Zuweisung aufheben (der Skill bleibt in der Registry)

### Tab „MCP-Server“

- **Konfigurierte Server** – Name, URL, Status, Aktivieren/Deaktivieren
- **Server hinzufügen** – URL + optionale Auth-Header
- **Verbindung testen** – vor dem Speichern prüfen

### Tab „Aktivität“

Live-Feed von allem, was dieser Agent getan hat:
- Ausführungen (mit Status, Dauer, Tokens)
- Skill-Zuweisungen/-Entfernungen
- Änderungen an der Kontext-Konfiguration
- Filter nach Zeitraum

### Bearbeitungsmodus

Klicke auf **Bearbeiten**, um zu ändern:
- Name, Beschreibung, Avatar
- System-Prompt
- Ausführungseinstellungen
- Speichern / Abbrechen

## Agent-Kontext-Manager

Steuerung pro Agent für jede Kontextquelle, die der Agent zur Laufzeit erhält.

![Agent-Kontext](/documentation/blume-assets/content/docs/img/screenshots/05-agent-detail.png)

| Quelle | Steuerung |
|--------|---------|
| **System-Prompt** | Basis-Prompt + eigener Zusatz |
| **Skills** | Jeden zugewiesenen Skill ein-/ausschalten |
| **MCP-Server** | Jeden konfigurierten Server ein-/ausschalten |
| **Wissensordner** | Lesbare Ordner auswählen (persönlich + Workspace-global + Projekt) |
| **Leitplanken** | Maximale Wissens-Chunks, eigene Regeln |

**Live-Vorschau** – Sieh vor dem Speichern genau den Kontext, der an den Agenten gesendet wird.

## Agent-Squads

Weise eine Aufgabe einem **Squad** zu – einem Team von Agenten unter einer Leitung, die an Mitglieder delegiert.

![Squads](/documentation/blume-assets/content/docs/img/screenshots/04-agents.png)

### Squad-Struktur

- **Leitung** – erhält die Aufgabe, zerlegt sie und delegiert an Mitglieder
- **Mitglieder** – führen delegierte Teilaufgaben parallel aus
- **Jede Delegation** = eine untergeordnete Ausführung (nachvollziehbar, nutzungserfasst, mit eigenem Chat/eigenen Logs)

### Squad erstellen

1. Seite **Agenten** → **Neuer Squad** (oder Squad-Details → Neuer Squad)
2. Name + Beschreibung
3. **Leitung** auswählen (muss ein Agent sein)
4. **Mitglieder** hinzufügen (Agenten)
5. Speichern

### Squad-Details

Klicke auf einen Squad, um zu sehen:
- **Organigramm** – visueller Baum Leitung→Mitglieder (SVG, Verschieben/Zoomen)
- **Übersicht** – Beschreibung, Anzeige der Leitung
- **Aktivität** – alle Ausführungen aus den Aufgaben dieses Squads

![Squad-Organigramm](/documentation/blume-assets/content/docs/img/screenshots/04-agents.png)

## Agent-Wissen & Gedächtnis

Agenten nutzen die Wissensbasis als Langzeitgedächtnis – persönliche Ordner + RAG-Lesen/-Schreiben zur Laufzeit.

### Persönliche Wissensordner

- **Agent-Details** → Tab **Gedächtnis** → Liste der persönlichen Ordner
- **Ordner erstellen** – Name + Beschreibung
- **Dokumente hochladen** – per Drag & Drop oder Dateiauswahl
- **Löschen** – Ordner samt Inhalt entfernen

Um alle Ordner des Workspace an einer Stelle zu sehen und zu verwalten, nutze die Seite **Wissen** – siehe [Wissen](/documentation/de/knowledge).

### Zur Laufzeit

Der MCP-Server `agent-memory` stellt bereit:
- `memory_search` – semantische Suche über lesbare Ordner
- `memory_remember` – Inhalt im persönlichen Ordner speichern
- `memory_list_folders` / `memory_create_folder`

**Lesezugriff** = persönliche + Workspace-globale + Projektordner
**Schreibzugriff** = nur persönliche Ordner

## Agent kopieren & exportieren

### Zwischen Workspaces kopieren

**Nur System-Administrator** – Kopiere einen Agenten (mit Skills, Konfiguration, Squad-Mitgliedschaften) in einen anderen Workspace.

1. Agent-Details → Schaltfläche **Kopieren**
2. Ziel-Workspace auswählen
3. `ApplyReport` prüfen (erstellte vs. wiederverwendete Skills, nicht aufgelöste Runtime, Warnungen)
4. Bestätigen – der Agent landet **deaktiviert** im Ziel-Workspace

### Gesamtes Team exportieren

**Workspace-Administrator** – Exportiere alle Agenten als ein einziges `.ao`-Artefakt:

1. Seite Agenten → **Alle exportieren**
2. Lädt die `.ao`-Datei herunter (optional verschlüsselt mit `?encrypt=true`)
3. Auf einer anderen AO-Instanz importieren → Schaltfläche **Importieren**

Nicht enthalten: Agent-Secrets, Inhalte von Wissensordnern, Squad-Mitgliedschaften (nur Referenzen).

## Agent Creator

Agenten mit der **Admin-Berechtigung** (`include_agent_admin`) können *während ihrer eigenen Ausführungen* über den AO-MCP-Server Agenten und Squads erstellen/konfigurieren.

### Aktivieren

Agent-Details → Tab „Kontext“ → Kontrollkästchen **Agent-Administration** (standardmäßig aus, unabhängig von „AO-Tools einbinden“)

### Fähigkeiten (innerhalb einer Ausführung)

- `ao_create_agent` – erstellen + Runtime binden + optional Squad-/Skill-Zuweisung
- `ao_update_agent` – Agent-Konfiguration ändern
- `ao_create_squad` – Squad mit Leitung/Mitgliedern erstellen
- `ao_add_squad_member` – Mitglied zu einem Squad hinzufügen
- `ao_list_squads` – Squads im Workspace auflisten

**Leitplanken:**
- Nur erstellen/aktualisieren (kein Löschen/Entfernen/Zuweisung aufheben)
- Nur im Daemon-Modus (nicht in der eigenständigen CLI verfügbar)
- Keine Selbstvervielfältigung (erstellte Agenten haben beide Berechtigungen aus)
- Alle Änderungen im Audit-Log von Menschen nachprüfbar

## Letzte Updates

- **Agent-Kontext-Manager** – Steuerung pro Agent für Skills, MCP-Server, Wissensordner und Leitplanken mit Live-Vorschau
- **Agent-Squads** – teambasierte Delegationen mit Leitung und Mitgliedern, jede Delegation eine nachverfolgte untergeordnete Ausführung
- **Agent-Wissen/-Gedächtnis** – persönliche Wissensordner mit Lesen/Schreiben zur Laufzeit per RAG
- **Agent kopieren & exportieren** – Agenten zwischen Workspaces kopieren, gesamtes Team als .ao-Artefakt exportieren
- **Agent Creator** – Agenten mit Admin-Berechtigung können während Ausführungen Agenten und Squads erstellen/konfigurieren