Zum Hauptinhalt springen

Agentenmodus

TL;DR

Jeder Bot wird in einem von zwei Modi erstellt - Agentenmodus oder Flow-basiert. Der Agentenmodus ist der empfohlene, KI-gesteuerte Ansatz: Sie beschreiben, was der Bot tun soll, und ein intelligenter Orchestrator übernimmt das Gespräch, ruft bei Bedarf Tools und Wissen auf. Flow-basiert ist der klassische manuelle Flow-Builder. Der Modus wird bei der Erstellung des Bots gewählt und kann danach nicht mehr geändert werden.

Der Modus eines Bots bestimmt, wie er aufgebaut ist und wie er Gespräche führt. Er wird einmalig im Bot-Erstellungsassistenten ausgewählt und bleibt für die Lebensdauer des Bots festgelegt.

  • Agentenmodus - ein autonomer KI-Assistent. Sie geben dem Bot eine Persona, einen Orchestrator-Prompt und eine Reihe von Tools; der Orchestrator entscheidet dann, was bei jedem Zug zu tun ist. Am besten für die meisten neuen Bots geeignet.
  • Flow-basiert - ein manuell erstellter Flow-Bot. Sie entwerfen jeden Schritt selbst im Flow-Editor. Siehe Flows.

Die beiden Modi schließen sich gegenseitig aus und können nicht ineinander umgewandelt werden. Ein aus einem Modus exportierter Bot kann nur in einen Bot desselben Modus importiert werden.

Verfügbarkeit

Der Agentenmodus ist möglicherweise nicht in Ihrer Installation aktiviert. Wenn er deaktiviert ist, bietet der Bot-Erstellungsassistent keine Moduswahl an und jeder neue Bot wird als Flow-basiert erstellt. Bestehende Bots im Agentenmodus bleiben voll funktionsfähig. Wenden Sie sich an Ihren Systemadministrator, wenn Sie den Agentenmodus aktivieren müssen.

Beta

Der Agentenmodus befindet sich derzeit in der Beta-Phase und wird noch nicht für den Produktionseinsatz empfohlen.

Agentenmodus vs Flow-basiert​

AgentenmodusFlow-basiert
AnsatzKI-Orchestrator entscheidet bei jedem ZugSie erstellen jeden Schritt in Flows
EinrichtungBeschreiben Sie den Bot, Persona, Prompt und Tools werden generiertErstellen Sie Flows Knoten für Knoten
Am besten geeignet fürSupport-Assistenten, offene GesprächeStarre, vollständig deterministische Prozesse

Wie ein einzelner Gesprächszug in jedem Modus tatsächlich abläuft - und wo der Orchestrator darin sitzt - siehe Wie der Agentenmodus funktioniert.

Der Agentenmodus ist eine neue Möglichkeit, den Inhalt eines Bots zu organisieren: Arbeit, die zuvor von Hand geschrieben werden musste - über Skripte, Flows und Knoten hinweg - wird stattdessen als Persona, Orchestrator-Prompt und eine Reihe von Tools ausgedrückt. Siehe Erste Schritte, um zu erfahren, wo der Modus bei der Bot-Erstellung gewählt wird.

Aufbau mit dem KI-Assistenten​

Sie können die Persona und den Orchestrator-Prompt von Hand bearbeiten - diese Felder werden automatisch gespeichert, während Sie tippen - aber Bots im Agentenmodus können auch mit dem integrierten KI-Assistenten erstellt und verfeinert werden. Sie beschreiben, was Sie in einfacher Sprache möchten, und der Assistent schlägt konkrete Änderungen am Bot vor: Persona-Überarbeitungen, Änderungen am Orchestrator-Prompt, neue oder geänderte Tools und Weiterleitungsziele. Nichts wird live geschaltet, bis Sie es überprüft haben.

Vorschläge werden in zwei Stufen angewendet:

  1. Akzeptieren - jeder Vorschlag erscheint als Karte mit der Begründung des Assistenten und einem optionalen Änderungen anzeigen-Diff (vorher/nachher). Klicken Sie auf Akzeptieren, um einen Vorschlag zu stagen; klicken Sie erneut, um ihn rückgängig zu machen. Das Akzeptieren eines Vorschlags, der von einem anderen abhängt, akzeptiert automatisch seine Abhängigkeiten. Vorschläge sind in Abschnitte gruppiert (Persona-Änderungen, Agenten-Prompt, Neue Tools, Weiterleitungsziele), die jeweils anzeigen, wie viele ausstehend oder akzeptiert sind.
  1. Anwenden - sobald mindestens ein Vorschlag akzeptiert wurde, klicken Sie auf Vorschläge anwenden, um sie zu übernehmen. Nur akzeptierte Vorschläge werden in den Bot geschrieben; ausstehende werden verworfen. Wenn Sie den Dialog schließen, während Vorschläge noch ausstehen, werden Sie gebeten, dies zu bestätigen, bevor sie verworfen werden.
Akzeptieren bedeutet nur, eine Änderung zu stagen

Das Akzeptieren eines Vorschlags ändert den Bot nicht - es markiert nur den Vorschlag zur Aufnahme. Der Bot wird nur aktualisiert, wenn Sie auf Vorschläge anwenden drücken.

Sobald angewendet, erscheinen die akzeptierten Änderungen auf den Registerkarten Persona & Prompt und Tools, und der Autosave-Indikator zeigt an, wann der Bot zuletzt gespeichert wurde.

Jedes Mal, wenn Sie Änderungen des KI-Assistenten anwenden, wird automatisch ein Checkpoint erfasst, sodass Sie zurückrollen können (siehe Rollback-Verlauf).

Konfiguration eines Bots im Agentenmodus​

Agenten-Bots werden auf der Agentic-Seite konfiguriert, nicht in einem Flow-Editor. Sie ist in Registerkarten organisiert:

  • Persona & Prompt - die Persönlichkeit des Bots und der Orchestrator-System-Prompt, der sein Verhalten steuert. Siehe die Persona- und Orchestrator-Prompt-Konfiguration für die hier gespeicherten Werte (botPersona, orchestratorPrompt).
  • Tools - die Tools, die der Orchestrator aufrufen kann (zum Beispiel Nachschlagen, Aktionen oder benutzerdefinierte Funktionen). So macht ein Bot im Agentenmodus Dinge.
  • Telefon und Chat - kanalspezifisches Gesprächsverhalten für die Sprach- und Chat-Kanäle. Diese Registerkarten wurden für die einfachere tägliche Nutzung hinzugefügt: Sie zeigen die wichtigsten Kanaleinstellungen direkt in der Agentic-Ansicht an, sodass Sie die wesentlichen Einstellungen anpassen können, ohne sie zu verlassen. Sie sind eine kuratierte Untermenge - die vollständige Kanalkonfiguration bleibt Superbenutzern über den Abschnitt Kanäle im Navigationsmenü oder über den Link Erweiterte Einstellungen innerhalb der Registerkarte zugänglich. Nur für Benutzer mit der Rolle Channel Manager sichtbar.
  • Extraktionsfeldliste - die strukturierten Felder, die der Orchestrator aus Benutzereingaben extrahiert.
  • Flows - die ereignisgesteuerten Subflows des Bots (Fehler-Flow, Telefonkonversationsstart, Telefonanruf beendet, Chat-Konversationsende). Flows sind niemals Teil des Toolsets des Orchestrators und können niemals vom Agenten aufgerufen werden. Siehe Flows.

Die Registerkarte Tools listet Standardtools (wie Anruf weiterleiten, Websuche und Live-Chat-Übergabe) auf, die Sie ein- oder ausschalten, und benutzerdefinierte Tools, die Sie mit Tool-Aufruf erstellen erstellen. Jedes Tool zeigt einen Aktiv- oder Inaktiv-Status an.

Wissen und Abruf (RAG) funktionieren genauso wie bei jedem Bot; Anbieter werden auf der Seite Aktivierte Anbieter des Bots aktiviert und in der Anbieterverwaltung erstellt.

Tools​

Tools sind das, was einem Bot im Agentenmodus ermöglicht, Dinge zu tun, anstatt nur zu sprechen - der Orchestrator entscheidet, Zug um Zug, ob ein Tool benötigt wird und ruft es mit Werten auf, die aus dem Gespräch gesammelt wurden. Tools können von Hand hinzugefügt oder vom KI-Assistenten vorgeschlagen werden; in beiden Fällen enden sie als dieselbe Tool-Konfiguration auf dem Bot.

Es gibt zwei Kategorien:

Standardtools​

Eingebaute Tools, die auf jedem Bot existieren und einfach eingeschaltet und konfiguriert werden, nicht von Grund auf neu erstellt:

  • Anruf weiterleiten - leitet einen eingehenden Telefonanruf an eines der konfigurierten Weiterleitungsziele weiter. Eine Nummer, die nur zur Laufzeit bekannt ist, wird von einem Skript mit force_forward_call() übergeben - siehe Tool-Chaining. Nur Sprachkanal.
  • Websuche - ermöglicht es dem Bot, während eines Gesprächs im Internet nach aktuellen Informationen zu suchen. Erfordert einen konfigurierten Websuchanbieter.
  • Live-Chat-Übergabe - übergibt einen eingehenden Chat an einen Menschen im Live-Chat, optional mit Ziel auf eine bestimmte Live-Chat-Gruppe. Erfordert, dass die Live-Verbindung des Website-Chats aktiviert ist.
  • Auflegen - beendet den aktiven Telefonanruf, sobald die Anfrage des Anrufers gelöst ist. Sie konfigurieren einen Tool Call, der beschreibt, wann der Bot auflegen darf, und die Abschiedsnachricht, die er spricht, bevor die Leitung unterbrochen wird. Der Abschied funktioniert in einem von zwei Modi: generiert, wobei Ihr Text eine Anleitung ist, die der Bot in einen eigenen Satz in der Sprache des Anrufers umwandelt, oder fest, wobei Ihr Satz Wort für Wort gesprochen wird - auch für Anrufer, die eine andere Sprache sprechen. Nur Sprachkanal.

Benutzerdefinierte Tools​

Benutzerdefinierte Tools werden für einen bestimmten Bot erstellt und kommen in drei Arten:

  • Skript - führt benutzerdefinierte Logik (ein Python-Skript) mit Werten aus, die vom Benutzer erfasst wurden, und gibt ein Ergebnis zurück, das der Orchestrator in seiner Antwort verwenden kann. Kann mit einem festen Beispielergebnis getestet werden, bevor die echte Logik angeschlossen wird.
  • HTTP - ruft eine externe API oder einen Webhook auf und übergibt erfasste Werte in der Anfrage. Verwenden Sie dies, um sich mit Systemen außerhalb der Plattform zu integrieren (zum Beispiel eine Bestellung nachschlagen oder ein Ticket erstellen).
  • Wissenssuche - ermöglicht es dem Bot, bei Bedarf in seiner eigenen Wissensdatenbank zu suchen, auf bestimmte Tags oder Metadaten beschränkt, anstatt sich nur auf den automatischen Abruf zu verlassen.

Jedes benutzerdefinierte Tool hat einen Namen und eine Beschreibung, die dem Orchestrator sagen, was das Tool tut und wann es aufgerufen werden soll - diese sind für die KI geschrieben, nicht für den Endbenutzer, daher sollten sie präzise über Absicht und Auslösebedingungen sein.

Skript- und HTTP-Tools definieren auch Extraktionsfelder: die Informationen, die der Orchestrator vom Benutzer sammeln muss, bevor er das Tool aufrufen kann (zum Beispiel eine Bestellnummer oder eine E-Mail-Adresse). Jedes Feld kann als erforderlich oder optional markiert werden. Dies ist der Mechanismus, der freie Gespräche mit strukturierten Daten verbindet, auf die das Tool zugreifen kann - dieselben Extraktionsfelder erscheinen auch in der Extraktionsfeldliste des Bots und können über Tools und Flows hinweg wiederverwendet werden.

Ein Tool kann auch entscheiden, welches Tool als nächstes ausgeführt wird, ohne eine weitere Entscheidung des Orchestrators - siehe Tool-Chaining.

Rollback-Verlauf​

Die Agentic-Seite führt einen Rollback-Verlauf: eine Liste automatischer Checkpoints der Bot-Konfiguration. Ein Checkpoint wird jedes Mal erfasst, wenn Sie Änderungen des KI-Assistenten anwenden, sodass Sie immer zu dem Zustand zurückkehren können, in dem sich der Bot vor einer Änderung befand.

  • Öffnen Sie das Dropdown-Menü Rollback-Verlauf (Uhr-Symbol) in der Kopfzeile der Registerkarte Persona & Prompt. Jeder Eintrag zeigt seinen Kommentar (abgeleitet von der Änderung) und das Datum und die Uhrzeit, zu der er erfasst wurde.
  • Klicken Sie auf die Schaltfläche Wiederherstellen neben einem Eintrag, um den Bot auf diesen Punkt zurückzusetzen. Sie werden zuerst um Bestätigung gebeten.
  • Vor der Wiederherstellung wird der aktuelle Zustand als neuer Checkpoint erfasst, sodass ein Rollback selbst rückgängig gemacht werden kann.
  • Der Verlauf speichert die 10 neuesten Checkpoints; ältere werden automatisch gelöscht.
  • Ihre Wissensdatenbank (RAG)-Dateien sind nicht von einem Rollback betroffen.

Für manuelle, vollständige Bot-Snapshots, die Sie selbst erstellen und verwalten (einschließlich Skripte, Flows und Wissen), siehe Versionen.

Flows​

Bots im Agentenmodus werden vom Orchestrator gesteuert. Flows sind weiterhin verfügbar, jedoch nur als ereignisgesteuerte Subflows: kein Flow ist jemals sichtbar oder vom Orchestrator aufrufbar, und Flows werden nur durch Ereignisse betreten.

Verfügbare Ereignisse:

  • Fehler-Flow - wird ausgeführt, wenn der Bot auf einen Fehler stößt. Für jeden Bot verfügbar.
  • Konversationsstart - für Telefon-Bots, wenn ein Anruf beginnt.
  • Anruf beendet - für Telefon-Bots, nachdem der Anruf beendet wurde, für die Nachbearbeitung. Unterscheidet sich vom Auflegen-Tool, das den Anruf beendet; Anruf beendet läuft danach.
  • Chat-Konversationsende - wenn eine Chat-Konversation endet.

Formular, Weiterleitung und Story-Übergang-Knoten sind im Agentenmodus nicht verfügbar: Der Orchestrator übernimmt die Datenerfassung und Anrufweiterleitung, und Subflows dürfen nicht in andere Flows übergehen.

Nichts hier steht hinter einem pro-Bot-Umschalter - es gilt für jeden Bot im Agentenmodus. Zwei verwandte Funktionen sind instanzweit und werden von Ihrem Systemadministrator konfiguriert:

  • Benutzerdefinierte Subflows - Subflows, die nicht an ein Ereignis gebunden sind und extern über die API ausgelöst werden. Standardmäßig deaktiviert; Aktivierung erfordert einen dokumentierten Grund. Siehe Flows.
  • Benutzerdefinierter Orchestrator-Agent - ersetzt den eingebauten Orchestrator durch Ihr eigenes Python-Skript. Standardmäßig deaktiviert. Die Form-, Antwort- und RAG-Agenten-Skripte sind zusammen mit ihm verborgen, da Bots im Agentenmodus keine Oberfläche haben, an die sie angehängt werden können.

Vom Orchestrator aufgerufene vollständige Flows sind nicht verfügbar. Wenn ein Bot sie zuvor verwendet hat, existieren diese Flows weiterhin und sind jetzt Subflows; sie können durch ein Ereignis oder, wo die Funktion aktiviert ist, durch einen externen Auslöser erreicht werden.

Verwandte Dokumentation​