Status aktualisieren
Lassen Sie Ihren Agenten dynamische Variablen während eines Gesprächs mithilfe von Ausdrücken aktualisieren.
Überblick
Mit dem Tool Status aktualisieren kann Ihr Agent während eines laufenden Gesprächs eine oder mehrere dynamische Variablen setzen. Wie andere Systemtools ändert es nur den internen Status des Gesprächs — es ruft niemals eine externe API oder eine clientseitige Funktion auf.
Verwenden Sie es, um Informationen während eines Anrufs zu erfassen, etwa um zu markieren, dass ein Gespräch eskaliert werden soll, einen vom Nutzer angegebenen Wert zu speichern oder einen aus anderen dynamischen Variablen abgeleiteten Wert zu berechnen.
Funktionen
- Mehrere Aktualisierungen pro Aufruf: Ein einzelner Tool-Aufruf kann bis zu 10 dynamische Variablen gleichzeitig zuweisen.
- Ausdrucksbasierte Werte: Jeder Wert ist das Ergebnis eines Ausdrucks, der Konstanten, vorhandene dynamische Variablen, vom LLM aus dem Gespräch extrahierte Werte und Operatoren kombinieren kann.
- LLM-Extraktion nur bei Bedarf: Das Tool fordert das LLM nur auf, Parameter für Aktualisierungen zu extrahieren, die dies erfordern. Aktualisierungen, die ausschließlich aus Konstanten und/oder vorhandenen dynamischen Variablen bestehen, fügen dem Funktionsaufruf keine Parameter hinzu.
- Sofort verfügbar: Sobald das Tool ausgeführt wird, stehen die aktualisierten dynamischen Variablen im restlichen Gespräch zur Verfügung — spätere Prompts, andere Tool-Aufrufe und Überschreibungen können ebenso wie bei jeder anderen dynamischen Variable darauf verweisen.
Funktionsweise
Jede Statusaktualisierung weist einer dynamischen Variable das Ergebnis eines Ausdrucks zu:
Ein Ausdruck ist einer der folgenden Typen. Ausdrücke können ineinander verschachtelt werden, um komplexere Logik zu erstellen:
Das folgende Statusupdate setzt beispielsweise should_escalate auf true, wenn das LLM beurteilt, dass der Nutzer frustriert ist, oder wenn eine dynamische Variable retry_count bereits größer als 3 ist:
Wenn eine Statusaktualisierung nicht ausgewertet werden kann — beispielsweise bei einer Division durch null — gibt der Tool-Aufruf einen Fehler zurück und keine der Aktualisierungen in diesem Aufruf wird angewendet.
Konfiguration
Schritt 1: Tool hinzufügen
Navigieren Sie zur Konfigurationsseite Ihres Agents. Klicken Sie im Bereich Tools auf Tool hinzufügen und wählen Sie Status aktualisieren.
Schritt 2: Statusaktualisierungen definieren
Geben Sie für jede Statusaktualisierung Folgendes an:
- Variablenname: Die dynamische Variable, die zugewiesen werden soll.
- Ausdruck: Der zuzuweisende Wert, der aus den oben beschriebenen Wert- und Operatortypen besteht. Werte können verschachtelt werden, um komplexere Ausdrücke zu erstellen.
Sie können bis zu 10 Statusaktualisierungen für ein einzelnes Tool definieren.
Anwendungsfälle
- Eskalationsmarkierungen: Setzen Sie eine dynamische Variable (etwa
should_escalate), die ein nachgelagertes System oder eine Geschäftsregel prüft, wie im Integrationsleitfaden für Genesys gezeigt. - Extrahierte Informationen erfassen: Speichern Sie einen vom Nutzer angegebenen Wert (eine Bestellnummer, eine Präferenz, eine ausgewählte Abteilung) als dynamische Variable, um ihn später im Gespräch zu verwenden.
- Abgeleitete Werte: Berechnen Sie einen Wert aus anderen dynamischen Variablen, etwa indem Sie einen Zähler erhöhen oder zwei Variablen zu einer kombinieren.
Zweck: Ermöglicht dem Agenten, eine oder mehrere dynamische Variablen anhand der Konversation zu aktualisieren, ohne eine externe API aufzurufen.
Auslösebedingungen: Das LLM sollte dieses Tool aufrufen, wenn:
- Die Konversation Informationen liefert, die gespeichert werden sollten, z. B. ein Eskalationsflag, eine ausgewählte Option oder ein vom Nutzer angegebener Wert
- Eine konfigurierte Statusaktualisierung von einem Wert abhängt, den das LLM aus der Konversation bewerten oder extrahieren muss
Parameter:
Die Parameter der Funktion hängen davon ab, wie das Tool konfiguriert ist. Jede konfigurierte Statusaktualisierung, die einen vom LLM extrahierten Wert verwendet, fügt dem Schema eine Eigenschaft hinzu. Sie wird nach der dynamischen Variablen dieser Aktualisierung benannt und als string, number oder boolean typisiert. Statusaktualisierungen, die nur aus Konstanten oder anderen dynamischen Variablen erstellt werden, fügen keine Parameter hinzu.
Format des Funktionsaufrufs:
Implementierung: Der Agent wertet jeden konfigurierten Ausdruck anhand der extrahierten Parameter und der aktuellen dynamischen Variablen der Konversation aus und weist die Ergebnisse den entsprechenden dynamischen Variablen zu. Es wird keine externe Anfrage gestellt.
FAQ
Führt dieses Tool externe Aufrufe aus?
Nein. Wie alle Systemtools ändert Status aktualisieren nur den internen Status des Gesprächs. Es ruft keine externe API oder clientseitige Funktion auf.
Erfordert der Aufruf dieses Tools immer, dass das LLM Parameter extrahiert?
Nein. Das Tool fordert das LLM nur auf, einen Parameter für Statusaktualisierungen zu extrahieren, deren Ausdruck einen LLM-extrahierten Wert enthält. Wenn jede konfigurierte Aktualisierung aus Konstanten und/oder vorhandenen dynamischen Variablen besteht, benötigt der Funktionsaufruf keine Parameter.
Wo kann ich die dynamischen Variablen verwenden, die dieses Tool setzt?
Überall dort, wo Sie eine dynamische Variable verwenden können: in Systemprompts, ersten Nachrichten, Tool-Parametern und Headern sowie Überschreibungen. Details finden Sie unter Dynamische Variablen.
Kann ich dieses Tool über die API konfigurieren?
Status aktualisieren kann derzeit über das Agent-Dashboard konfiguriert werden. API- und SDK-Unterstützung ist noch nicht verfügbar.