Agenten

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

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.

Agentenliste

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

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:

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“

• 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.

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.

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

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.

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