Agenten verwalten

Agenten sind die KI-Persönlichkeiten, die deinen Selu-Assistenten antreiben. Du kannst sie vom Marketplace installieren, ihre Modelle und Berechtigungen konfigurieren und sie aktuell halten.

Agenten installieren

Vom Marketplace

1. Gehe zu Agenten in der Seitenleiste

2. Klicke auf den Marketplace-Tab

3. Durchsuche verfügbare Agenten oder nutze die Filter-Buttons:

   • Alle — Alle Agenten anzeigen
   • Verfügbar — Nur nicht installierte Agenten
   • Installiert — Nur Agenten, die du hast
   • Update verfügbar — Agenten mit neueren Versionen

4. Klicke Installieren bei jedem gewünschten Agenten

Setup-Assistent

Nach der Installation benötigen die meisten Agenten eine Einrichtung:

1. Konfiguration — API-Schlüssel oder andere Einstellungen eingeben, die der Agent benötigt
2. Tool-Berechtigungen — Wähle, wie der Agent seine Tools nutzen darf:
   • Erlauben — Frei nutzen ohne nachzufragen
   • Fragen — Jedes Mal um Erlaubnis bitten
   • Blockieren — Nie erlauben
3. Modellzuweisung — Wähle, welchen LLM-Anbieter und welches Modell dieser Agent nutzt

Tipp

Du kannst Tool-Berechtigungen und Modelle später jederzeit auf der Agent-Detailseite ändern.

Agent-Verhalten

Session-Verwaltung

Agenten handhaben Unterhaltungen unterschiedlich basierend auf ihren Session-Einstellungen:

Geteilte Sessions (Standard)

Die meisten Agenten nutzen geteilte Sessions, was bedeutet:

• Mehrere Unterhaltungsthreads mit demselben Agenten teilen sich denselben Container
• Capabilities und Workspace-Daten bleiben über Threads hinweg bestehen
• Effizientere Ressourcennutzung
• Gut für zustandslose Agenten wie Wetter- oder Such-Assistenten

Per-Thread-Isolation

Einige spezialisierte Agenten nutzen Per-Thread-Isolation:

• Jeder Unterhaltungsthread bekommt seine eigenen dedizierten Container
• Workspace-Daten sind vollständig zwischen Threads isoliert
• Nutzt mehr Ressourcen, verhindert aber Interferenzen
• Essentiell für Coding-Agenten oder Workspace-Manager

Hinweis

Du kannst den Session-Modus eines Agenten auf seiner Detailseite sehen. Coding- und Workspace-Agenten nutzen typischerweise Per-Thread-Isolation, um deine Projekte getrennt zu halten.

Komplexe Aufgaben-Schritte

Jeder Agent hat ein konfigurierbares Limit für Tool-Aufruf-Schritte pro Durchgang. Das verhindert Endlos-Schleifen und ermöglicht gleichzeitig komplexe mehrstufige Workflows:

• Standardlimit: 32 Schritte pro Durchgang
• Pro-Nutzer-Kontrolle: Du kannst eigene Limits für jeden Agenten in deinem Konto setzen
• Unbegrenzte Option: Setze auf 0, um das Limit vollständig zu entfernen
• Administrative Standards: Admins können systemweite Standards setzen

Diese Einstellung ist nützlich für:

• Coding-Agenten, die viele Schritte für komplexe Aufgaben brauchen
• Such-Agenten, die mehreren Recherche-Pfaden folgen könnten
• Administrative Agenten, die Batch-Operationen durchführen

Du kannst dies auf dem Übersichts-Tab des Agenten unter “Komplexe Aufgaben-Schritte” anpassen.

Agenten aktualisieren

Hintergrund-Updates mit Fortschritt

Agent-Updates laufen jetzt nahtlos im Hintergrund mit Live-Fortschrittsverfolgung:

1. Klicke Aktualisieren neben einem Agenten mit verfügbarem Update
2. Überprüfe die Update-Informationen im Bestätigungs-Modal
3. Klicke Update bestätigen, um den Hintergrundprozess zu starten
4. Beobachte die Echtzeit-Fortschrittskarte, die oben auf der Seite erscheint
5. Der Fortschritt zeigt echten Docker-Image-Download-Fortschritt
6. Nach Abschluss siehst du entweder eine Erfolgsmeldung oder wirst zum Setup weitergeleitet, falls neue Berechtigungen benötigt werden

Der neue Update-Assistent stellt sicher, dass du nur dann durch das Setup gehst, wenn der Agent tatsächlich neue Berechtigungen oder Zugangsdaten braucht — Routine-Updates werden automatisch abgeschlossen.

Auto-Updates

Aktiviere Auto-Updates für wartungsfreie Pflege:

1. Finde den Auto-Toggle-Button neben einem installierten Agenten
2. Klicke zum Aktivieren (grün) oder Deaktivieren (grau)
3. Selu wird diese Agenten automatisch aktualisieren, wenn neuere Versionen veröffentlicht werden

Achtung

Auto-Updates können aktive Unterhaltungen unterbrechen. Aktiviere sie nur für Agenten, die du nicht häufig nutzt.

Agenten konfigurieren

Modellzuweisung

Jeder Agent kann einen anderen LLM-Anbieter und ein anderes Modell nutzen:

1. Gehe zur Agenten-Seite
2. Klicke Modell neben einem Agenten
3. Wähle einen Anbieter und ein Modell aus dem Dropdown
4. Setze die Temperatur (0.0 = fokussiert, 1.0 = kreativ)
5. Klicke Speichern

Lasse den Anbieter leer, um das globale Standardmodell zu nutzen.

Agent-Detailseiten

Klicke auf einen Agentennamen, um detaillierte Informationen in fokussierten Tabs zu sehen:

Übersichts-Tab

Der Übersichts-Tab gibt dir eine schnelle Statusübersicht mit wichtigen Metriken:

• Capabilities — Anzahl der Tools/Services, die dieser Agent nutzt
• Gespeicherte Einträge — Wie viele persistente Daten der Agent gespeichert hat
• Memory-Einträge — Langfristige kontextuelle Notizen, die der Agent gespeichert hat
• Netzwerkanfragen — Gesamte ausgehende API-Aufrufe
• Geheimnisse — Credential-Status (wie viele gesetzt vs. fehlend sind)

Du siehst auch:

• Berechtigungsübersicht — Anzahl der Erlauben/Fragen/Blockieren-Berechtigungen
• Ressourcennutzung — Speicher-, CPU- und Prozesslimits pro Capability
• Komplexe Aufgaben-Schritte — Aktuelles Tool-Loop-Iterations-Limit für diesen Agenten
• Schnelllinks — Spring direkt zu Speicher-, Memory-, Geheimnisse-, Netzwerk- oder Berechtigungs-Tabs

Speicher-Tab

Betrachte und verwalte die persistenten Daten, die dein Agent gespeichert hat:

1. Sieh alle Schlüssel-Wert-Paare, die der Agent mit store_set gespeichert hat
2. Betrachte Zeitstempel, die zeigen, wann jeder Eintrag zuletzt aktualisiert wurde
3. Lösche einzelne Einträge, die du nicht mehr brauchst
4. Admins können Daten aller Nutzer sehen; normale Nutzer sehen nur ihre eigenen

Memory-Tab

Inspiziere die Langzeitgedächtnis-Notizen des Agenten:

1. Betrachte kontextuelle Informationen, die der Agent mit memory_remember gespeichert hat
2. Sieh Tags und Quellinformationen für jeden Memory-Eintrag
3. Lösche Memories, die nicht mehr relevant sind
4. Betrachte, wann jedes Memory zuletzt aktualisiert wurde
5. Admins können Memories aller Nutzer sehen; normale Nutzer sehen nur ihre eigenen

Netzwerk-Tab

Überwache und steuere die externe Konnektivität deines Agenten mit granularen Per-Capability-Kontrollen:

Netzwerkzugriffskontrolle

Für jede Capability kannst du das Standard-Netzwerkverhalten des Agenten überschreiben:

1. Erlauben — Diese Capability darf auf das Netzwerk zugreifen (respektiert Host-Allowlists)
2. Verbieten — Blockiere allen Netzwerkzugriff für diese Capability

Deine Auswahl hier überschreibt die Standard-Netzwerkeinstellung des Agenten nur für dein Konto.

Host-Level-Kontrollen

Für Capabilities mit allowlist-basiertem Netzwerk kannst du den Zugriff auf spezifische Hosts kontrollieren:

Standard-Hosts

Diese kommen aus der Konfiguration des Agenten:

• Setze jeden Standard-Host auf Verbieten, um den Zugriff auf diesen spezifischen Service zu blockieren
• Belasse als Erlauben, um Zugriff zu gewähren, wie der Agent-Autor es beabsichtigt hat

Eigene Hosts

Füge deine eigenen Host-Regeln für zusätzliche Kontrolle hinzu:

1. Gib einen Host ein (wie pypi.org:443 oder api.example.com)
2. Klicke Hinzufügen, um eine eigene Erlauben-Regel zu erstellen
3. Wechsle zwischen Erlauben und Verbieten für jeden eigenen Host
4. Klicke Entfernen, um eigene Einträge zu löschen, die du nicht mehr brauchst

Tipp

Nutze eigene Hosts, um Zugriff auf zusätzliche Services zu gewähren, die der Agent brauchen könnte, oder um spezifische Verbieten-Regeln für Hosts zu erstellen, die du blockieren willst.

Netzwerkaktivitäts-Log

Betrachte die letzten 100 Netzwerkanfragen, um Agent-Verhalten zu überwachen:

• Zeitstempel — Wann jede Anfrage gemacht wurde
• Methode & Host — Welcher Endpunkt wurde angesprochen (GET, POST, etc.)
• Port — Welcher Port wurde genutzt (443 für HTTPS, 80 für HTTP, etc.)
• Status — Ob die Anfrage Erlaubt oder Verweigert wurde
• Capability — Welches Tool die Anfrage gemacht hat

Das hilft dir, Konnektivitätsprobleme zu debuggen und zu verstehen, welche externen Services deine Agenten nutzen.

Geheimnisse-Tab

Verwalte Zugangsdaten und API-Schlüssel, die dein Agent für externe Services braucht:

1. Jede Capability zeigt ihre deklarierten Geheimnisse mit Beschreibungen
2. Sieh, welche Geheimnisse Erforderlich vs. Optional sind
3. Prüfe, ob Geheimnisse Geteilt (systemweit) oder Persönlich (pro Nutzer) sind
4. Gib Credential-Werte direkt in die Formularfelder ein
5. Klicke Speichern, um sie sicher zu speichern (verschlüsselt mit AES-256-GCM)

Jedes Geheimnis zeigt:

• Beschreibung — Wofür das Credential ist und wo man es bekommt
• Status — Ob es aktuell gesetzt oder fehlend ist
• Zeitstempel — Wann es zuletzt aktualisiert wurde

Achtung

Für die Sicherheit sind gespeicherte Credentials in der Benutzeroberfläche immer maskiert. Du siehst •••••••• anstatt des echten Werts.

Berechtigungs-Tab

Konfiguriere Tool-Zugriffskontrollen:

• Setze globale Standards (nur Admins)
• Erstelle persönliche Überschreibungen für dein Konto
• Verwalte sowohl Capability-Tools als auch eingebaute Tools
• Sieh, welche Berechtigungen du angepasst hast

Alle Agenten haben Zugriff auf diese eingebauten Tools:

• An Agent delegieren — Aufgaben an andere Spezial-Agenten weitergeben
• Speicher Abrufen/Setzen/Löschen/Auflisten — Schlüssel-Wert-Daten persistent zwischen Unterhaltungen speichern
• Memory Merken/Vergessen/Suchen/Auflisten — Langfristige Memory-Notizen speichern und abrufen
• Erinnerung setzen — Einmalige zukünftige Aktionen planen
• Zeitplan setzen — Wiederkehrende automatisierte Aufgaben erstellen

Diese Tools folgen demselben Berechtigungssystem wie Capability-Tools.

Verwaltete Automatisierung

Einige Agenten unterstützen verwaltete Automatisierung — vorkonfigurierte Zeitpläne, die der Agent-Autor für häufige Anwendungsfälle entworfen hat.

Automatisierung aktivieren

Wenn ein Agent Automatisierung unterstützt, siehst du ein Verwaltete Automatisierung-Panel auf seinem Übersichts-Tab:

1. Klicke auf einen Agentennamen, um seine Detailseite zu öffnen
2. Suche nach dem Verwaltete Automatisierung-Bereich
3. Überprüfe die Automatisierungsanforderungen:
   • Mindestens eine aktive Pipe muss diesen Agenten als Standard nutzen
   • Alle erforderlichen Credentials für den Agenten müssen gesetzt sein
4. Klicke Automatisierung aktivieren, wenn alle Anforderungen erfüllt sind

Wie es funktioniert

Wenn du Automatisierung aktivierst:

• Selu erstellt die vordefinierten Zeitpläne des Agenten automatisch
• Alle Zeitpläne sind an diesen spezifischen Agenten gepinnt
• Die Zeitpläne laufen auf deinen aktiven Pipes zu den konfigurierten Zeiten
• Ergebnisse erscheinen als neue Unterhaltungen in deinem Chat-Interface

Automatisierung deaktivieren

Um verwaltete Automatisierung auszuschalten:

1. Gehe zur Detailseite des Agenten
2. Finde das Verwaltete Automatisierung-Panel
3. Klicke Automatisierung deaktivieren

Das schaltet alle verwalteten Zeitpläne aus, löscht sie aber nicht — du kannst später wieder aktivieren.

Hinweis

Nur Agenten, die explizit Automatisierungsunterstützung deklarieren, zeigen diese Funktion. Die meisten Agenten lassen dich stattdessen Zeitpläne manuell erstellen.

Agent-Speicher & Memory

Agenten können Informationen auf zwei Arten persistent speichern:

Speicher (Schlüssel-Wert-Daten)

Agenten nutzen eingebaute Speicher-Tools für strukturierte Daten, die Container-Neustarts überleben:

• Sync-Checkpoints — Merken sich, wo sie mit externen Services aufgehört haben
• Nutzereinstellungen — Speichern deine Einstellungen und Konfiguration
• Lesezeichen — Verfolgen wichtige URLs oder Ressourcen
• State-Management — Behalten Kontext über langfristige Aufgaben

Betrachte gespeicherte Daten auf dem Speicher-Tab einer Agent-Detailseite.

Memory (Langfristige Notizen)

Agenten können kontextuelle Memories mit BM25-Relevanz speichern und durchsuchen:

• Unterhaltungseinblicke — Wichtige Fakten aus vergangenen Diskussionen merken
• Nutzerkontext — Verstehen deiner Vorlieben über die Zeit aufbauen
• Projektgeschichte — Fortschritt bei laufenden Arbeiten verfolgen
• Lernen — Wissen aus Interaktionen ansammeln

Betrachte Memory-Einträge auf dem Memory-Tab einer Agent-Detailseite.

Tipp

Sowohl Speicher als auch Memory sind privat für jeden Agenten und jeden Nutzer. Deine Daten werden nie mit anderen Nutzern oder Agenten geteilt.

Zeitpläne und Erinnerungen

Agenten können dir helfen, automatisierte Zeitpläne und Erinnerungen zu erstellen, und diese werden jetzt intelligent behandelt, um Konsistenz zu gewährleisten:

Agent-Pinning

Wenn ein Agent einen Zeitplan oder eine Erinnerung mit den eingebauten Tools erstellt, wird dieser Zeitplan an diesen Agenten gepinnt. Das bedeutet:

• Derselbe Agent, der den Zeitplan erstellt hat, wird ihn immer ausführen
• Selbst wenn du später den Standard-Agenten deiner Pipe änderst, nutzen gepinnte Zeitpläne weiterhin ihren ursprünglichen Agenten
• Das verhindert, dass Automatisierungs-Workflows zu verschiedenen Agenten abdriften

Einmalige Erinnerungen

Wenn du einen Agenten bittest, dich an etwas zu erinnern, kann er das set_reminder-Tool nutzen:

"Erinnere mich daran, das Wetter nächsten Sonntag morgen zu prüfen"
"Setze eine Erinnerung, morgen um 15 Uhr den Zahnarzt anzurufen"

Der Agent wird:

1. Das von dir angegebene Timing parsen
2. Es in deine Zeitzone konvertieren
3. Die Erinnerung so planen, dass sie zur richtigen Zeit ausgelöst wird
4. Die Aufgabe ausführen, wenn die Zeit gekommen ist (mit demselben Agenten)

Zeitzonen-Behandlung

Agenten behandeln Zeitzonen-Konvertierung intelligent beim Erstellen von Erinnerungen:

• Zeiten, die du ohne Zeitzonen-Info angibst, werden in deiner konfigurierten Zeitzone interpretiert
• Zeiten mit expliziter Zeitzone/Offset werden genau so verwendet, wie angegeben
• Deine Zeitzone kann auf der Zeitpläne-Seite aktualisiert werden

Das bedeutet, wenn du in Berlin bist und sagst “erinnere mich um 15 Uhr morgen”, erstellt der Agent eine Erinnerung für 15 Uhr Berliner Zeit.

Wiederkehrende Zeitpläne

Für wiederholte Aufgaben können Agenten das set_schedule-Tool nutzen oder dich anleiten, den /schedule-Befehl zu verwenden:

"Prüfe meinen Kalender und das Wetter jeden Wochentag um 6:45 Uhr"
"Sende mir jeden Freitagnachmittag eine wöchentliche Zusammenfassung"

Du kannst auch den /schedule-Befehl direkt verwenden oder Zeitpläne von der Zeitpläne-Seite verwalten.

Sowohl Erinnerungen als auch Zeitpläne erscheinen auf der Zeitpläne-Seite, wo du sie verwalten kannst.

Globale Einstellungen

Standardmodell

Setze ein Fallback-Modell für alle Agenten:

1. Gehe zur Agenten-Seite
2. Finde Globales Standardmodell oben
3. Wähle einen Anbieter, ein Modell und eine Temperatur
4. Klicke Speichern

Dieses Modell wird verwendet, wenn einzelne Agenten keine spezifischen Zuweisungen haben.

Tipp

Stelle sicher, dass du mindestens einen LLM-Anbieter im Anbieter-Bereich konfiguriert hast, bevor du Modelle setzt.

Fehlerbehebung

Agent startet nicht

• Prüfe, dass alle erforderlichen Geheimnisse auf dem Geheimnisse-Tab gesetzt sind
• Verifiziere, dass der Agent das Setup erfolgreich abgeschlossen hat
• Schaue auf dem Netzwerk-Tab nach blockierten Anfragen

Update fehlgeschlagen

• Stelle sicher, dass Docker läuft und zugänglich ist
• Prüfe deine Internetverbindung
• Versuche das Update erneut — der Fortschritt wird dort fortgesetzt, wo er aufgehört hat

Tools funktionieren nicht

• Prüfe Tool-Berechtigungen auf dem Berechtigungs-Tab
• Verifiziere, dass alle erforderlichen API-Schlüssel auf dem Geheimnisse-Tab konfiguriert sind
• Suche nach “Fragen”-Berechtigungen, die möglicherweise Genehmigung brauchen

Netzwerkprobleme

• Prüfe den Netzwerk-Tab auf verweigerte Anfragen im Aktivitäts-Log
• Verifiziere, dass Netzwerkzugriff für die Capability mit Problemen auf Erlauben gesetzt ist
• Füge eigene Host-Einträge hinzu, wenn der Agent Zugriff auf Services braucht, die nicht in seiner Standard-Allowlist sind
• Prüfe, ob Standard-Hosts auf Verbieten gesetzt wurden, die der Agent tatsächlich braucht

Memory-Probleme

• Prüfe den Memory-Tab, um zu sehen, was der Agent gespeichert hat
• Verifiziere, dass der Agent Berechtigung hat, Memory-Tools zu nutzen
• Lösche alte Memories, wenn du willst, dass der Agent etwas “vergisst”
• Memory-Abruf ist automatisch — Agenten finden relevante Notizen während Unterhaltungen

Unterhaltungen interferieren miteinander

Einige Agenten (wie Coding-Assistenten) nutzen Per-Thread-Isolation, um das zu verhindern:

• Prüfe den Session-Modus des Agenten auf dem Übersichts-Tab
• Jeder Unterhaltungsthread bekommt seinen eigenen isolierten Workspace
• Wenn du Isolation für einen Agenten brauchst, der sie nicht hat, kontaktiere den Support

Speicherprobleme

• Prüfe den Speicher-Tab, um zu sehen, welche Daten der Agent gespeichert hat
• Lösche alte Einträge, wenn der Speicher korrupt erscheint
• Admins können alle Nutzerdaten betrachten, um benutzerübergreifende Probleme zu diagnostizieren

Automatisierung nicht verfügbar

• Prüfe, ob der Agent Automatisierungsunterstützung deklariert (nicht alle Agenten tun das)
• Stelle sicher, dass du mindestens eine aktive Pipe hast, die diesen Agenten als Standard nutzt
• Verifiziere, dass alle erforderlichen Credentials gesetzt sind, bevor du aktivierst

Zeitpläne werden nicht korrekt ausgeführt

• Denke daran, dass agent-erstellte Zeitpläne an den erstellenden Agenten gepinnt sind
• Prüfe die Zeitpläne-Seite, um zu sehen, welcher Agent jeden Zeitplan besitzt
• Verifiziere, dass der gepinnte Agent alle notwendigen Berechtigungen und Credentials hat
• Wenn du ändern willst, welcher Agent einen Zeitplan ausführt, lösche und erstelle ihn mit dem gewünschten Agenten neu

Erinnerungen werden nicht ausgelöst

• Prüfe die Zeitpläne-Seite, um zu sehen, ob deine Erinnerung erstellt wurde
• Verifiziere, dass deine Zeitzone auf der Zeitpläne-Seite korrekt gesetzt ist
• Stelle sicher, dass der Agent Erlauben-Berechtigung für das set_reminder-Tool hat
• Stelle sicher, dass die Erinnerungszeit für die Zukunft gesetzt wurde (vergangene Zeiten werden ignoriert)

Komplexe Aufgaben erreichen Schrittlimit

Wenn dein Agent mitten in einer Aufgabe mit einem “Tool-Loop überschritt Iterationen” Fehler stoppt:

• Prüfe die Komplexe Aufgaben-Schritte Einstellung auf dem Übersichts-Tab des Agenten
• Erhöhe das Limit, wenn du mehr Schritte für komplexe Workflows brauchst
• Setze auf 0 für unbegrenzte Schritte (mit Vorsicht verwenden)
• Erwäge, komplexe Anfragen in kleinere Teile zu unterteilen

Agent-Updates benötigen unnötiges Setup

Der neue Update-Assistent sollte nur zum Setup auffordern, wenn es wirklich benötigt wird. Wenn du wiederholt aufgefordert wirst, Dinge zu konfigurieren, die sich nicht geändert haben:

• Prüfe, dass deine globalen Tool-Richtlinien korrekt gesetzt sind (nur Admins)
• Verifiziere, dass system-scoped Credentials auf Systemebene gespeichert sind
• Versuche das Update erneut — der Assistent lernt aus bestehenden Konfigurationen