# Agents

## Was sind Agents?

Agents sind isolierte KI-Assistenten, die Probleme durchdenken, Aufgaben ausfuehren und ueber mehrere Plattformen kommunizieren. Jeder Agent hat seinen eigenen Workspace, Session-Verlauf, Modellkonfiguration und Channel-Bindungen.

## Agent-Isolation

Jeder Agent erhaelt:

- **Workspace** -- Ein dediziertes Verzeichnis fuer Dateien, Notizen und agentenspezifische Daten
- **Sessions** -- Unabhaengige Gespraechsverlaeufe und Transkripte
- **Konfiguration** -- Modellauswahl, Tool-Berechtigungen, Ausgabenlimits
- **Identitaet** -- Eine einzigartige Persona, definiert in der `AGENTS.md`-Datei des Agenten
- **Auth-Profile** -- Pro-Agent API-Schluessel- und Authentifizierungskonfigurationen

## Agenten-Personas

Der Workspace jedes Agenten enthaelt eine `AGENTS.md`-Datei, die Persoenlichkeit, Anweisungen und Verhaltensrichtlinien definiert. Dieser persistente System-Prompt formt, wie der Agent antwortet -- Tonalitaet, Fachkompetenz, Formatierung, Tool-Nutzung und Sicherheitsrichtlinien.

## Multi-Agent-Routing

Bei Betrieb mehrerer Agenten werden eingehende Nachrichten automatisch basierend auf **Bindungen** geroutet:

- **Channel-Bindung** -- Alle Nachrichten von einer Plattform weiterleiten (z.B. alle Telegram-Nachrichten an den `personal`-Agenten)
- **Server/Workspace-Bindung** -- Einen bestimmten Discord-Server oder Slack-Workspace an einen dedizierten Agenten weiterleiten
- **Chat-Typ-Bindung** -- Private Nachrichten an einen Agenten und Gruppennachrichten an einen anderen weiterleiten
- **Kontakt/Peer-Bindung** -- Nachrichten von bestimmten Kontakten an bestimmte Agenten weiterleiten

Bindungen werden in Prioritaetsreihenfolge ausgewertet. Erster Treffer gewinnt. Nicht zugeordnete Nachrichten gehen an den Standard-Agenten.

## Sub-Agents & Delegation

Agenten koennen Sub-Agents fuer spezialisierte Aufgaben erzeugen:

- **Aufgabendelegation** -- Komplexe Aufgaben aufteilen und Teile an spezialisierte Sub-Agents delegieren
- **Isolierte Ausfuehrung** -- Sub-Agents laufen in ihrem eigenen Session-Kontext
- **Ping-Pong-Konversationen** -- Agenten koennen Hin-und-Her-Austausche (bis zu 5 Durchgaenge) zur Zusammenarbeit fuehren
- **Ergebnis-Ankuendigung** -- Sub-Agent-Ergebnisse koennen zurueck an den urspruenglichen Kanal gesendet werden

## Teams & Orchestrierung

Multi-Agent-Teams ermoeglichen koordinierte Workflows:

- **Parallele Ausfuehrung** -- Mehrere Agenten gleichzeitig an verschiedenen Aspekten einer Aufgabe arbeiten lassen
- **Sequenzielle Pipelines** -- Agenten verketten, wobei jeder auf der vorherigen Ausgabe aufbaut
- **Hybridmodus** -- Parallele und sequenzielle Ausfuehrung kombinieren
- **Aufgabenverfolgung** -- Status der Arbeit jedes Agenten ueberwachen (in Warteschlange, laufend, fertig, Fehler, abgebrochen)

## Tool-Profile

Steuern Sie, was jeder Agent tun kann:

| Profil | Verfuegbare Tools |
|---------|----------------|
| **minimal** | Nur Session-Status |
| **coding** | Datei-I/O, Ausfuehrung, Sessions, Speicher, Bilder |
| **messaging** | Nachrichtenversand, Session-Verlauf |
| **full** | Alle Tools (Standard) |

Benutzerdefinierte Allow/Deny-Listen koennen pro Agent und pro Modellanbieter festgelegt werden.

## Safe Mode

Safe Mode bietet eine Ausfuehrungs-Sandbox:

- **Master-Schalter** -- Global aktivieren oder deaktivieren
- **Pro-Agent-Steuerung** -- Fuer vertrauenswuerdige Agenten deaktivieren, fuer andere aktiviert lassen
- **Ausfuehrungs-Genehmigung** -- Sensible Operationen erfordern explizite Benutzer-Genehmigung
- **Policy-Synchronisierung** -- Einstellungen werden in Echtzeit ueber alle verbundenen Clients synchronisiert

## Agenten-Speicher

Jeder Agent hat Zugang zu einem Speichersystem:

- **MEMORY.md** -- Persistente Notizen und wichtige Informationen ueber Sessions hinweg
- **Speicherdateien** -- Zusaetzliches strukturiertes Wissen in `memory/`
- **Vektorsuche** -- Speicher mit natuerlichsprachlichen Abfragen durchsuchen

Siehe [Sessions & Speicher](sessions-memory.md) fuer Details.