Google Dialogflow CX integrieren

Bevor Sie die Aufgaben auf dieser Seite durchführen, stellen Sie sicher, dass die Voraussetzungen für die Integration erfüllt sind.

Skript erstellen

Erforderliche Berechtigungen Skripte anzeigen, Skripte erstellen/bearbeiten

Sie müssen mindestens ein Studio-Skript erstellen, um Interaktionen an Ihren virtuellen Agenten weiterzuleiten. Folgen Sie den Richtlinien und Anforderungen für Skripte, wenn Sie einen virtuellen Agenten integrieren. Die unterstützte Aktion für virtuelle Agenten für diesen Anbieter ist VoiceBot Exchange.

Wenn Sie eine SIPGeschlossen Protokoll zur Signalisierung und Steuerung von Multimedia-Kommunikationssitzungen wie Sprach- und Videoanrufen.-Rückkanal-Verbindung mit Ihrem virtuellen Agenten verwenden, gelten für Ihr Skript andere Anforderungen.

Weitere Informationen zur Studio-Skripterstellung finden Sie in den Grundlagen der Skripterstellung und in den Abschnitten Technisches Referenzhandbuch in der Online-Hilfe.

Best Practices für benutzerdefinierte Nutzdaten

Folgen Sie bei der Integration von benutzerdefinierten Nutzdaten aus Google Dialogflow CX in CXone diesen Best Practices:

  • Dialogflow CX verwendet keine Kontexte, um Daten an Dialogflow intentsGeschlossen Die Bedeutung oder der Zweck hinter dem, was ein Kontakt sagt/tippt; was der Kontakt mitteilen oder erreichen möchte zu übergeben, wie es DialogflowES tut.
  • Sie können benutzerdefinierte Daten unter Verwendung von JSON-Schlüssel-Wert-Paaren an Dialogflow CX übergeben. Erstellen Sie in einer Snippet action in Ihrem Skript ein dynamisches customPayload-Objekt und fügen Sie ihm die Schlüssel-Wert-Paare hinzu. Beispielsweise:

    DYNAMIC customPayload
    customPayload.ani = ani
    customPayload.contactID = contactId
    customPayload.masterContactId = masterId
    customPayloadJSON = "{customPayload.asJSON()}"	
  • Konfigurieren Sie in der Exchange- oder Conversation-Aktion in Ihrem Skript die customPayload-Eigenschaft mit einer Variablen, die die asJSON()-Funktion in ihrem Wert enthält. Sie finden diese Variable im customPayload-Objekt.
  • Übergeben Sie customPayload-JSON mit der Payload-Eigenschaft von QueryParameters an den virtuellen Agenten. Lesen Sie die Google-Dokumentation zu Abfrageparametern Ein Kästchen mit einem Pfeil, der von der Mitte aus nach oben rechts weist. für Google Dialogflow CX.
  • Die über QueryParameters übergebenen Daten werden von einem Webhook in Dialogflow CX empfangen. Sie können Code in der Dialogflow CX-Konsole schreiben, um die übergebenen Daten zu verarbeiten.
  • Verschachteln Sie kein Objekt in dem customPayload-Objekt. Verschachtelte Objekte werden als buchstäbliche Zeichenfolgen gesendet.
  • Um eigene Daten von Ihrem virtuellen Dialogflow CX-Agenten an das Skript zurückzugeben, verwenden Sie das Feld Benutzerdefinierte Nutzdaten in der Dialogflow CX-Konsole. Stellen Sie sicher, dass Sie sich in der Konsole für den virtuellen Agenten befinden, den Sie mit CXone verwenden. Ordnen Sie dies Ihrem Skript zu, indem Sie die Variable customPayloadVarName (out) in der voice- oder chat-Studio-Aktion in Ihrem Skript verwenden. Damit können Sie zum Beispiel das Verhalten der nächsten Eingabeaufforderung festlegen.
  • Parameter, die mithilfe von customPayload festgelegt werden, können nur im externen Webhook verwendet werden. Wenn Sie Parameter festlegen möchten, die außerhalb des externen Webhook verwendet werden sollen, legen Sie sie in einer Snippet-Aktion mit dem session_params-Feld fest. Beispielsweise:

    {
    	"session_params":
    	{ 
    		"name": "Winnie Le Pooh"
    		"job": "Food critic"
    		"location": "Hundred Acre Wood"
    	}
    }

    Greifen Sie mit der folgenden Syntax auf die Sitzungsparameter in der Absicht des Dialogflow CX-Agenten zu:

    $session.params.name = Winnie Le Pooh

    $session.params.job = Food critic

    $session.params.location = 100 Acre Wood

    Sitzungsparameter werden nur mit virtuellen Dialogflow CX-Agenten verwendet. Verwenden Sie Kontexte, um ein ähnliches Ergebnis mit Dialogflow ES zu erzielen.

  • Hinweise zum Sprachkontext können mit der eigenen Payload im Parameter speechContexts weitergegeben werden. Der Wert von speechContexts.phrases muss ein Google Klassen-Token Ein Kästchen mit einem Pfeil, der von der Mitte aus nach oben rechts weist. für den Hinweis sein, den Sie geben möchten. Das Token muss der Sprache und dem Gebietsschema Ihrer Kontakte entsprechen. Beispielsweise:

    DYNAMIC customPayload
    customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
    customPayload.speechContexts.boost=10		
  • Bei Verwendung von VOICEBOT EXCHANGEUm festzulegen, wie lange der virtuelle Agent wartet, wenn der Kontakt beim Sprechen eine Pause macht, fügen Sie der Next Prompt Behaviors- oder Default Next Prompt Behaviors Snippet-Aktion den maxPostEnergySilenceMS Parameter hinzu.

Eine App zu Hub für virtuelle Agenten hinzufügen

Erforderliche Berechtigungen Skripte anzeigen, Skripte erstellen/bearbeiten

Indem Sie eine Konfigurations-App zu Hub für virtuelle Agenten hinzufügen, wird die Verbindung zwischen CXone und dem Anbieter Ihres virtuellen Agenten hergestellt.

Wenn Sie eine SIPGeschlossen Protokoll zur Signalisierung und Steuerung von Multimedia-Kommunikationssitzungen wie Sprach- und Videoanrufen.-Rückkanal-Verbindung mit Ihrem virtuellen Agenten verwenden, folgen Sie den Schritten zur Einrichtung dieses Verbindungstyps.

  1. Öffnen oder erstellen Sie in Studio ein Skript und fügen Sie eine Aktion für den virtuellen Agenten hinzu, falls es nicht bereits eine enthält.
  2. Doppelklicken Sie auf die Aktion des virtuellen Agenten, um Hub für virtuelle Agenten zu öffnen.
  3. Klicken Sie auf Bot hinzufügen.
  4. Geben Sie einen Namen des virtuellen Agenten (Bot) ein und klicken Sie in der Liste der Anbieter virtuellen Agenten auf Google Dialogflow CX .

  5. Klicken Sie auf Weiter.

  6. Füllen Sie die Felder im Konfigurationsformular aus und klicken Sie auf Weiter. Einzelheiten über dieses Formular finden Sie auf dieser Seite im Abschnitt Details der Konfigurationsseite.

  7. Klicken Sie auf Weiter.

  8. Siehe Abschnitt Optionen für die Sprachintegration konfigurieren auf dieser Seite.

  9. Klicken Sie auf Weiter.

  10. Wählen Sie auf der Seite "Transkript" aus, ob Sie das Gesprächstranskript und die Informationen zur Absicht erfassen (speichern) möchten. Sie können Nur Absichtsinfo erfassen und archivieren, Transkript und Absichtsinfo erfassen und archivieren oder Nur Transkript erfassen und archivieren auswählen. Oder Sie wählen Transkript oder Absichtsinfo nicht erfassen oder archivieren aus. Diese Option ist nur für äußerungsbasierte virtuelle Agenten verfügbar. Sie wird für Sprachintegrationen, die einen SIPGeschlossen Protokoll zur Signalisierung und Steuerung von Multimedia-Kommunikationssitzungen wie Sprach- und Videoanrufen.-Rückkanal verwenden, nicht unterstützt.

  11. Klicken Sie auf Weiter.

  12. Auf der Seite Testen + Hinzufügen können Sie die Verbindung Ihres Bots testen, indem Sie Sprach- oder Textaufforderungen senden. Wenn die Testmeldungen nicht funktionieren, klicken Sie auf Zurück, um zur Konfigurationsseite zurückzukehren und die Einstellungen zu überprüfen. Möglicherweise müssen Sie auch die Konfigurationen in der Verwaltungskonsole des Anbieters Ihres virtuellen Agenten überprüfen.

  13. Klicken Sie auf Hinzufügen.

Details der Konfigurationsseite für Google Dialogflow CX

Orientieren Sie sich beim Ausfüllen der Konfigurationsseite an den Informationen in der folgenden Tabelle. Sie sehen diese Seite beim Hinzufügen einer App in Hub für virtuelle Agenten

Wenn Sie Dialogflow CX dafür einrichten, eine SIPGeschlossen Protokoll zur Signalisierung und Steuerung von Multimedia-Kommunikationssitzungen wie Sprach- und Videoanrufen.-Rückkanal-Verbindung zu nutzen, folgen Sie den Schritten zur Einrichtung der Verbindung und nicht den Schritten in diesem Abschnitt.

TTS-Ausgabe von Google Dialogflow CX konfigurieren

Schließen Sie die Schritte in diesem Abschnitt ab, wenn Sie die Google-TTS-Dienste verwenden möchten. Die Felder im folgenden Bild werden angezeigt, wenn Sie die Option Ausgabe TTS durchführen auf der Dialogflow CX-Konfigurationsseite in Hub für virtuelle Agenten aktivieren.

  1. Fügen Sie in Hub für virtuelle Agenten eine neue Konfigurations-App hinzu und konfigurieren Sie sie gemäß den Schritten im Abschnitt Eine App hinzufügen zu Hub für virtuelle Agenten auf dieser Seite.
  2. Aktivieren Sie Ausgabe TTS durchführen.
  3. Wenn Sie ein benutzerdefiniertes Sprachmodell verwenden möchten, aktivieren Sie Eigene Stimme verwenden und geben Sie den Namen des Modells für AutoML, das Sie verwenden wollen, in das Feld Modell für eigene Stimme ein.

  4. Wenn Sie ein Google-Sprachmodell verwenden möchten, wählen Sie den Namen der TTS-Stimme aus der Dropdown-Liste aus.

  5. Wählen Sie das Modell für maschinelles Lernen und die Modellvariante, die die Google-TTS-Dienste beim Synthetisieren von Sprache verwenden sollen.

  6. Um am Anfang der Audioantwort des virtuellen Agenten einen Moment Stille hinzuzufügen, geben Sie die Dauer der Stille in Millisekunden in das Feld Anfängliche Stille hinzufügen ein. Die empfohlene Dauer der Stille ist 500 Millisekunden.

  7. Geben Sie das Sprechtempo, die Tonhöhe und die Verstärkung ein, um den Klang der TTS-Stimme zu konfigurieren.

  8. Gehen Sie zum Abschnitt Eine App hinzufügen zu Hub für virtuelle Agenten auf dieser Seite zurück, um das Hinzufügen der Konfigurations-App abzuschließen.

Optionen für die Sprachintegration konfigurieren

Erforderliche Berechtigungen Skripte anzeigen, Skripte erstellen/bearbeiten

Wenn Sie eine SIP-Rückkanalverbindung mit Ihrem sprachbasierten virtuellen Agenten verwenden, folgen Sie stattdessen den Schritten für die Einrichtung eines SIP-Rückkanals.

  1. Fügen Sie in Hub für virtuelle Agenten eine neue Konfigurations-App hinzu und konfigurieren Sie sie gemäß den Schritten im Abschnitt Eine App hinzufügen zu Hub für virtuelle Agenten auf dieser Seite.
  2. Klicken Sie auf der Konfigurationsseite auf Weiter.

  3. Wählen Sie auf der Seite "Sprache" unter "Optionen für die Sprachintegration" die Option Zug-um-Zug-Steuerung (CXone Voice Bot Gateway) aus.
  4. Wählen Sie unter "Text-to-Speech-Optionen" die Option CXone Cloud TTS verwenden aus, wenn Sie die CXone-TTS-Option nutzen möchten. Um stattdessen den TTS-Dienst des Anbieters Ihres virtuellen Agenten zu verwenden, entfernen Sie die Markierung von diesem Kontrollkästchen und konfigurieren Sie die TTS-Ausgabe auf der Konfigurationsseite des Assistenten.

    Wenn das Formular die Auswahl von CXone Cloud TTS verwenden nicht zulässt, klicken Sie auf Zurück, um zur Konfigurationsseite zurückzukehren. Stellen Sie den Schalter Ausgabe-TTS durchführen auf Aus. Jetzt können Sie Cloud TTS auf der Seite "Sprache" aktivieren.

  5. Wählen Sie einen TTS-Anbieter aus, falls Sie Cloud TTS verwenden. Wenn Sie den TTS-Dienst des Anbieters Ihres virtuellen Agenten verwenden, ist dieses Feld nicht sichtbar und Sie können diesen Schritt überspringen.
  6. Wählen Sie unter "Transkriptionsoptionen" die Option für den gewünschten Transkriptionsdienst aus.

  7. Wenn Sie ein CXone-Transkriptionsprofil verwenden möchten, klicken Sie auf Transkriptionsprofil, um das auszuwählen, das Sie verwenden möchten. Klicken Sie auf Neues Zug-um-Zug-Transkriptionsprofil hinzufügen, um ein neues Profil zu erstellen.
  8. Klicken Sie auf Weiter.
  9. Gehen Sie zum Abschnitt Eine App hinzufügen zu Hub für virtuelle Agenten auf dieser Seite zurück, um das Hinzufügen der Konfigurations-App abzuschließen.

Zuweisen der Google Dialogflow CX-App zu einer Aktion

Erforderliche Berechtigungen Skripte anzeigen, Skripte erstellen/bearbeiten

Wenn Sie die App für Ihren virtuellen AgentenGeschlossen Die Bedeutung oder der Zweck hinter dem, was ein Kontakt sagt/tippt; was der Kontakt mitteilen oder erreichen möchte in Hub für virtuelle Agenten eingerichtet und konfiguriert haben, müssen Sie sie den Aktionen für den virtuellen Agenten in Ihrem Skript zuweisen. Auf diese Weise verbinden Sie die Aktion und das Skript mit dem Anbieter Ihres virtuellen Agenten.

Welche Aktion Sie verwenden, ist von Ihrem virtuellen Agenten und dessen unterstützten Funktionen abhängig.

  1. Öffnen Sie unter Studio das Skript, das Sie ändern möchten.
  2. Falls noch nicht geschehen, klicken Sie auf die Registerkarte Extras, erweitern Sie die Kategorie Automatisierung und KI und fügen Sie die gewünschte Aktion des virtuellen Agenten hinzu. Fügen Sie sie an der richtigen Stelle in Ihrem Skript ein. Wenn die erwartete Aktion nicht angezeigt wird, stellen Sie sicher, dass Ihr Skript Medientyp korrekt ist. Wenn Sie zum Beispiel ein Skript für einen sprachbasierten virtuellen Agenten erstellen, muss Ihr Skript ein Telefonskript sein.

  3. Doppelklicken Sie auf die Aktion, um Hub für virtuelle Agenten zu öffnen.

  4. Suchen Sie in der linken Spalte den virtuellen Agenten, den Sie der Aktion zuweisen möchten, und klicken Sie auf die Auswahloption Symbol eines Kreises mit einem Häkchen darin. daneben.
  5. Klicken Sie auf Close (Schließen).

Ändern eines Transkriptionsprofils

Erforderliche Berechtigungen Skripte anzeigen, Skripte erstellen/bearbeiten

Mit einem Transkriptionsprofil können Sie einen anderen Transkriptionsdienst nutzen als den des Anbieters Ihres virtuellen Agenten. Jeder virtuelle Agent kann ein Transkriptionsprofil haben. Sie brauchen die Schritte in diesem Abschnitt nur dann auszuführen, wenn Sie mit einem sprachbasierten virtuellen Agenten arbeiten und das Transkriptionsprofil ändern müssen.

  1. Öffnen oder erstellen Sie in Studio ein Skript und fügen Sie eine Aktion für den virtuellen Agenten hinzu, falls es nicht bereits eine enthält.
  2. Doppelklicken Sie auf die Aktion des virtuellen Agenten, um Hub für virtuelle Agenten zu öffnen.
  3. Klicken Sie in der Liste der Konfigurations-Apps für virtuelle Agenten im linken Fensterbereich von Hub für virtuelle Agenten auf die App, die Sie modifizieren möchten.
  4. Klicken Sie in der Mitte der Eigenschaftenseite der virtuellen Agenten-App auf die Registerkarte Sprache.
  5. Wählen Sie unter "Transkriptionsoptionen" die Option CXone-Transkriptionsprofil verwenden aus, falls sie noch nicht ausgewählt ist.

  6. Wählen Sie das Zug-um-Zug-Transkriptionsprofil aus, das diese Integration des virtuellen Agenten verwenden soll. Wenn die von Ihnen gewünschte Option nicht vorhanden ist, können Sie sie hinzufügen.

  7. Klicken Sie auf Speichern.
  8. Testen Sie Ihren Transkriptionsdienst, indem Sie die Option "Mikrofon" im Bereich "Test" der Eigenschaftenseite Ihrer virtuellen Agenten-App verwenden.

Testen Ihres virtuellen Agenten

Erforderliche Berechtigungen Skripte anzeigen, Skripte erstellen/bearbeiten

Sie können zahlreiche Aspekte Ihres virtuellen Agenten testen, um sicherzustellen, dass er wie vorgesehen funktioniert. Die Tests lassen sich von der Eigenschaftenseite der virtuellen Agenten-App in Hub für virtuelle Agenten aus durchführen. Sie können:

  • Überprüfen, ob die virtuelle Agenten-App korrekt dafür konfiguriert wurde, um mit dem Anbieter des virtuellen Agenten zu kommunizieren.
  • Eine JSON-Datei für benutzerdefinierte Nutzdaten hinzufügen, um zu testen, wie der virtuelle Agent solche Daten handhabt.
  • Ein Ereignis für eine Begrüßungsabsicht auslösen, um zu testen, wie der virtuelle Agent ein Gespräch beginnt.
  • Ein Ereignis für eine benutzerdefinierte Absicht auslösen, um benutzerdefinierte Ereignisse zu testen, die Sie für Ihren virtuellen Agenten erstellt haben.
  • Ein Zeitüberschreitungsereignis auslösen, um zu testen, wie sich der virtuelle Agent verhält, wenn für den Kontakt eine Zeitüberschreitung auftritt.
  • Testen, wie der Bot eine DTMFGeschlossen Signaltöne, die erzeugt werden, wenn ein Benutzer eine Taste auf seiner Telefontastatur drückt oder antippt.-Eingabe handhabt.

Das folgende Bild ist ein Beispiel für die Eigenschaftenseite einer virtuellen Agenten-App in Hub für virtuelle Agenten . Zu sehen sind die Registerkarten "Konfiguration" und "Sprache" sowie der Testbereich.

  1. Öffnen oder erstellen Sie in Studio ein Skript und fügen Sie eine Aktion für den virtuellen Agenten hinzu, falls es nicht bereits eine enthält.
  2. Doppelklicken Sie auf die Aktion des virtuellen Agenten, um Hub für virtuelle Agenten zu öffnen.
  3. Klicken Sie in der Liste links auf die Konfigurations-App für den virtuellen Agenten, den Sie testen möchten, um sie auszuwählen.
  4. Geben Sie im Bereich "Test" eine Testnachricht in das Feld Nachricht eingeben ein und drücken Sie die Eingabetaste, um die Nachricht zu senden. Sie können auch auf das Mikrofon Ein Symbol in Form eines Mikrofons. klicken und in das Mikrofon Ihres Computers sprechen.

  5. Klicken Sie auf Start mit Begrüßungsabsicht, um ein Testgespräch von Beginn an zu starten. Der virtuelle Agent reagiert mit seiner Standard-Begrüßungsnachricht. Sie können Testnachrichten eingeben.
  6. Klicken Sie auf Weitere Optionen Ein Symbol mit drei vertikal angeordneten Punkten., um andere Aspekte Ihres virtuellen Agenten zu testen.

  7. Klicken Sie auf Zurücksetzen , um Ihren Test erneut zu starten.
  8. Wenn Sie auf Grundlage der Testergebnisse Änderungen vornehmen müssen, können Sie folgendermaßen vorgehen:

    • Ändern Sie die Studio-Skripte für den virtuellen Agenten.
    • Ändern Sie die Konfigurationseinstellungen in der App des virtuellen Agenten in Hub für virtuelle Agenten .
    • Ändern Sie die Konfigurationseinstellungen des virtuellen Agenten in der Konsole des Anbieters. Klicken Sie auf die große quadratische Schaltfläche auf der Seite "App-Eigenschaften" in Hub für virtuelle Agenten . Das Beispiel am Anfang dieses Abschnitts zeigt die Google Dialogflow CX-App mit der Anbieter-Schaltfläche. Sie ist mit dem Symbol Ein Symbol mit einem Quadrat und einem Pfeil. Der Pfeil zeigt von der Mitte des Quadrats zur oberen rechten Ecke des Quadrats. versehen, das darauf hinweist, dass über den Link eine externe Website geöffnet wird.
  9. Nach jeder Änderung der Skripte oder einer Konfigurationseinstellung muss der virtuelle Agent sorgfältig getestet werden.
  10. Wenn Sie die Tests abgeschlossen haben, klicken Sie auf Schließen.