Erstellen und Konfigurieren der KI-Agenten

Weitere Informationen finden Sie in den Abschnitten Einrichten eines geskripteten KI-Agenten und Einrichten autonomer KI-Agenten im Administrationshandbuch Webex AI Agent Studio.

Konfigurieren von KI-Agenten im Flow

Sie können einen KI-Agentenknoten verwenden, um bestimmte Abfragen aus einem Korpus oder einer Wissensdatenbank zu beantworten. Sie können auch Multiturn-Konversationen aktivieren. Der KI-Agent kann Folgefragen stellen, den Kontext verstehen und personalisierte Antworten geben.

Ziehen Sie den AI Agent-Knoten einfach per Drag & Drop auf Ihren Visual Flow Builder, um loszulegen. Dieser Knoten unterstützt Sie bei der Verwendung von skriptbasierten und autonomen KI-Agenten, die im Webex AI Agent Studio konfiguriert sind.

Konfigurieren von Eingabe- und Ausgabevariablen im KI-Agentenknoten

Der KI-Agent-Knoten enthält zwei Methoden:

• Prozessnachricht: Ermöglicht es Ihnen, Benutzernachrichten an den ausgewählten Agenten zu senden und Agentenantworten zurückzuerhalten.

• Sitzung schließen: Ermöglicht das Schließen einer Sitzung im KI-Agenten. In bestimmten Szenarien kann es erforderlich sein, eine vorhandene KI-Agentensitzung zu schließen und eine neue zu initiieren. Dies kann mit einer bestimmten Methode innerhalb des KI-Agent-Knotens erreicht werden. Wenn eine Sitzung beispielsweise für einen bestimmten Zeitraum inaktiv bleibt, wird die Sitzung automatisch geschlossen, um die Ressourcen zu optimieren.

1. Konfigurieren Sie in der Process Message-Methode die folgenden Eingabevariablen:

   • Agententyp: Der Typ des Agenten, der im Flow verwendet wird, z. B. skriptbasiert oder autonom.

   • Agent: Der Agent, der die Benutzernachricht verarbeitet und eine Antwort erhält.

     Sie können die KI-Agenten, auf die Sie Zugriff haben, im Webex AI Agent Studio sehen. Weitere Informationen zum Verwalten von Benutzern und Agenten in Webex AI Agent Studio finden Sie unter Benutzerrollen.

   • Nachricht: Der Variablenname mit der eingehenden Kundennachricht, die an den ausgewählten KI-Agenten gesendet wird

   • Sprache: Wenn der ausgewählte KI-Agent mehrsprachig ist, können Sie die Sprache der eingehenden Nachricht in der Dropdown-Liste Sprache auswählen. Wir füllen die Dropdown-Liste basierend auf den Sprachen in den KI-Agenteneinstellungen.

     Hinweis: Diese Dropdown-Liste ist für Agenten mit einer einzigen Sprache deaktiviert.

   • Kanal: Der Name des Kanals, von dem das System die Nachricht des Kunden empfängt.

   • Benutzerkennung: Geben Sie die eindeutige Kennung des Benutzers für den ausgewählten Kanal an.

   • Benutzerdefinierte Parameter (optional): Sie können zusätzliche Informationen über den Kunden als Schlüssel-Wert-Paar an Webex AI Agent Studio übergeben. Wir verknüpfen diese Informationen mit dem Profil des Benutzers und verwenden sie für spätere Konversationen. Sie können z. B. angeben, ob ein Benutzer ein Neukunde oder ein Bestandskunde ist.

     Auf Schlüssel, die als benutzerdefinierte Parameter übergeben werden, kann in Agentenantworten als ${consumerData.extra_params.<your_key>} zugegriffen werden.

     Derzeit werden benutzerdefinierte Parameter nur für geskriptete KI-Agenten über digitale Kanäle unterstützt.

   • Nachrichtenparameter (optional): Sie können zusätzliche Informationen über den aktuellen Austausch als Schlüssel-Wert-Paar an Webex AI Agent Studio übergeben.

     Diese Nachricht wird nicht gespeichert und sie steht nur für die Verwendung in der nächsten Agentenantwort zur Verfügung. Auf Schlüssel, die als Nachrichtenparameter übergeben werden, kann in Agentenantworten als ${extra_params.<your_key>} zugegriffen werden.

2. Konfigurieren Sie die folgenden Ausgabevariablen in der Process Message-Methode:

   • TextResponse: Die Textausgabe, die innerhalb des KI-Agenten konfiguriert ist; funktioniert nur, wenn keine andere Art von Rich- oder Spezialelementen vorhanden ist. Außerdem wird bei mehreren Textelementen in der Antwort das erste Textelement zurückgegeben.

   • FullResponse: Die vollständige Antwort mit allen umfangreichen Elementen und mehreren Nachrichten, die in der Ausgabe des Agenten vorhanden sind.

   • Datenspeicher: Ein JSON/DICT aller benutzerdefinierten Sitzungsvariablen innerhalb des Agenten

   • TransactionId: Die Transaktions-ID für die Anforderung in Webex AI Agent Studio

   • Sitzungs-ID: Die Sitzungs-/Konversations-ID in Webex AI Agent Studio

   • ConsumerId: Die Kunden-ID in Webex AI Agent Studio

   • MessageMetadata: Die Metadaten, die der aktuellen Antwort des konfigurierten Agenten zugeordnet sind

   • Sitzungsmetadaten: Die Metadaten, die der Sitzung für die aktuelle Antwort des konfigurierten Agenten zugewiesen sind

     Derzeit werden MessageMetadata und SessionMetadata nur für geskriptete KI-Agenten über digitale Kanäle unterstützt.

   • ResponsePayload: Die vollständige Antwortnutzlast von Webex AI Agent Studio

3. Konfigurieren Sie die folgenden Eingabevariablen in der Close Session-Methode:

   • Agent: Der Agent, der die Benutzernachricht verarbeitet und eine Antwort erhält.

     Sie können die KI-Agenten, auf die Sie Zugriff haben, im Webex AI Agent Studio sehen. Weitere Informationen zum Verwalten von Benutzern und Agenten in Webex AI Agent Studio finden Sie unter Benutzerrollen.

   • Sitzungs-ID: Wir schließen die KI-Agentensitzung. Die Sitzungs-ID steht als Ausgabevariable der Process-Nachrichtenmethode zur Verfügung.

Knotenergebnisse

Die Liste der möglichen Knotenergebnisse für diesen Knoten wird angezeigt. Sie können die Knotenbeschriftungen mit dem Symbol Bearbeiten (Bleistift) anpassen. Der Knoten verlässt den Knoten durch einen der Knotenkanten, die dem Ergebnis des Knotens entsprechen. Jeder AI Agent-Knoten entspricht einem Knotenergebnis. Hier ist eine Liste der Knotenergebnisse.

• Fehler (rot): zeigt Folgendes an:

  • onError: wenn der Agent nicht mit einer Nachricht geantwortet hat.

  • onInvalidCustomerID:, wenn eine Kunden-ID fehlt.

  • onInvalidMessage: wenn der Nachrichtenwert fehlt.

• Erfolg (grün): zeigt Folgendes an:

  • onSuccess: Wenn der Agent mit einer Nachricht antwortet.

  • onAgentHandover: Wenn der Agent eine Übergabeanforderung an die Agenten sendet.

• Zeitüberschreitung (gelb/gelb): gibt Folgendes an:

  • onTimeOut: Wenn der Agent nicht länger als 15 Sekunden nicht geantwortet hat.