VoiceBot Exchange

Integriert einen virtuellen Self-Service-Virtual Agent Eine Softwareanwendung, die Kundeninteraktionen anstelle eines Live-Mitarbeiters abwickelt. mit Sprachskripten. Diese Aktion wird in einer Schleife im Skript verwendet. Ein Skript muss mindestens zwei VoiceBot Exchange -Aktionen enthalten. Ihr virtueller Agent muss diese Aktion unterstützen. Die Voicebot Exchange -Aktion ist für komplexe virtuelle Agenten vorgesehen oder für Situationen, in denen das Verhalten des virtuellen Agenten von Runde zu Runde angepasst werden muss. Sie überwacht das Gespräch zwischen dem Kontakt und dem virtuellen Agenten Runde für Runde. Jede Äußerung Was ein Kontakt sagt oder tippt. wird an den virtuellen Agenten gesendet. Der virtuelle Agent analysiert die Äußerung hinsichtlich Absicht Die Bedeutung oder der Zweck hinter dem, was ein Kontakt sagt/tippt; was der Kontakt mitteilen oder erreichen möchte und Kontext und bestimmt die passende Antwort. Die Aktion gibt die Antwort des virtuellen Agenten an den Kontakt weiter. Wenn das Gespräch beendet ist, fährt die Aktion mit dem Skript fort. Wenn Sie "barge in" oder "no input" konfigurieren möchten, ist eine zusätzliche Skripterstellung erforderlich. Wenn Sie auf diese Aktion doppelklicken, wird Virtueller Agenten-Hub geöffnet, wo Sie alle Ihre virtuellen Agenten verwalten können.

ABHÄNGIGKEITEN

• Ein Skript muss mindestens zwei VoiceBot Exchange -Aktionen enthalten, die in einer Schleife verbunden sind.
• Damit Sie diese Aktion verwenden können, muss Ihr virtueller Agent die Anpassung von einzelnen Gesprächsrunden unterstützen.

• Eine Gesprächsrunde wird folgendermaßen definiert:

  1. Die Kontaktäußerung, die an den virtuellen Agenten gesendet wird.
  2. Der virtuelle Agent verarbeitet die Äußerung und definiert alle benutzerdefinierten Nutzdaten.
  3. Die Antwort geht zurück an den Kontakt.
  4. Etwaige zusätzliche Aktionen, die in der Eigenschaft nextPromptBehaviors festgelegt sind (z. B. ein Datenbank- oder externer API-Aufruf). Sie können die Gesprächsschleife auch so konfigurieren, dass sie beendet wird, wenn die Interaktion abgeschlossen wurde oder wenn der Kontakt an einen Live-Agenten weitergeleitet wird.
• Wenn Sie eine eigene Payload in virtuelle Agenten von Google Dialogflow ES oder Google Dialogflow CX aufnehmen, folgen Sie den Empfehlungen und Richtlinien für die eigene Payload.  Sie finden die Richtlinien für CX und ES auf dieser Seite.

Unterstützte Skripttypen

Telefon

Vergleich ähnlicher Aktionen

Die folgenden Aktionen haben ähnliche Funktionen, aber mit einigen wichtigen Unterschieden:

• Textbot Exchange: Diese action wird für komplexe Interaktionen mit virtuellen Agenten verwendet. Sie ermöglicht Ihnen, Exchange-Parameter einzubeziehen und verschiedene Aspekte des Gesprächs zwischen dem Kontakt und dem virtuellen Agenten anzupassen.
• Voicebot Exchange: Diese action wird für komplexe Interaktionen mit virtuellen Agenten verwendet. Sie ermöglicht Ihnen, Exchange-Parameter einzubeziehen und verschiedene Aspekte des Gesprächs zwischen dem Kontakt und dem virtuellen Agenten anzupassen.

Unterstützte virtuelle Agenten

Diese Aktion unterstützt die folgenden virtuellen Agenten:

• Amazon Lex V1
• Amazon Lex V2
• Google Dialogflow CX (nur für äußerungsbasierte Verbindungen empfohlen)
• Google Dialogflow ES
• Microsoft Azure

Bevor Sie dieser Aktion einen virtuellen Agenten zuweisen können, müssen Sie in Virtueller Agenten-Hub eine App für den virtuellen Agenten hinzufügen und konfigurieren. Sie benötigen nur eine App für jeden virtuellen Agenten, den Sie verwenden. Sie können dieselbe App mehreren Aktionen für virtuelle Agenten in Ihren Skripten zuweisen. Weitere Informationen zur Konfiguration finden Sie in der Hilfeseite für den von Ihnen verwendeten virtuellen Agentenanbieter.

Eingabeeigenschaften

Diese Eigenschaften definieren Daten, die von der Aktion bei der Ausführung verwendet werden.

Eine oder mehrere Eigenschaften dieser Aktion erfordern eine Snippet-Aktion mit benutzerdefiniertem Code.

Eigenschaft	Beschreibung
Caption	Geben Sie eine kurze Phrase ein, mit der diese Aktion im Skript eindeutig identifiziert wird. Die Beschriftung wird im Skript-Arbeitsbereich unter dem Symbol der Aktion angezeigt. The default is the action name.
virtualAgentID	Der Name des in Virtueller Agenten-Hub ausgewählten virtuellen Agenten. Wenn Sie eine virtuelle Agenten-App einer Studio-Aktion in Virtueller Agenten-Hub zuweisen, wird diese Eigenschaft automatisch ausgefüllt. Der Name ist der Name, der im Feld Virtual Agent (Bot) Name in der Virtueller Agenten-Hub-App verwendet wird.
customPayload	Konfigurieren Sie diese Eigenschaft nur, wenn Sie benutzerdefinierte Nutzlastdaten zum virtuellen Agenten weitergeben müssen. Das benutzerdefinierte Nutzlast-Objekt wird vom Studio-Skript ausgefüllt. Sie können es verwenden, um Informationen wie den Namen des Kontakts aus einem CRM Systeme von Drittanbietern, die z. B. Kontakte, Vertriebsinformationen, Supportdetails und Fallgeschichten verwalten. zu übergeben, die in einer Willkommensnachricht verwendet werden sollen. Geben Sie den Namen des JSON-Objekts ein, das Daten vom Skript zum virtuellen Agenten weitergibt. Sie müssen das benutzerdefinierte Nutzlast-Objekt in einer Snippet-Aktion definieren. Das Objekt muss in das JSON-Format umgewandelt werden, entweder im Snippet oder in der customPayload-Eigenschaft. Anforderungen für spezifische Anbieter virtueller Agenten: Amazon Lex V1: Diese Eigenschaft ist auch dann erforderlich, wenn Sie keine Daten an den virtuellen Agenten übergeben müssen. Fügen Sie ein Snippet mit einem Platzhalterwert hinzu. Google Dialogflow ES: Diese Eigenschaft wird verwendet, um den Kontext für eine Absicht Die Bedeutung oder der Zweck hinter dem, was ein Kontakt sagt/tippt; was der Kontakt mitteilen oder erreichen möchte zu übergeben. Informieren Sie sich über die empfohlenen Verfahren für eigene Payloads mit Google Dialogflow ES, um eine korrekte Handhabung sicherzustellen. Google Dialogflow CX: Informieren Sie sich über die empfohlenen Verfahren für eigene Payloads mit Google Dialogflow CX, um eine korrekte Handhabung sicherzustellen. Verwenden Sie diese Eigenschaft nicht, wenn Sie Daten verarbeiten müssen, die der virtuelle Agent an das Skript zurückgibt. Verwenden Sie stattdessen die Variable customPayloadVarName (out).
nextPromptSequence	Die vom virtuellen Agenten empfangene Antwort, die für den Kontakt wiedergegeben wird. Konfigurieren Sie diese Eigenschaft mit der Variablen, die in nextPromptSequenceVarName (out) mit der Funktion asJSON() angegeben ist. Sie können auch den Inhalt von nextPromptSequenceVarName (out) in einer Snippet-Aktion in das JSON-Format konvertieren und diese Eigenschaft mit der Variablen konfigurieren, die den JSON-Code enthält.
nextPromptBehaviors	Gibt die Konfiguration und das Verhalten der nächsten Eingabeaufforderung in einem Gespräch an. Definieren Sie die gewünschten Verhaltensweisen mit einer Snippetaction- und folgen Sie dem Snippet-Beispiel Standardverhalten der nächsten Aufforderung oder Verhalten der nächsten Aufforderung. In diesem Beispiel werden Eigenschaften beschrieben, mit denen Sie Komfortgeräusche, DTMF-Erfassung und das Sprechen des Kontakts während der Audiowiedergabe (Barge) konfigurieren können. Konfigurieren Sie die Eigenschaft nextPromptBehavior mit dem Namen des Objekts, das Sie im Snippet-Code verwendet haben. Dadurch werden die Einstellungen an diese Eigenschaft und ihre Aktion weitergegeben. Wenn Sie das Snippet-Beispiel für "Verhalten der nächsten Aufforderung" verwenden, geben Sie für diese Eigenschaft {nextPromptBehaviorsOutjson} ein. Sie müssen diese Eigenschaft nur konfigurieren, wenn Sie mithilfe dieser Aktion einen virtuellen Agenten, der Text verarbeitet, zur Handhabung von Sprachinteraktionen einrichten.
botSessionState	Der Anbieter des virtuellen Agenten weist jedem Gespräch zwischen einem Kontakt und einem virtuellen Agenten eine eindeutige ID zu. Die Kennung verhindert, dass für das Gespräch jedes Mal eine neue Sitzung erstellt wird. Der Anbieter erstellt die ID beim Beginn des Gesprächs und übergibt sie mit der ersten Antwort an das Skript. Das Skript speichert die ID in der Variablen, die in der Eigenschaft botSessionStateVarName (out) dieser Aktion angegeben ist. Anschließend übergibt es die ID an die Eigenschaft botSessionState. Diese Eigenschaft muss korrekt konfiguriert werden, damit Ihr virtueller Agent ordnungsgemäß funktioniert. Weitere Informationen zur Konfiguration finden Sie auf der Hilfeseite zum Snippet für den Bot-Sitzungsstatus.
automatedIntent	Geben Sie namentlich eine bestimmte Absicht ein, auf die der virtuelle Agent antworten soll, anstatt den virtuellen Agenten die gesammelten Benutzereingaben interpretieren zu lassen. Ein häufiger Anwendungsfall hierfür ist das Auslösen der ersten Willkommensnachricht vom virtuellen Agenten. Welcome ist der Standardstring für die erste Begrüßung.

Ausgabeeigenschaften

Diese Eigenschaften enthalten Variablen mit Daten, die bei der Ausführung der Aktion zurückgegeben werden. Sie stehen zu Referenzzwecken und zur Verwendung nach Abschluss der Aktion zur Verfügung.

Eigenschaft	Beschreibung
nextPromptBehaviorsVarName (out)	Definiert das Verhalten, mit dem der Benutzer bei der nächsten Gesprächsrunde aufgefordert wird.
nextPromptSequenceVarName (out)	Enthält die Antwort vom virtuellen Agenten und übergibt sie an die Eigenschaft nextPromptSequence.
customPayloadVarName (out)	Gibt benutzerdefinierte JSON-Daten vom virtuellen Agenten an das Skript zurück. Verwenden Sie diese Variable, wenn das Skript Daten verarbeiten soll, die der virtuelle Agent bereitstellt. Kann Erfüllungsdaten enthalten. Wenn Sie Daten an den virtuellen Agenten übergeben möchten, verwenden Sie die Eigenschaft customPayload.
errorDetailsVarName (out)	Veranlasst die Fehlerabsichtssequenz; kann zu einer Übertragung an einen Live-Agenten führen.
intentInfoVarName (out)	Eine Variable, die Details vom virtuellen Agenten enthält, die die aktuelle Benutzerabsicht anzeigen.
botSessionStateVarName (out)	Enthält die Variable, in der das Skript die ID für den Bot-Sitzungsstatus speichert, die vom Anbieter des virtuellen Agenten bereitgestellt wird. Der Inhalt der Variablen wird an die botSessionState-Eigenschaft übergeben. Diese Eigenschaft muss korrekt konfiguriert werden, damit Ihr virtueller Agent ordnungsgemäß funktioniert. Weitere Informationen zur Konfiguration finden Sie auf der Hilfeseite zum Snippet für den Bot-Sitzungsstatus.

Bedingungen für Ergebnisverzweigungen

Mit Bedingungen für Ergebnisverzweigungen können Sie in Ihrem Skript Verzweigungen erstellen, die für unterschiedliche Ergebnisse bei der Ausführung einer Aktion vorgesehen sind.

Bedingung	Beschreibung
Default	Genommener Pfad, außer das Skript erfüllt eine Bedingung, die es erfordert, einer der anderen Verzweigungen zu folgen. Dieser Pfad wird auch genommen, wenn die anderen Verzweigungen der Aktion nicht definiert sind.
OnPromptAndCollectNextResponse	Genommener Pfad, wenn der virtuelle Agent bestimmt hat, dass die Interaktion fortgesetzt werden soll und bereit für weitere menschliche Eingaben des Kontakts ist. Fordert zur nächsten Runde im Gespräch auf.
OnError	Genommener Pfad, wenn ein unerwartetes Problem auftritt (wie z. B. schlechte Konnektivität, Syntaxfehler und so weiter). Die Variable _ERR muss mit einer zusammengefassten Erläuterung des Problems ausgefüllt werden.
OnReturnControlToScript	Genommener Pfad, wenn der virtuelle Agent anzeigt, dass das Gespräch beendet ist, und die Kontrolle an das Studio-Skript zurückgibt, um den Anruf weiterzuleiten oder zu beenden. Möglicherweise enthält das customPayload-Ergebnis Erfüllungsdaten, die verarbeitet werden müssen.
OnDTMFBreakout	Pfad, der genommen wurde, wenn eine DTMF Signaltöne, die erzeugt werden, wenn ein Benutzer eine Taste auf seiner Telefontastatur drückt oder antippt.-Regel im Skript erfüllt wurde.
OnUserInputTimeout	Pfad, der eingeschlagen wird, wenn es in der vom Aufforderungsverhalten-Snippet angegebenen Zeit keine Antwort vom Benutzer gibt (entweder das "Standard- oder das "Verhalten der nächsten Aufforderung"-Snippet). Für Google Dialogflow können Sie das gewünschte Ereignis in der App Virtueller Agenten-Hub Dialogflow konfigurieren. Für Dialogflow ES konfigurieren Sie das Feld Timeout Event . Für Dialogflow CX konfigurieren Sie den Timeout Event Handler. Wenn kein Ereignis konfiguriert ist, wird standardmäßig der in der Konsole Dialogflow konfigurierte Standard-Fallback-Intent verwendet. Wenn Sie möchten, können Sie diese Verzweigung so konfigurieren, dass er an verschiedenen Stellen in Ihrem Skript unterschiedliche Ereignisse verwendet.
OnUserInputNotUnderstood	Genommener Pfad, wenn der virtuelle Agent die Antwort des Kontakts nicht versteht oder wenn beim Kontakt eine Zeitüberschreitung auftritt.

Erforderlicher SNIPPET-Aktionscode

Eine oder mehrere Eigenschaften dieser Aktion erfordern eine Snippetaction- mit dem folgenden benutzerdefinierten Code:

• Eigene Payload
• Verhalten der nächsten Aufforderung und Standardverhalten der nächsten Aufforderung
• Nächste Eingabeaufforderungsreihenfolge
• Bot-Sitzungsstatus

Best Practices für benutzerdefinierte Nutzdaten mit Google Dialogflow CX

Wenn Sie diese Aktion mit Google Dialogflow CX verwenden, beachten Sie die folgenden Best Practices für die Integration von benutzerdefinierten Nutzdaten:

• Dialogflow CX verwendet keine Kontexte, um Daten an Dialogflow intents 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-Aktion in Ihrem Skript ein dynamisches customPayload-Objekt und fügen Sie ihm die Schlüssel-Wert-Paare hinzu. Beispiel:

  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 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. Beispiel:

  {
  	"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 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		

• Um 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.

Best Practices für benutzerdefinierte Nutzdaten mit Google Dialogflow ES

Wenn Sie diese Aktion mit Google Dialogflow ES verwenden, beachten Sie die folgenden Best Practices für die Integration von benutzerdefinierten Nutzdaten:

• CustomPayload wird verwendet, um den Kontext für eine Absicht 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ßerung 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 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 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		

Tipps und Tricks

Wenn kein Sprachaudio zwischen Virtueller Agenten-Hub und dem virtuellen Agenten zu hören ist, überprüfen Sie im Skript-Trace, ob ein Transkript vorhanden ist. Ist dies der Fall, muss der virtuelle Agent von Google Dialogflow angepasst werden.

Skriptbeispiel

VoiceBot Exchange-Aktionen müssen in einer Schleife verwendet werden. Deshalb müssen Sie mindestens zwei in einem Skript verwenden. Die erste Aktion initiiert den Aufruf der API des virtuellen Agenten und muss der Aktion Standardverhalten der nächsten Aufforderung Snippetvorangestellt werden. Die erste Aktion ist die Begrüßungsvorgabe, mit der die erste geskriptete Schleife oder eine Gesprächs-"Runde" beginnt.

Laden Sie dieses Skript herunter.

Beispielskript für CustomPayload mit Google Dialogflow ES

Dieses Skript ist ein Beispiel für die Integration eigener Payloads in virtuelle Agenten von Google Dialogflow ES. Dieses Skript verwendet die Voicebot Exchange-Aktion, funktioniert aber auch bei Verwendung von TEXTBOT EXCHaNGE.

Laden Sie dieses Skript herunter.

Beispielskript für alternierende Timeout-Ereignisse

Sie können verschiedene Timeout-Ereignisse an verschiedenen Stellen in Ihrem Skript verwenden. Beispielsweise können Sie beim ersten und beim zweiten Auslösen der UserInputTimeout -Eigenschaft unterschiedliche Zeitüberschreitungsereignisse verwenden. Dieses Beispielskript zeigt einen möglichen Weg, dies zu erreichen.

In diesem Skript werden Snippet -Aktionen zum Erstellen und Erhöhen eines Zeitüberschreitungszählers verwendet. Nach der zweiten Zeitüberschreitung wird eine Snippet -Aktion verwendet, um ein anderes Zeitüberschreitungsereignis zu setzen. Das alternative Zeitüberschreitungsereignis wird über die automatedIntent -Eigenschaft von der Snippet -Aktion an die Voicebot-Aktion übergeben.

Laden Sie dieses Skript herunter.