Integrieren Sie Google Dialogflow ES

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 benötigen mindestens ein Studio-Skript, um Interaktionen an Ihren virtuellen Agenten weiterzuleiten. Folgen Sie den Richtlinien und Anforderungen für Skripte. Die unterstützte Aktion für den virtuellen Agenten dieses Anbieters ist VoiceBot Exchange und Ihr Skript muss den MedientypGeschlossen Ein Medium wie z. B. Sprache, E-Mail und Chat, über das ein Kontakt mit dem vorgesehenen Empfänger Kontakt aufnimmt. "Telefon" haben.The supported virtual agent action for this provider is Voicebot Conversation and your script must have the phone media typeGeschlossen Ein Medium wie z. B. Sprache, E-Mail und Chat, über das ein Kontakt mit dem vorgesehenen Empfänger Kontakt aufnimmt..

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

Wenn Ihr virtueller Agent für die Produktionsumgebung bereit ist, weisen Sie das Skript einer oder mehreren Kontaktstellen zu.

Best Practices für benutzerdefinierte Nutzdaten

Befolgen Sie diese Best Practices bei der Integration von benutzerdefinierten Nutzdaten Google Dialogflow ES in CXone:

  • CustomPayload wird verwendet, um den Kontext für eine AbsichtGeschlossen Die Bedeutung oder der Zweck hinter dem, was ein Kontakt sagt/tippt; was der Kontakt mitteilen oder erreichen möchte zu übergeben. Der Kontext hilft dem virtuellen Agenten, die Absicht des Benutzers zu verstehen. Kontexte sind nicht erforderlich, aber sie helfen dem virtuellen Agenten, eine ÄußerungGeschlossen Was ein Kontakt sagt oder tippt. einer Absicht zuzuordnen.
  • Erstellen Sie in einer Snippet -Aktion in Ihrem Skript ein customPayload-Objekt mit dem Format gemäß Google Dialogflow ES-Dokumentation Symbol, das angibt, dass der Link zu einer externen Website geht für die REST-Ressource: projects.agent.sessions.context. Die Onlinehilfe für Studio enthält weitere Informationen über dynamische Datenobjekte.
  • Sie können auch benutzerdefinierte Daten mit customPayload ohne Kontexte übergeben. Fügen Sie dazu standardmäßige JSON-Schlüssel-Wert-Paare in ein dynamisches Objekt ein.
  • Sprachkontexte werden in eigener Payload zum speech_contact-Parameter hinzugefügt. Sie können die Inhalte dieses Parameters in Studio-Traces und Anwendungsprotokollen sehen.
  • Das dynamische customPayload-Objekt wird als Parameter für den virtuellen Agenten in Form von JSON übergeben, wie im Beispielskript gezeigt.
  • 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. Beispiel:

    DYNAMIC customPayload
    customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
    customPayload.speechContexts.boost=10		

Eine App zu Virtual Agent Hub hinzufügen

Erforderliche Berechtigungen: Skripte anzeigen, Skripte erstellen/bearbeiten

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

  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 Virtual Agent Hubzu ö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 ES.

  5. Klicken Sie auf Next (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 Next (Weiter).

  8. Wenn Sie einen textbasierten virtuellen Agenten einrichten, wählen Sie Nur Text (Keine Sprachunterstützung) auf der Seite "Sprache" aus. Wenn Sie einen sprachbasierten virtuellen Agenten einrichten, lesen Sie den 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.

  11. Klicken Sie auf Next (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 ES

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 Virtual Agent Hub

Feld

Details

Integration Version

Wählen Sie die Version von Virtual Agent Hub, die Sie verwenden möchten. Mit dieser Option können Sie eine frühere Version von Virtual Agent Hub verwenden, bis Sie bereit sind, auf eine neuere Version umzusteigen. Diese Versionen sind verfügbar:

  • Version 1.0.0 Dies ist die erste Version von Virtual Agent Hub. Das benutzerdefinierte Payload-Objekt wird als customPayload.payload.xxxx zurückgegeben.
  • Version 2.0.0Mit dieser Version wurden die mit Google Dialogflow ES verwendeten Schemas aktualisiert. Dies wirkt sich auf die Struktur des customPayload-Objekts aus.
  • Version 3.0.0: Mit dieser Version wurde StandardBot eingeführt. Damit wird die Kommunikation von CXone mit Anbietern virtueller Agenten standardisiert. Das customPayload-Objekt wird als Array in Form von customPayloadscriptPayloads[n].xxxx zurückgegeben. Diese Version ist für alle Anbieter verfügbar.
Kunde GCP-Projekt-ID

Die Google Cloud-Projekt-ID Ihrer Organisation. Dies ist die Kennung für Ihren Virtual Agent. Sie finden sie in den Einstellungen der Konsole Google Dialogflow ES.

Dieses Feld ist nur sichtbar, wenn Sie ein OEM-Servicekonto verwenden.

JSON-Servicekonto

Die Schlüssel-Datei für das Service-Konto, die Sie erstellt und von Ihrer Google Cloud Console heruntergeladen haben. Kopieren Sie den gesamten Inhalt der Schlüsseldatei und fügen Sie ihn in dieses Feld ein. Dieses Feld ist nur sichtbar, wenn Sie Ihr eigenes Google Dialogflow ES Konto verwenden.

Der Schlüssel des Dienstkontos ist ein JSON-Objekt ähnlich dem folgenden Beispiel.

{

"type": "service_account",
"project_id": "ic-demo2-aai-gcp",
"private_key_id": "sdv80sdf08ssd9sdf0sdf8sdfsdf90sdf8",
"private_key": "-----BEGIN PRIVATE KEY-----
nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCzgrS8vp
<private key has been truncated for this example>
----END PRIVATE KEY-----\n",
"client_email": "your@client_email-gcp.iam.gserviceaccount.com",
"client_id": "123456789",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/dialogflow-dthjop%40ic-demo2-aai-gcp.iam.gserviceaccount.com"
}

Sprache

Die Sprache, die dieser virtuelle Agent verwenden soll. Dies ist die Sprache, die der virtuelle Agent versteht. Dies ist eine erforderliche Angabe.

Region Die Region, in der sich Ihr virtueller Agent Google Dialogflow ES befindet.
Umwelt Der Name der benutzerdefinierten Umgebung, in der Ihr virtueller Agent veröffentlicht wird. Wenn Sie dieses Feld leer lassen, wird die Entwurfsumgebung verwendet.
Ausgabe TTS durchführen

Aktivieren Sie diese Option, wenn Sie den Text-to-Speech (TTSGeschlossen Ermöglicht den Benutzern die Eingabe von Ansagen als Text und die Verwendung einer computergenerierten Sprache für die Aussprache des Inhalts.)-Dienst von Google Dialogflow ES verwenden möchten. Konfigurieren Sie die TTS-Ausgabeeinstellungen.

Wenn Sie den TTS-Dienst von Google nicht verwenden möchten, können Sie CXoneCloud TTS Hub verwenden. Sie konfigurieren diese Option auf der Seite "Sprache" des Assistenten für die Konfigurations-App.

Timeout-Ereignis Name des Google Dialogflow ES Ereignisses, das bei Zeitüberschreitung ausgelöst werden soll.
DTMF-Ausbruchsmuster

Geben Sie die Zeichen ein, die den virtuellen Agenten bei einem Anruf veranlassen, zur DTMFBreakout -Verzweigung des Studio-Skripts zu wechseln.

Füllen Sie dieses Feld nur aus, wenn es sich um einen sprachbasierten virtuellen Agenten handelt.

Google Protobuf JSON Serializer verwenden

Aktivieren Sie diese Option, um Google Protobuf Serializer zu verwenden. Serialisierte Antworten verbessern die Leistung, indem sie die Größe der Antworten und den für ihre Verarbeitung erforderlichen Speicherplatz reduzieren. Die Größenreduzierung macht es unwahrscheinlicher, dass die Antworten 32 KB überschreiten, was die allgemeine Größenbegrenzung für Skriptvariablen ist.

NICE CXone empfiehlt, dass Sie diese Option aktivieren. Wenn Sie die Funktion aus irgendeinem Grund deaktivieren müssen, sollte sie wieder aktiviert werden, sobald das Problem behoben ist.

Wenn Sie Ihre Google Dialogflow ES -Integration vor der Frühjahrsversion 2022 von CXone eingerichtet haben, ist es wichtig, dass Sie Ihre Skripte für das Parsen von Nutzdaten überprüfen. Überall, wo Sie diese Option finden, müssen Sie sie durch das Parsing aus dem neuen Schema ersetzen, bevor Sie diese Option in Ihrer Integration aktivieren. Wenn Ihr Skript zum Beispiel derzeit auf etwas wie dieses verweist: 

{parameters.fields.myfield.stringValue}

Sie würden es ändern in:

{parameters.myfield}

Zeitüberschreitung bei externem Anbieter

Geben Sie die Anzahl der Sekunden ein, die das Skript auf eine Antwort von Dialogflow ES  warten soll. Wenn die Zeitüberschreitung erreicht wird, wird die Steuerung an das Skript zurückgegeben, das der Fehlerverzweigung folgt.

TTS-Ausgabe von Google Dialogflow ES konfigurieren

Erforderliche Berechtigungen: Skripte anzeigen, Skripte erstellen/bearbeiten

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 ES-Konfigurationsseite in Virtual Agent Hub aktivieren.

  1. Fügen Sie in Virtual Agent Hub eine neue Konfigurations-App hinzu und konfigurieren Sie sie gemäß den Schritten im Abschnitt Eine App hinzufügen zu Virtual Agent Hub 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 Virtual Agent Hub 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

  1. Fügen Sie in Virtual Agent Hub eine neue Konfigurations-App hinzu und konfigurieren Sie sie gemäß den Schritten im Abschnitt Eine App hinzufügen zu Virtual Agent Hub 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. 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 Hub auf der Seite "Sprache" aktivieren.

  5. Wählen Sie einen TTS-Anbieter aus, falls Sie Cloud TTS Hub 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 Next (Weiter).
  9. Gehen Sie zum Abschnitt Eine App hinzufügen zu Virtual Agent Hub auf dieser Seite zurück, um das Hinzufügen der Konfigurations-App abzuschließen.

Zuweisen der Google Dialogflow ES-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 Virtual Agent Hub eingerichtet und konfiguriert haben, müssen Sie sie der Aktion 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.

  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 Virtual Agent Hub zu öffnen.

  4. Suchen Sie in der linken Spalte den virtuellen Agenten, den Sie der Aktion zuweisen möchten, und klicken Sie auf das Häkchensymbol Symbol eines Kreises mit einem Häkchen darin. daneben.
  5. Klicken Sie auf 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 Virtual Agent Hubzu öffnen.
  3. Klicken Sie in der Liste der Konfigurations-Apps für virtuelle Agenten im linken Fensterbereich von Virtual Agent Hub 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 Virtual Agent Hub aus durchführen. Beim Testen können Sie:

  • Ü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 Virtual Agent Hub. 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 Virtual Agent Hubzu ö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 Virtual Agent Hub.
    • Ä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 Virtual Agent Hub. 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.