Assistentenantworten hinzufügen
Wenn eine Aktion aktiviert wird, besteht der Hauptteil der Aktion aus mehreren Schritten, die das Gespräch zwischen Ihrem Assistenten und Ihren Benutzern ausmachen. Ein Teil jedes Schritts ist das, was der Assistent dem Kunden sagt, wenn der Schritt verarbeitet wird.
Zum Erstellen der Antwort des Assistenten in einem Schritt verwenden Sie den Abschnitt Assistent sagt. Dies ist der Text oder die Rede, die der Assistent einem Benutzer in einem bestimmten Schritt liefert. Je nach Schritt können Sie eine vollständige Antwort auf die Frage eines Benutzers hinzufügen oder eine Folgefrage stellen.
Sie können eine einfache Textantwort eingeben, indem Sie den Text angeben, den der Assistent dem Benutzer anzeigen soll. Sie können auch Formatierungen und Webinhalte hinzufügen und mithilfe von Variablen auf Benutzerinformationen verweisen.
Antworten formatieren
Verwenden Sie die Texteditortools, um einen Schriftstil (z. B. fett oder kursiv) auf den Text anzuwenden oder Links hinzuzufügen.
Im Hintergrund werden Schriftstil und Link-Syntax im Markdown-Format gespeichert. Wenn Sie die Web-Chat-Integration verwenden, werden HTML-und Markdown-Tags unterstützt. Weitere Informationen finden Sie unter Markdown-Formatierung.
HTML-Tags (außer bei Links) werden automatisch aus Textantworten entfernt, die an WhatsApp, gesendet werden, da diese Kanäle keine HTML-Formatierung unterstützen. HTML-Tags werden weiterhin in Kanälen verarbeitet, die sie unterstützen (z. B. im Web-Chat) und im Sitzungsprotokoll gespeichert.
Wenn Sie eine angepasste Clientanwendung nutzen, die keine Unterstützung für das Markdown-Format bietet, wenden Sie keine Textstile auf Ihre Textantworten an.
Variablen hinzufügen und referenzieren
Während des Dialogs speichert der Assistent Informationen als Variablen. Variablen sind Container für Datenwerte, die zur Laufzeit verfügbar werden. Der Wert einer Variablen kann sich im Laufe der Zeit ändern. Zu den Variablen gehören Aktionsvariablen, die nur während einer bestimmten Aktion erhalten bleiben, und Sitzungsvariablen, die für jede Aktion verfügbar sind. Weitere Informationen zu Variablen finden Sie unter Informationen während des Dialogs verwalten.
In den Ergebnissen Ihres Assistenten können Sie auf Variablen verweisen, um das Gespräch zu personalisieren oder Informationen hinzuzufügen, die zur Laufzeit verfügbar sind. Weitere Informationen zum Referenzieren von Variablen in dem von Ihrem Assistent Gesagten finden Sie unter Variablen zum Anpassen des Dialogs verwenden.
Antworten testen
Um zu überprüfen, ob die Antworten des Assistenten korrekt formatiert sind, können Sie die Vorschau verwenden.
- Klicken Sie auf die Schaltfläche Vorschau.
- Um die Aktion zu starten, geben Sie Ihren ersten Satz ein. Beispiel:
What are your store hours?
. - Wenn der Assistent antwortet, überprüfen Sie, ob die Nachricht wie gewünscht mit der gewünschten Formatierung und Verwendung von Variablen angezeigt wird.
Tipps zum Hinzufügen von Antworten
- Antworten sollten kurz und aussagekräftig sein.
- Beziehen Sie die Absicht des Benutzers in die Antwort ein. Dies zeigt den Benutzern, dass der Bot ihr Anliegen versteht oder ihnen die Möglichkeit gibt, ein Missverständnis sofort zu korrigieren.
- Fügen Sie in Antworten Links zu externen Websites ein, wenn die Antwort von Daten abhängt, die sich häufig ändern.
- Formulieren Sie die Antworten mit Bedacht. Sie können die Reaktion einer Person auf Ihr System ändern, indem Sie Ihre Antwort anders formulieren. Durch eine kleine Änderung in einer einzigen Textzeile kann vermieden werden, dass viele Codezeilen eingefügt werden müssen, um eine komplexe programmgesteuerte Lösung zu implementieren.
Varianten hinzufügen
Wenn Ihre Benutzer häufig zu Ihrem Assistenten zurückkehren, könnte es sie langweilen, jedes Mal die gleichen Begrüßungen und Antworten zu sehen. Sie können Antwortvarianten hinzufügen, sodass Ihr Assistent auf dieselbe Anforderung auf unterschiedliche Weise antworten kann.
Sie können auswählen, ob die Antwortvarianten nacheinander oder ein einer Zufallsreihenfolge verwendet werden sollen. Standardmäßig werden Antworten turnusmäßig nacheinander verwendet, so als ob sie aus einer sortierten Liste ausgewählt würden.
So fügen Sie Antwortvarianten hinzu:
-
Klicken Sie in Assistant says auf das Symbol Antwortvarianten hinzufügen
.
-
Wählen Sie für Antwortvariationstyp aus, ob die Antwortvarianten sequenziell oder in zufälliger Reihenfolge rotiert werden sollen. Weitere Informationen finden Sie unter Sequenziell oder zufällig.
Antwortvarianten -
Fügen Sie jede Variante zu einem eigenen Feld hinzu. Beispiel:
Beispiele für Antwortvarianten Antwortnummer Variante Antwort 1 Wie kann ich Ihnen helfen? Antwort 2 Was kann ich heute für Sie tun? Antwort 3 Sag mir, womit ich helfen kann. Antwort 4 Kann ich Ihnen helfen? -
Klicken Sie anschließend auf Anwenden (Apply). Die Variationen werden als Block in Assistant sagt angezeigt. Sie können auf das Symbol Bearbeiten klicken, um die Varianten zu aktualisieren, oder auf das Symbol Löschen, um alle Varianten zu entfernen. Sie können auch mehrere Gruppen von Antwortvarianten zu einem Schritt hinzufügen.
Antwortvariationen im Assistenten sagt
Sequenziell oder zufällig
Für Antwortvariationstyp können Sie Sequenziell oder Zufallswert wählen.
Sequential gibt die erste Antwortvariante zurück, wenn die Aktion zum ersten Mal ausgelöst wird, die zweite Antwortvariante, wenn die Aktion zum zweiten Mal ausgelöst wird, und so weiter, in derselben Reihenfolge, in der Sie die Varianten eingegeben haben. Dies führt dazu, dass die Antworten in der folgenden Reihenfolge zurückgegeben werden, wenn der Knoten verarbeitet wird:
-
Beim ersten Mal:
How can I help you?
-
Beim zweiten Mal:
What can I do for you today?
-
Beim dritten Mal:
Tell me what I can help with.
-
Zum vierten Mal:
Can I help you?
Zufällig wählt die Variante aus, wenn die Aktion zum ersten Mal ausgelöst wird, und wählt beim nächsten Mal zufällig eine andere Variante aus, ohne dieselbe Variante nacheinander zu wiederholen. Dieses Beispiel zeigt eine Reihenfolge, in der Antworten angezeigt werden können:
-
Beim ersten Mal:
Tell me what I can help with.
-
Beim zweiten Mal:
Can I help you?
-
Beim dritten Mal:
How can I help you?
-
Zum vierten Mal:
What can I do for you today?
Medienantworten
Neben Textantworten können Sie auch andere Antworttypen verwenden, um Antworten zu senden, die Multimedia- oder interaktive Elemente enthalten.
Der Aktionseditor unterstützt die folgenden Medienantworttypen:
- Bild: Integriert ein Bild in die Antwort. Die Quellenbilddatei muss an beliebiger Stelle gehostet werden und über eine URL verfügen, über die sie von Ihnen referenziert werden kann. Die Datei muss in einem Verzeichnis gespeichert sein, das öffentlich zugänglich ist.
- Video: Integriert einen Videoplayer in die Antwort. Das Quellenvideo muss irgendwo gehostet werden, entweder als abspielbares Video in einem unterstützten Video-Streaming-Service oder als Videodatei mit einer URL, über die Sie darauf verweisen können. Die Datei muss in einem Verzeichnis gespeichert sein, das öffentlich zugänglich ist.
- Audio: Bettet einen Audioclip in die Antwort ein. Die Audioquellendatei muss irgendwo gehostet sein und über eine URL verfügen, mit der Sie auf sie verweisen können. Die Datei muss in einem Verzeichnis gespeichert sein, das öffentlich zugänglich ist.
- iFrame: Integriert Inhalte von einer externen Website, wie z. B. ein Formular oder eine andere interaktive Komponente, direkt im Chat. Der Quelleninhalt muss über HTTP öffentlich zugänglich sein und als HTML-
iframe
-Element integrierbar sein.
Verschiedene Kanalintegrationen haben unterschiedliche Möglichkeiten, Medienreaktionen anzuzeigen. Informationen dazu, welche Kanalintegrationen welche Antworttypen unterstützen, finden Sie unter Kanalintegrationsunterstützung für Antworttypen.
Wenn Sie unterschiedliche Antworten definieren möchten, die auf verschiedene Kanäle zugeschnitten sind, können Sie dies tun, indem Sie die Antwort mit dem JSON-Editor bearbeiten. Weitere Informationen finden Sie unter Zielgruppenspezifische Integrationen.
Wenn Sie Ihre Antworten im JSON-Editor bearbeiten, können Sie auch auf weitere Antworttypen für die Handhabung kanalspezifischer Interaktionen zugreifen.
Weitere Informationen zum Bearbeiten von Antworten mithilfe des JSON-Editors finden Sie unter "Antworten mithilfe des JSON-Editors definieren ".
Hinzufügen einer Bildantwort
Fügen Sie eine Antwort Bild hinzu, um dem Kunden ein Bild anzuzeigen.
Der Antworttyp Bild wird von den folgenden Kanalintegrationen unterstützt:
- Web-Chat
- SMS
- Slack
- Microsoft Teams
Um eine Bildantwort hinzuzufügen, führen Sie die folgenden Schritte aus:
-
Klicken Sie im Feld Assistent sagt auf das Symbol
Bild.
-
Geben Sie in das Feld " Quelle URL " die vollständige URL zum gehosteten Bild ein.
Das Bild muss im Format
JPEG
,GIF
oderPNG
vorliegen. Die Bilddatei muss an einem Ort gespeichert werden, der öffentlich über einehttps:
URL (z. B.https://www.example.com/assets/common/logo.png
) zugänglich ist.Für den Zugriff auf ein Bild, das in IBM Cloud® Object Storage gespeichert ist, aktivieren Sie den öffentlichen Zugriff auf das einzelne Bildspeicherobjekt und referenzieren Sie das Bild anschließend, indem Sie die Bildquelle mit einer Syntax wie der folgenden angeben:
https://s3.eu.cloud-object-storage.appdomain.cloud/your-bucket-name/image-name.png
. -
Geben Sie optional einen Bildtitel, eine Beschreibung und einen alternativen Text in den bereitgestellten Feldern ein. In der Web-Chat-Integration werden Titel und Beschreibung zusammen mit dem Bild angezeigt.
Verweise auf Variablen werden nicht unterstützt. Einige Integrationskanäle ignorieren Titel oder Beschreibungen.
-
Klicken Sie auf Anwenden.
Hinzufügen einer Audioantwort
Fügen Sie eine Audio-Antwort hinzu, um Spokenwort oder anderen hörbaren Inhalt einzuschließen. Im Web-Chat wird eine Audioantwort als eingebetteter Audioplayer wiedergegeben. Bei der Telefonintegration wird eine Audioantwort über das Telefon wiedergegeben.
Der Antworttyp Audio wird von den folgenden Kanalintegrationen unterstützt:
- Web-Chat
- Telefon
- SMS
- Slack
Um eine Audioantwort hinzuzufügen, führen Sie die folgenden Schritte aus:
-
Klicken Sie im Feld Assistent sagt auf das Symbol
Audio.
-
Geben Sie in das Feld " Quelle URL " die vollständige E-Mail-Adresse URL ein, um den gehosteten Audioclip abzurufen:
-
Um einen direkten Link zu einer Audiodatei zu erstellen, geben Sie die URL zu einer Datei in einem beliebigen Standardformat wie MP3 oder WAV an. Im Web-Chat wird der verknüpfte Audioclip als eingebetteter Audioplayer wiedergegeben.
-
Um einen Link zu einem Audioclip in einem unterstützten Audio-Hosting-Service zu erstellen, geben Sie die URL zum Audioclip an. Im Web-Chat wird der verknüpfte Audioclip mithilfe des einbettbaren Players für den Hosting-Dienst wiedergegeben.
Geben Sie URL an, die Sie verwenden würden, um in Ihrem Browser auf die Audiodatei zuzugreifen (z. B.
https://soundcloud.com/ibmresearch/fallen-star-amped
). Sie müssen URL nicht in eine einbettbare Form umwandeln; der Web-Chat erledigt dies automatisch.Sie können auf den folgenden Services gehostete Audiodaten einfügen:
-
-
Geben Sie optional einen Titel, eine Beschreibung und alternativen Text in den bereitgestellten Feldern an. Bei der Web-Chat-Integration werden Titel und Beschreibung zusammen mit dem Audioplayer angezeigt.
Verweise auf Variablen werden nicht unterstützt. Einige Integrationskanäle ignorieren Titel oder Beschreibungen.
Videoantwort hinzufügen
Fügen Sie eine Video-Antwort hinzu, um eine Demo, einen Werbeclip oder andere Videoinhalte anzuzeigen. Im Web-Chat wird eine Videoantwort als integrierter Videoplayer wiedergegeben.
Der Antworttyp Video wird von den folgenden Kanalintegrationen unterstützt:
- Web-Chat
- SMS
- Slack
Um eine Videoantwort hinzuzufügen, führen Sie die folgenden Schritte aus:
-
Klicken Sie im Feld Assistent sagt auf das Symbol
Video.
-
Geben Sie in das Feld " Quelle URL " die vollständige E-Mail-Adresse URL ein, um das gehostete Video zu öffnen:
-
Um einen direkten Link zu einer Videodatei herzustellen, geben Sie die URL zu einer Datei in einem beliebigen Standardformat wie MPEG oder AVI an. Im Web-Chat wird das verlinkte Video als eingebetteter Videoplayer angezeigt.
HLS (
.m3u8
) und DASH (MPD) Streaming-Videos werden nicht unterstützt. -
Um einen Link zu einem Video zu erstellen, das auf einem unterstützten Video-Hosting-Service gehostet wird, geben Sie die URL zu dem Video an. Im Web-Chat wird das verlinkte Video mithilfe des einbettbaren Players für den Hosting-Dienst gerendert.
Geben Sie URL an, die Sie verwenden würden, um das Video in Ihrem Browser anzuzeigen (z. B.
https://www.youtube.com/watch?v=52bpMKVigGU
). Sie müssen URL nicht in eine einbettbare Form umwandeln; der Web-Chat erledigt dies automatisch.Sie können Videos einbetten, die auf den folgenden Diensten gehostet werden:
- YouTube
- Vimeo
- Twitch
- Streaming-fähig
- Wistia
- Vidyard
-
-
Geben Sie optional einen Videotitel, eine Beschreibung und alternativen Text in den bereitgestellten Feldern an. In der Web-Chat-Integration werden Titel und Beschreibung zusammen mit dem Videoplayer angezeigt.
Verweise auf Variablen werden nicht unterstützt. Einige Integrationskanäle ignorieren Titel oder Beschreibungen.
-
Wenn Sie das Video auf eine bestimmte Anzeigegröße skalieren möchten, geben Sie eine Zahl im Feld Basishöhe an.
Hinzufügen einer If rame-Antwort
Fügen Sie eine iframe-Antwort hinzu, um Inhalte von einer anderen Website direkt im Chatfenster als HTML-Element iframe
einzubetten. Eine iFrame-Antwort ist nützlich, wenn Sie Kunden ermöglichen möchten, eine Interaktion
mit einem externen Service auszuführen, ohne den Chat zu verlassen. Sie können beispielsweise eine iframe-Antwort verwenden, um die folgenden Beispiele im Webchat anzuzeigen:
- Eine interaktive Karte auf Google Maps
- Eine Umfrage, die SurveyMonkey verwendet
- Ein Formular für Reservierungen über OpenTable
- Ein Planungsformular, das Calendly verwendet
Im Web-Chat gibt es zwei Möglichkeiten, den I-Frame einzubeziehen:
- Wie eine Vorschaukarte, die den eingebetteten Inhalt beschreibt. Kunden können auf diese Karte klicken, um den iFrame anzuzeigen und mit dem Inhalt zu interagieren.
- Inline, Bedeutung innerhalb des Dialogs. Diese Option eignet sich für kleinere I-Frame-Inhalte.
Der Antworttyp iframe wird von den folgenden Kanalintegrationen unterstützt:
- Web-Chat
Führen Sie die folgenden Schritte aus, um einen Antworttyp iFrame hinzuzufügen:
-
Klicken Sie im Feld Assistent sagt auf das Symbol I-Frame (
).
-
Fügen Sie die vollständige URL zum externen Inhalt im Feld iFrame-Quelle hinzu.
Die URL muss Inhalte angeben, die in ein HTML-Element
iframe
eingebettet werden können. Unterschiedliche Websites haben unterschiedliche Einschränkungen für das Einbetten von Inhalten und unterschiedliche Verfahren für die Generierung von einbettbaren URLs. Eine integrierbare URL kann als Wert des Attributssrc
des Elementsiframe
angegeben werden.Um beispielsweise eine interaktive Karte einzubetten, die Google verwendet, können Sie Google verwenden. Weitere Informationen finden Sie unter Übersicht über die Maps Embed-API. Andere Seiten haben unterschiedliche Prozesse für die Erstellung integrierbarer Inhalte.
Technische Details zur Verwendung von
Content-Security-Policy: frame-src
, die Ihnen die Berechtigung zum Einbetten des Website-Inhalts in Ihren Assistenten erteilen, finden Sie unter CSP: frame-src. -
Fügen Sie optional einen beschreibenden Titel im Feld Titel hinzu.
Im Web-Chat wird der von Ihnen hinzugefügte Titel auf der Vorschaukarte angezeigt. Der Kunde klickt auf die Vorschaukarte, um den externen Inhalt wiederzugeben.
Wenn Sie keinen Titel angeben, versucht der Web-Chat, Metadaten von der angegebenen URL abzurufen, und zeigt den Inhaltstitel gemäß der Angabe in der Quelle an.
Verweise auf Variablen werden nicht unterstützt.
-
Um den I-Frame im Ablauf der Konversation anzuzeigen, anstatt ihn als Vorschaukarte anzuzeigen, setzen Sie I-Frame inline anzeigen auf Ein. Sie können auch die Höhe des I-Frames festlegen. Der Standardwert ist 180 Pixel.
Technische Details: iframe
sandboxing
Inhalte, die vom Web-Chat in einen Iframe geladen werden, werden in einer Sandbox ausgeführt, d. h. es werden Berechtigungen eingeschränkt, um Sicherheitslücken zu reduzieren. Der Web-Chat verwendet das Attribut sandbox
des Elements iframe
, um nur die folgenden Berechtigungen zu erteilen:
Berechtigung | Beschreibung |
---|---|
allow-downloads |
Ermöglicht das Herunterladen von Dateien aus dem Netzwerk, wenn der Download vom Benutzer eingeleitet wird. |
allow-forms |
Ermöglicht das Abschicken von Formularen. |
allow-scripts |
Ermöglicht die Ausführung von Scripts, aber nicht das Öffnen von Popup-Fenstern. |
allow-same-origin |
Erlaubt dem Inhalt den Zugriff auf seinen eigenen Datenspeicher (z. B. Cookies) und ermöglicht einen eingeschränkten Zugriff auf JavaScript. |
Ein Skript, das in einem Sandbox-Iframe ausgeführt wird, kann keine Inhalte außerhalb des Iframes ändern, wenn die äußere Seite und der Iframe unterschiedliche Ursprünge haben. Seien Sie vorsichtig, wenn Sie eine I-Frame-Antwort
verwenden, um Inhalte einzubetten, die denselben Ursprung haben wie die Seite, auf der Ihr Web-Chat-Widget gehostet wird. In dieser Situation kann der eingebettete Inhalt die Sandbox besiegen und auf Inhalte außerhalb des Rahmens zugreifen.
Weitere Informationen zu dieser potenziellen Sicherheitslücke finden Sie in der sandbox
Dokumentation zum Attribut
.
Technische Details: iframe
Vorschaukarte
Der Antworttyp iframe
im Web-Chat zeigt die Vorschaukarte an, die ein Bild, einen Titel und eine Beschreibung der Webseite enthält, die der Benutzer im Web-Chat besucht.
Um ein Bild, einen Titel und eine Beschreibung auf der Vorschaukarte anzuzeigen, benötigt die Webseite die folgenden <meta>
-Tags innerhalb des <head>
-Tags:
<meta property="og:image" content="https://.../image.jpg" />
<meta property="og:image:url" content="https://.../image.jpg" />
<meta property="og:title" content="The webpage title" />
<meta property="og:description" content="The webpage description" />
Diese angegebenen Metadateneigenschaften stammen aus Open Graph Protocol.
Die Metadaten sind optional. Der Web-Chat zeigt eine Vorschaukarte mit der URL der Webseite und den Metadaten an, die der Web-Chat erfolgreich abgerufen hat.
Antwort anhalten
Verwenden Sie die Antwort Pause, damit der Assistent ein angegebenes Intervall wartet, bevor die nächste Antwort erfolgt. Diese Pause ermöglicht die Ausführung einer Anforderung oder verhält sich wie ein Live-Agent, der zwischen den
Antworten pausiert. Die Pause muss eine beliebige Dauer von 0
bis 60
Sekunden haben, die Dezimalstellen einer Sekunde enthalten kann, um die Pause bis zu milliseconds
zu konfigurieren.
Eine Pause-Antwort wird in der Regel in Kombination mit anderen Antworten verwendet. Standardmäßig wird während der Pause eine Tippindikatoranimation angezeigt, um einen Live-Agenten zu simulieren.
Der Antworttyp Pause wird von den folgenden Kanalintegrationen unterstützt:
- Web-Chat
Mit dem Telefonkanal können Sie eine Pause hinzufügen, indem Sie das SSML-Element break
in die Ausgabe des Assistenten einschließen. Weitere Informationen finden Sie in der Dokumentation zuText to Speech.
So fügen Sie eine Pause-Antwort hinzu:
-
Klicken Sie im Feld Assistent sagt auf das Symbol
Pause.
-
Geben Sie im Feld Dauer die Zeitdauer für die Pause in
seconds
ein.Die Dauer darf
60 seconds
nicht überschreiten. Außerdem können Sie die Dezimalstellen vonsecond
im Feld Dauer eingeben, um die Antwort bismilliseconds
anzuhalten. Wenn Sie beispielsweise10.50 seconds
eingeben, wird die Antwort für10500 milliseconds
angehalten. Kunden sind in der Regel bereit, etwa 8 Sekunden auf eine Antwort zu warten. -
Der Typanzeiger ist standardmäßig auf Ein gesetzt. Sie können diesen Wert bei Bedarf auf Aus setzen.
Fügen Sie nach der Pause einen weiteren Antworttyp (z. B. eine Textantwort) hinzu, um deutlich zu machen, dass die Wartezeit vorüber ist.