Steuerelement für Benutzereingaben in Karussell
Verwenden Sie das Steuerelement für Benutzereingaben in Karussell in einem Virtual Agent-Thema, um eine Eingabeaufforderung und eine horizontale Reihe von beschrifteten Bildern anzuzeigen. Der Benutzer kann ein einzelnes Element aus dem Karussell auswählen.
Eigenschaften der Karussell-Eingabesteuerung für LLM-Themenerkennung
| Eigenschaft | Beschreibung |
|---|---|
| Knotenname | Name, der diesen Steuerknoten für Karussell-Benutzereingaben im Themen-Flow identifiziert. |
| Variablenname | Name der Variablen, die die vom Benutzer getroffene Auswahl speichert. Der Variablenname wird automatisch aus der Eigenschaft Knotenname erstellt. |
| Detailbeschreibung | Beschreibung der Informationen, die Sie von Benutzern benötigen. |
| Karussellelemente definieren | Verwenden Sie ein Skript, um Elemente zur Auswahl in Ihrem Karussell zu erstellen. Das Skript sollte ein Array mit einem oder mehreren Elementen zurückgeben. Weitere Informationen finden Sie im Abschnitt „Beispiel eines Karussellelementausdrucks“ in diesem Thema. |
| Erweitert (optional) | |
| Benutzeraufforderung erzwingen | |
| Benutzeraufforderung erzwingen | Schalten Sie um, um das Feld Benutzeraufforderung zu öffnen. Der Wert im Feld Benutzeraufforderung wird Benutzern anstelle der vom LLM generierten Nachricht angezeigt. Sie können benutzerdefinierte Nachrichten im Klartext oder in Skripts erstellen oder Bedingungen mit der Datenpillenauswahl definieren. |
| Diesen Knoten ausblenden | |
| Diesen Knoten bedingt anzeigen, wenn |
Codefreie Bedingungsanweisung oder Low-Code-Skript, die eine Bedingung für die Darstellung dieses Knotens in der Konversation angibt. Die Bedingung muss als true bewertet werden. Dieses Feld ist nicht anwendbar, wenn der Karussellknoten innerhalb des Eingabesammlerknotens verwendet wird. |
Beispiel für die Karussell-Eingabesteuerung für die LLM-Themenerkennung
| Karussell-Eigenschaften | Eingabeaufforderung für Karussell |
|---|---|
|
|
|
Eigenschaften der Karussell-Eingabesteuerung für NLU-Themenerkennung
| Eigenschaft | Beschreibung |
|---|---|
| Knotenname | Name, der diesen Steuerknoten für Karussell-Benutzereingaben im Themen-Flow identifiziert. |
| Variablenname | Name der Variablen, die die vom Benutzer getroffene Auswahl speichert. Der Variablenname wird automatisch aus der Eigenschaft Knotenname erstellt. |
| Aufforderung | Eingabeaufforderung oder Frage an den Benutzer. Die Eingabeaufforderung kann entweder eine Textzeichenfolge oder ein Skript sein, das Text zurückgibt. Dieser Wert wird nur verwendet, wenn der Standardwert nicht angegeben ist. Beispiel: Wie heißt Sie? |
| NLU-Entität | Option zum Zuordnen einer NLU-Entität zum Knoten. Wenn der Eingabevariablen für diesen Knoten eine NLU-Entität zugeordnet ist, kann Virtual Agent den angegebenen Wert basierend auf der Äußerung des Benutzers ausfüllen. Wählen Sie eine Entität aus der Liste der Entitäten aus, die der Themenabsicht zugeordnet sind. Wenn Sie eine Entität für den Knoten angeben, wird der Umschalter Benutzer nicht bitten, die erkannte Entität zu bestätigen angezeigt. Wenn diese Option aktiviert ist, werden Benutzer nicht aufgefordert, die extrahierte Entität zu bestätigen. Dieses Feld ist nur verfügbar, wenn die NLU Erkennung für die Instanz aktiviert ist. |
| Karussellelemente definieren | Verwenden Sie ein Skript, um Elemente zur Auswahl in Ihrem Karussell zu erstellen. Das Skript sollte ein Array mit einem oder mehreren Elementen zurückgeben. Weitere Informationen finden Sie im Abschnitt „Beispiel eines Karussellelementausdrucks“ in diesem Thema. |
| Antwortnachricht ohne Datensätze | Nachricht an den Benutzer, die angibt, dass keine Datensätze gefunden wurden. Die Nachricht kann entweder eine Textzeichenfolge oder ein Skript sein, das Text zurückgibt. |
| Erweitert | |
| Standardwert | |
| Standardwert | Vordefinierter Wert für die Benutzerantwort auf die Frage oder Eingabeaufforderung. Die im Feld Standardwertbestätigung definierte Antwort fordert den Benutzer auf, den Standardwert zu bestätigen. Wenn der Benutzer mit „ nein“ antwortet, wird der Wert null. Der Standardwert kann entweder eine Textzeichenfolge oder ein Skript sein, das Text zurückgibt. Wenn Sie beispielsweise Dot-Walking verwenden, lautet der Standardwert möglicherweise: Skriptvariablen > Letzter Benutzername. Wenn Sie ein Skript verwenden, lautet der Standardwert möglicherweise: {{vaScripts.lastUsername}}. |
| Bestätigungsnachrichten | |
| Bestätigung des Eingabeabschlusses | Bot-Antwort, die dem Benutzer angezeigt wird, wenn die Knoteninteraktion abgeschlossen ist. Die Nachricht kann entweder eine Textzeichenfolge oder ein Skript sein, das Text zurückgibt. Wenn Sie beispielsweise Dot-Walking verwenden: Danke, (Eingabevariablen > Benutzername)! Oder wenn Sie ein Skript verwenden, könnte die Bestätigung wie folgt lauten: Danke, {{vaInputs.username}}!. |
| Standardwertbestätigung | Nachricht, die den Benutzer auffordert, zu überprüfen, ob der Wert im Feld „ Standardwert “ korrekt ist. Diese Nachricht wird anstelle eines Werts im Feld Eingabeaufforderung verwendet. Er kann entweder eine Textzeichenfolge oder ein Skript enthalten, das Text zurückgibt. Wenn Sie beispielsweise Dot-Walking verwenden: Sind Sie (Eingabevariablen > Benutzername)? Oder wenn Sie ein Skript verwenden, lautet die Bestätigungsmeldung möglicherweise: Sind Sie {{vaScripts.lastUsername}}?. |
| Konversationswechsel | |
| Dieser Abschnitt ist nur verfügbar, wenn die NLU-Erkennung für die Instanz aktiviert ist. | |
| Aktivieren, damit Benutzer den Betreff ändern können | Option zum Aktivieren der NLU-Vorhersage für diesen Knoten. Wenn diese Option aktiviert ist, können Benutzer Text eingeben, um Fragen zu beantworten, unabhängig von der Art der verwendeten Eingabesteuerung. Virtual Agent verwendet diese Äußerung, um eine andere vorhandene Absicht abzugleichen, sodass der Benutzer das Thema wechseln kann. |
| Diesen Knoten ausblenden oder überspringen | |
| Diesen Knoten bedingt anzeigen, wenn | Codefreie Bedingungsanweisung oder Low-Code-Skript, die eine Bedingung für die Darstellung dieses Knotens in der Konversation angibt. Die Bedingung muss als true bewertet werden. |
| Zulassen, dass Benutzer diesen Knoten überspringen, wenn | Codefreie Bedingungsanweisung oder Low-Code-Skript, die eine Bedingung dafür angibt, dass Benutzer diesen Knoten in der Konversation überspringen können. |
Beispiel für die Karussell-Eingabesteuerung für die NLU-Themenerkennung
| Karussell-Eigenschaften | Eingabeaufforderung für Karussell |
|---|---|
Beispiel für den Ausdruck von Karussellelementen
(function execute() {
var options = [];
options.push(
{
'Name': 'Item 1',
'Value': 'item_1',
'Description': 'Acme keyboard model 200',
'Body': 'https://images.pexels.com/photos/688666/pexels-photo-688666.jpeg'
}
);
options.push(
{
'Name': 'Item 2',
'Value': 'item_2',
'Description': 'Acme keyboard model 300',
'Body': 'https://images.pexels.com/photos/916472/pexels-photo-916472.jpeg'
}
);
return options;
})()
Das Skript in der Eigenschaft „ Karussellelementausdruck “ definiert ein Array mit den Elementen, die in Ihrem Karussell angezeigt werden, und gibt es zurück. Die Elemente dieses Arrays müssen Schlüssel für einen Namen, einen Wert und einen Hauptteil enthalten. In diesem Beispiel erstellt das Skript ein Array namens options und fügt zwei Elemente mit jeweils den erforderlichen Schlüsseln hinzu. Die Bilder hier sind als Beispiel fest programmiert.
| Schlüssel | Beschreibung |
|---|---|
| Name | Name des Karussellelements. Dieser Name wird unterhalb des Bildes auf dem Karussell angezeigt. |
| Wert | Wert für das Element. Wenn ein Benutzer ein Karussellelement auswählt, wird dieser Wert in der Variablen gespeichert, die in der Eigenschaft Variablenname benannt wird. |
| Beschreibung | Textzeichenfolge, die das Karussellelement beschreibt. Die Beschreibung wird unter dem Bildnamen angezeigt. Ein Karussell mit mehr als drei Elementen zeigt Links- und Rechtspfeile zum Scrollen durch die Bilder und eine Auswahlschaltfläche unter jedem Element an. Wenn eine Beschreibung mehr als 140 Zeichen enthält, können Benutzer den Inhalt erweitern. |
| Textkörper | Im Karussellelement verwendetes Bild. Der Wert ist eine URL für eine Bilddatei. |
Kanalunterstützung
| Kanal | Support | Einschränkungen |
|---|---|---|
| Web-Benutzerschnittstelle | Unterstützt | Keine |
| Mobile Anwenderoberfläche | Unterstützt | Keine |
| Now Assist-Bereich |
Unterstützt |
Keine |
| Microsoft Teams | Unterstützt | Keine. Wenn das Karussell mehr als 10 Elemente enthält, müssen Benutzer Weiter wählen, um die verbleibenden Elemente zu überprüfen. |
| Slack | Unterstützt | Keine |
| Workplace | Unterstützt | Keine |
| Facebook Messenger | Unterstützt | Der Titel für ein Bild darf maximal 40 Zeichen lang sein. Der Text für das Bild darf maximal 60 Zeichen lang sein. Ein Benutzer kann nur 10 Bilder gleichzeitig anzeigen. Wenn mehr als 10 Bilder vorhanden sind, wird das Paginierungsformat verwendet, um weitere Optionen anzuzeigen. Der Standardwert der maximalen Anzahl von Bildern in einem Karussell für eine Seite wird in der Systemeigenschaft sn_va_fb_messenger.max_carousel_cards festgelegt. Diese Eigenschaft befindet sich in der Tabelle „Systemeigenschaften“ [sys_properties]. |
| SMS Twilio | Nicht unterstützt | Nicht zutreffend |
| LINE | Unterstützt | Der Titel für ein Bild darf maximal 40 Zeichen lang sein. Der Text für das Bild darf maximal 60 Zeichen lang sein. Ein Benutzer kann nur 10 Bilder gleichzeitig anzeigen. Wenn mehr als 10 Bilder vorhanden sind, wird das Paginierungsformat verwendet, um weitere Optionen anzuzeigen. Der Standardwert der maximalen Anzahl von Bildern im Karussell für eine Seite wird in der Systemeigenschaft sn_va_line.max.carousel.cards festgelegt. Die Eigenschaft befindet sich in der Tabelle „Systemeigenschaften“ [sys_properties]. |
| Unterstützt | Keine | |
| Apple Messages for Business | Unterstützt | Keine |
| Alexa (Sprache) | Unterstützt | Verwenden Sie für Bildschirmgeräte den Touch-Bildlauf. Verwenden Sie für Geräte ohne Bildschirm die Sprachpaginierung. |