Zum Hauptinhalt springen

Assistenten erstellen und verwalten

Der Assistent „Bot Father” unterstützt dich dabei, neue Assistenten anzulegen und bestehende Assistenten zu verwalten, ohne dass du dich durch alle Einstellungsdialoge klicken musst.

Voraussetzungen & Rechte​

  • Du brauchst Manage-Rechte für den jeweiligen Assistenten bzw. Space. Ohne diese Rechte kann Bot Father den Assistenten nicht laden oder ändern.
  • Bei Konfigurations-Updates arbeitet Bot Father mit optimistic locking: Es wird ein aktueller Zeitstempel der Assistenten-Konfiguration benötigt (von Bot Father beim Laden ermittelt).
hinweis

Ein öffentlicher Assistent ist nicht automatisch mit einem Assistant Access Link oder einem Widget gleichzusetzen. Diese Freigabewege richtest du je nach Einsatzfall zusätzlich in der Oberfläche ein.

Was Bot Father kann​

Bot Father kann, abhängig von deinen Rechten, unter anderem:

  • Assistenten auflisten (z. B. nach Name/Substring)
  • Assistenten-Konfiguration auslesen (inkl. System-Prompt, aktivierte Tools/Integrationen, Modell, MCP-Server)
  • Neue Assistenten erstellen
    • mit Name (Pflicht)
    • optional mit Beschreibung und System-Nachricht
    • du wirst dabei als Admin hinzugefügt
  • Assistenten aktualisieren
    • Profil: Name, Beschreibung, Sichtbarkeit (public)
    • Konfiguration: Prompt/Tools/Modell/MCP-Server (mit latestTimestamp)
  • MCP-Server suchen & aktivieren (aus Registry/Katalog), um dem Assistenten zusätzliche Tools zu geben
  • Feedback zu einem Assistenten verwalten (Liste, Details, Status/Tags/Priorität/Notizen)
  • Wissens-/Dateisuche (RAG) im Workspace nutzen, um vorhandene Inhalte wiederzufinden
  • Nachrichten an Assistenten/Spaces senden (Konversation starten/fortsetzen)

Neuen Assistenten mit Bot Father erstellen (Schritt für Schritt)​

1) Eckdaten festlegen​

Gib Bot Father mindestens:

  • Name des Assistenten (Pflicht)
  • Zweck (z. B. Support, Sales, Compliance)

Optional zusätzlich:

  • Beschreibung (1-2 Sätze)
  • System Message (System-Prompt / Instruktionen)
  • gewünschte Integrationen/Tools (z. B. MCP-Server)

2) Assistent erstellen lassen​

Bot Father erstellt den Assistenten mit diesen Feldern:

  • name (Pflicht)
  • description (optional)
  • systemMessage (optional)
  • chunking (optional; nur nutzen, wenn ihr Chunking bewusst konfiguriert)

3) (Optional) Integrationen/MCP-Server aktivieren​

Wenn der Assistent zusätzliche Fähigkeiten braucht, kann Bot Father passende MCP-Server aus der Registry suchen und aktivieren. Die Einrichtung der Integrationen wurde vereinfacht, sodass du zusätzliche Funktionen schneller in einen Assistenten übernehmen kannst.

3a) Optional: Lokalen Assistenten andocken​

Wenn ein Assistent Chats und zugewiesene Tasks nicht mit dem eingebauten Modell, sondern über einen verbundenen lokalen Prozess ausführen soll, kannst du ihn zusätzlich andocken.

Wichtig ist die Abgrenzung:

  • Andocken betrifft die Chat- und Task-Ausführung eines Assistenten.
  • Chat-Nachrichten und zugewiesene Tasks laufen dann über den verbundenen lokalen Prozess statt über das eingebaute In-CLYE-LLM.
  • Das Andocken ist nicht dasselbe wie ein ACP-Agent als MCP-Tool über acp-connector.

So gehst du vor:

  1. Öffne den gewünschten Assistenten.
  2. Gehe zu Einstellungen → Allgemein.
  3. Aktiviere Assistenten andocken.
  4. Nutze den API-Key des Bot-Spaces für die lokale Verbindung.
  5. Starte lokal clye acp.
  6. Sende dem Assistenten eine Chat-Nachricht und weise ihm zusätzlich eine Task zu, um beide Wege zu prüfen.

Für die Praxis wichtig:

  • Chat-Nachrichten und zugewiesene Tasks laufen dann über den verbundenen lokalen Prozess statt über das In-CLYE-LLM
  • es gibt dabei keinen automatischen Fallback auf das eingebaute Modell
  • wenn noch kein lokaler Assistent über clye acp verbunden ist, erscheint im Chat stattdessen ein klarer Hinweis, dass noch kein lokaler Assistent verbunden ist
  • wenn gerade keine passende lokale Session für eine Task verbunden ist, bleibt die Task zunächst pending und wird später erneut versucht
  • ACP-Agenten, die über clye acp-connector als Werkzeuge angebunden sind, sind davon getrennt

Nutze clye acp-connector weiterhin dann, wenn CLYE selbst der Assistent bleiben und lokale ACP-Agenten nur als Tool aufrufen soll.

Praktisches Vorgehen:

  1. Beschreibe kurz, welche externe Funktion du brauchst.
  2. Lass passende Integrationen oder MCP-Server vorschlagen.
  3. Aktiviere nur die Verbindungen, die für den Einsatzzweck wirklich nötig sind.
  4. Teste den Assistenten direkt mit einer typischen Aufgabe.

4) (Optional) Konfiguration nachschärfen​

Für Änderungen an der Konfiguration gilt:

  1. Assistent laden (damit Bot Father den aktuellen config.timestamp kennt)
  2. Konfiguration updaten (mit latestTimestamp)

Typische Einstellungen, die du anschließend in der UI unter Weitere Einstellungen prüfen oder anpassen kannst, sind zum Beispiel:

  • Chat-Komprimierung für lange Verläufe
  • Zusammenfassung nach Verlassen, damit ein Chat beim Schließen sofort zusammengefasst und durchsuchbar gespeichert wird
  • Erinnerungen aus Zusammenfassungen, um wichtige Informationen aus Chat-Zusammenfassungen als Erinnerungen zu übernehmen

Bestehenden Assistenten ändern, duplizieren, veröffentlichen​

Ändern​

Bot Father kann:

  • Profil ändern: Name, Beschreibung, public
  • Konfiguration ändern: Prompt, Tools, Modell, MCP-Server

Duplizieren​

Eine explizite „Duplizieren“-Funktion gibt es im Bot-Father-Toolset nicht. Workaround:

  1. Quell-Assistent laden (Config auslesen)
  2. neuen Assistenten erstellen
  3. Konfiguration vom Quell-Assistenten in den neuen übertragen (Config-Update)

Veröffentlichen (Access Link / Widget)​

Bot Father kann die Sichtbarkeit über das Profil-Flag public setzen.

Weitere Publishing-Optionen (Assistant Access Link / Widget-Einstellungen wie Embed-Code, Domain-Restriktionen, Auth, Limits) erfolgen typischerweise in der UI:

  • Assistenten → (Assistent öffnen) → Teilen/Veröffentlichen/Widget (Bezeichnung kann je nach Setup abweichen)
  • Für Webflow-/Connect-Freigaben brauchst du Schreibrechte im Space des Assistenten. Die Verbindung lässt sich nur für Assistenten starten, die tatsächlich zu diesem Space gehören.

Wenn für euren Workspace das Feature-Flag startPageWidgetVisibility aktiv ist, kannst du zusätzlich auf der Startseite eines Assistenten einzelne Ablage-Widgets ausblenden. Dazu öffnest du Assistenten → (Assistent öffnen) → Einstellungen → Allgemein → Startseiten-Widgets und deaktivierst dort zum Beispiel Dokumente, Medien oder Chats. Die Auswahl wirkt sich auf die Widget-Kacheln der Startseite und auf die Tabs innerhalb der Ablage aus. Automationen gehören nicht mehr zu diesen Startseiten-Widgets.

Prompt-Vorlagen (Beispiele)​

Beispiel A: Support-FAQ-Assistent​

Ziel: wiederkehrende Supportfragen beantworten, fehlende Infos gezielt nachfragen, sonst Ticket-Entwurf erstellen.

Beispiel für systemMessage:

  • Rolle: „Du bist CLYE Support Assistant.“
  • Antworte auf Deutsch, kurz, im Support-Ton.
  • Wenn Infos fehlen: max. 3 Rückfragen.
  • Wenn Problem nicht lösbar: erstelle einen Ticket-Entwurf mit:
    • Titel
    • Schritte zur Reproduktion
    • Erwartet/Ist
    • Logs/Umgebung
    • Priorität
  • Keine internen Policies erfinden; wenn möglich auf vorhandene Doku verweisen.

Ausgabeformat:

  1. Kurzlösung (1-4 Schritte)
  2. „Wenn das nicht hilft“ (Troubleshooting)
  3. „Für Support benötigen wir“ (Datenliste)

Beispiel B: Angebotsprüfung (Sales Ops)​

Ziel: Angebote auf Vollständigkeit/Plausibilität prüfen, Abweichungen markieren, Rückfragen formulieren.

Beispiel für systemMessage:

  • Rolle: „Du bist Sales-Ops Prüfassistent.“
  • Prüfe: Pflichtfelder, Preise/Mengen, Laufzeit, Kündigung, Zahlungsziel, Leistungsumfang, Liefer-/Onboarding, SLA, Datenschutz.
  • Ausgabe immer als:
    1. Kurzfazit (OK / Rückfragen / Risiko)
    2. Checkliste (✅/⚠️)
    3. Konkrete Rückfragen (nummeriert)
    4. Risiken & empfohlene Änderungen
  • Keine Rechtsberatung: bei juristischen Klauseln „Legal Review empfohlen”.

Kurz gesagt​

Bot Father ist dein direkter Weg, um neue Assistenten anzulegen und bestehende zu verwalten, ohne durch alle Einstellungsseiten klicken zu müssen. Beschreibe Zweck und gewünschte Fähigkeiten, und Bot Father übernimmt die Konfiguration. Für komplexere Publish-Optionen wie Widgets oder Domain-Restriktionen wechselst du anschließend in die Assistenten-Einstellungen in der UI.

Inhalt