Benutzereingabesteuerung für dynamische Auswahl
Verwenden Sie die Benutzereingabesteuerung „Dynamische Auswahl“ in einem Virtual Agent -Thema, um dynamisch eine Liste der verfügbaren Auswahlmöglichkeiten für Ihre Benutzer zu erstellen. Erstellen Sie diese Auswahloptionen, indem Sie eine Tabelle abfragen oder indem Sie sie mit einem Skript dynamisch erstellen.
Anzeige der Auswahlliste
Die dynamische Auswahlliste enthält bis zu 10 Elemente pro Seite. Wenn mehr als 10 Elemente vorhanden sind, können Sie die zusätzlichen Elemente anzeigen und die Suchergebnisse filtern. Die Auswahllisten-Eingabeaufforderung enthält ein Suchsymbol , die Benutzer zum Filtern der Ergebnisse auswählen können.
Wenn die Auswahl mehrerer Auswahlmöglichkeiten aktiviert ist, können Sie im Feld Suche nach Optionen suchen, um Suchergebnisse zu filtern. Wählen Sie alle zutreffenden Auswahlmöglichkeiten aus, oder geben Sie sie ein, und wählen Sie dann das Senden-Symbol . Wenn Sie Ihre Auswahlmöglichkeiten über ein LLM-Thema senden, antwortet das LLM mit der Frage, ob Ihre Auswahlmöglichkeiten die Validierungskriterien erfüllen.
Sie können eine Auswahlmöglichkeit oder Auswahlmöglichkeiten auch aus einer Liste in einer LLM-Konversation auswählen, indem Sie im Chatfenster eine Äußerung eingeben. Wenn es keine Übereinstimmung für Ihre Eingabe gibt, informiert Sie Virtual Agent darüber, dass es sich nicht um eine gültige Auswahl handelt, und fordert Sie auf, eine andere Eingabe zu versuchen.
-
Die Headerkarte kann ein großes oder kleines Bild oder eine YouTube-Videokarte zusammen mit beschreibendem Text enthalten. Die Auswahlliste enthält standardmäßig bis zu fünf Elemente, die Suchfunktion ist jedoch unterdrückt. Wenn mehr als fünf Elemente vorhanden sind, können Anwender die zusätzlichen Elemente anzeigen.
-
Um die Anzahl der Elemente zu steuern, die unter einer Headerkarte angezeigt werden, fügen Sie die Systemeigenschaft com.glide.cs.web_header_picker_page_limit hinzu. Geben Sie mit dem Wert die Anzahl der Elemente in der Auswahlliste an. Einzelheiten zum Erstellen einer Systemeigenschaft finden Sie unter Systemeigenschaft hinzufügen.
Wenn Sie einen Knoten einer dynamischen Auswahlliste mit nur einer Auswahlmöglichkeit ausfüllen, erhalten Sie beim Testen oder Verwenden des Knotens die Meldung „Wir haben [Auswahl] als [Knotenname], ist dies richtig?“. Verwenden Sie mehrere Auswahlmöglichkeiten im Knoten der dynamischen Auswahlliste, um den Empfang dieser Nachricht zu vermeiden.
Sie können auch den Nachrichteninhalt ändern, indem Sie zu navigieren und Bearbeiten der Systemeigenschaft glide.cs.retry_question_message. Dieser Nachrichtenwert ist standardmäßig eine Zeichenfolge . Wir haben {0} als {1}, ist das richtig? und wird für die Slot-Füllung in mehreren Fällen außerhalb der dynamischen Auswahlliste verwendet. Alle von Ihnen vorgenommenen Änderungen spiegeln sich in jeder Verwendung dieser Eigenschaft wider.
Dynamische Auswahl der Anwendereingabe-Steuerungseigenschaften für die LLM-Themen-Discovery
| Eigenschaft | Beschreibung |
|---|---|
| Knotenname |
Name, der diesen Knoten im Themen-Flow identifiziert. |
| Variablenname |
Name der Variablen, die die Benutzerantwort für diese Eingabeaufforderung speichert. Der Variablenname wird automatisch aus der Eigenschaft „Knotenname“ erstellt. |
| Aufforderung |
Aufforderung oder Frage für den Anwender. 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? Sie können Rich-Text erstellen, um den Stil der Eingabeaufforderung zu ändern:
|
| NLU-Entität |
Option zum Zuordnen einer NLU -Entität zum Knoten. Wenn eine Entität NLU der Eingabevariablen für diesen Knoten zugeordnet ist, kann Virtual Agent den angegebenen Wert basierend auf der Äußerung des Anwenders 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 Discovery NLU für die -Instanz aktiviert ist. |
| Auswahlmöglichkeiten | |
| Auswahlmöglichkeiten ausfüllen nach |
Typ der zu verwendenden dynamischen Variablen. Wählen Sie eine der folgenden Optionen aus:
|
| Tabelle |
Zu durchsuchende Tabelle; nur verfügbar, wenn Sie Datensatz als Methode zum Ausfüllen von Auswahlmöglichkeiten ausgewählt haben. |
| Auswahlmöglichkeiten filtern |
Option zur Verwendung des Bedingungsgenerators Virtual Agent-Designer oder zum Bereitstellen eines Skripts. Wählen Sie eine der folgenden Optionen aus:
|
| Ermöglichen Sie dem Anwender, mehr als eine Auswahl zu treffen |
Option, mit der Anwender mehrere Auswahlmöglichkeiten aus der Auswahlliste auswählen können. |
| Antwortnachricht ohne Datensätze |
Meldung, die dem Anwender angezeigt wird, wenn die Tabellensuche keine Datensätze zurückgibt. Die Nachricht kann entweder eine Textzeichenfolge oder ein Skript sein, das Text zurückgibt. |
| Erweitert | |
| Header-Karte |
Umschalten, um ein Feld zum Hinzufügen von Karten zu öffnen, das Bilder oder YouTube-Videos enthalten kann. Weitere Informationen finden Sie unter Fügen Sie eine Headerkarte in ein Steuerelement für statische Auswahl oder dynamische Auswahl ein |
| Standardwert | |
| Standardwert |
Vordefinierter Wert für die Benutzerantwort auf die Frage oder Eingabeaufforderung. Die im Bestätigungsfeld Standardwert 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 Anwendername. Oder wenn Sie ein Skript verwenden, könnte der Standardwert wie folgt lauten: {{vaScripts.lastUsername}}. |
| Bestätigungsnachrichten | |
| Bestätigung des Eingabeabschlusses |
Bot-Antwort, die dem Anwender angezeigt wird, wenn die Knoteninteraktion abgeschlossen ist. Die Nachricht kann entweder eine Textzeichenfolge oder ein Skript sein, das Text zurückgibt. Beispiel, wenn Sie Dot-Walking verwenden: Vielen Dank, (Eingabevariablen > Anwendername)! Oder wenn Sie ein Skript verwenden, könnte die Bestätigung wie folgt lauten: Vielen Dank, {{vaInputs.username}}! |
| Standardwertbestätigung |
Nachricht, in der der Benutzer aufgefordert wird, zu überprüfen, ob der Wert im Feld „Standardwert“ korrekt ist. Diese Nachricht wird anstelle eines Werts im Feld „Eingabeaufforderung“ verwendet. Sie kann entweder eine Textzeichenfolge oder ein Skript enthalten, das Text zurückgibt. Beispiel, wenn Sie Dot-Walking verwenden: Sind Sie (Eingabevariablen > Anwendername)? Oder wenn Sie ein Skript verwenden, könnte die Bestätigungsmeldung wie folgt lauten: Sind Sie {{vaScripts.lastUsername}}?. |
| Konversationswechsel | |
| Dieser Abschnitt ist nur verfügbar, wenn die Discovery NLU für die -Instanz aktiviert ist. | |
| Aktivieren, damit Anwender den Betreff ändern können |
Option zum Aktivieren NLU der -Vorhersage für diesen Knoten. Wenn diese Option aktiviert ist, können Benutzer Text eingeben, um Fragen zu beantworten, unabhängig vom Typ des verwendeten Eingabesteuerelements. Virtual Agent verwendet diese Äußerung, um sie mit einer anderen vorhandenen Absicht abzugleichen, sodass der Anwender das Thema wechseln kann. |
| Diesen Knoten ausblenden oder überspringen | |
| Diesen Knoten bedingt anzeigen, wenn |
No-Code-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 der Anwender diesen Knoten überspringt, wenn |
No-Code-Bedingungsanweisung oder Low-Code-Skript, die eine Bedingung angibt, unter der Anwender diesen Knoten in der Konversation überspringen können. Die Bedingung muss als true bewertet werden. Sie können dieses Feld entweder mit dem Bedingungsgenerator oder einem Skript festlegen. |
| Erneute Aufforderung überspringen, wenn | No-Code-Bedingungsanweisung oder Low-Code-Skript, die eine Bedingung angibt, unter der Anwender die erneute Aufforderung in der Konversation überspringen können. Wenn ein vorheriger Knoten über ein Themen-Loopback oder eine Dialoghandlung erneut aufgerufen wird, umgeht Virtual Agent diesen Knoten und behält automatisch seinen ursprünglichen Wert bei. |
Beispiel für ein Anwendereingabesteuerelement für die dynamische Auswahl für die LLM-Themen-Discovery
| Eingabeeigenschaften | Anwenderaufforderung auflisten |
|---|---|
|
|
Die Auswahlliste zeigt 10 Elemente pro Seite an. Wenn 10 oder mehr Ergebnisse zurückgegeben werden:
|
Dynamische Auswahl der Eigenschaften von Anwendereingabesteuerungen für die NLU-Themen-Discovery
| Eigenschaft | Beschreibung |
|---|---|
| Knotenname |
Name, der diesen Knoten im Themen-Flow identifiziert. |
| Variablenname |
Name der Variablen, die die Benutzerantwort für diese Eingabeaufforderung speichert. Der Variablenname wird automatisch aus der Eigenschaft „Knotenname“ erstellt. |
| Aufforderung |
Aufforderung oder Frage für den Anwender. 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? Sie können Rich-Text erstellen, um den Stil der Eingabeaufforderung zu ändern:
|
| NLU-Entität |
Option zum Zuordnen einer NLU -Entität zum Knoten. Wenn eine Entität NLU der Eingabevariablen für diesen Knoten zugeordnet ist, kann Virtual Agent den angegebenen Wert basierend auf der Äußerung des Anwenders 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 Discovery NLU für die -Instanz aktiviert ist. |
| Auswahlmöglichkeiten | |
| Auswahlmöglichkeiten ausfüllen nach |
Typ der zu verwendenden dynamischen Variablen. Wählen Sie eine der folgenden Optionen aus:
|
| Tabelle |
Zu durchsuchende Tabelle; nur verfügbar, wenn Sie Datensatz als Methode zum Ausfüllen von Auswahlmöglichkeiten ausgewählt haben. |
| Auswahlmöglichkeiten filtern |
Option zur Verwendung des Bedingungsgenerators Virtual Agent-Designer oder zum Bereitstellen eines Skripts. Wählen Sie eine der folgenden Optionen aus:
|
| Ermöglichen Sie dem Anwender, mehr als eine Auswahl zu treffen |
Option, mit der Anwender mehrere Auswahlmöglichkeiten aus der Auswahlliste auswählen können. |
| Antwortnachricht ohne Datensätze |
Meldung, die dem Anwender angezeigt wird, wenn die Tabellensuche keine Datensätze zurückgibt. Die Nachricht kann entweder eine Textzeichenfolge oder ein Skript sein, das Text zurückgibt. |
| Erweitert | |
| Header-Karte |
Umschalten, um ein Feld zum Hinzufügen von Karten zu öffnen, das Bilder oder YouTube-Videos enthalten kann. Weitere Informationen finden Sie unter Fügen Sie eine Headerkarte in ein Steuerelement für statische Auswahl oder dynamische Auswahl ein |
| Standardwert | |
| Standardwert |
Vordefinierter Wert für die Benutzerantwort auf die Frage oder Eingabeaufforderung. Die im Bestätigungsfeld Standardwert 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 Anwendername. Oder wenn Sie ein Skript verwenden, könnte der Standardwert wie folgt lauten: {{vaScripts.lastUsername}}. |
| Bestätigungsnachrichten | |
| Bestätigung des Eingabeabschlusses |
Bot-Antwort, die dem Anwender angezeigt wird, wenn die Knoteninteraktion abgeschlossen ist. Die Nachricht kann entweder eine Textzeichenfolge oder ein Skript sein, das Text zurückgibt. Beispiel, wenn Sie Dot-Walking verwenden: Vielen Dank, (Eingabevariablen > Anwendername)! Oder wenn Sie ein Skript verwenden, könnte die Bestätigung wie folgt lauten: Vielen Dank, {{vaInputs.username}}! |
| Standardwertbestätigung |
Nachricht, in der der Benutzer aufgefordert wird, zu überprüfen, ob der Wert im Feld „Standardwert“ korrekt ist. Diese Nachricht wird anstelle eines Werts im Feld „Eingabeaufforderung“ verwendet. Sie kann entweder eine Textzeichenfolge oder ein Skript enthalten, das Text zurückgibt. Beispiel, wenn Sie Dot-Walking verwenden: Sind Sie (Eingabevariablen > Anwendername)? Oder wenn Sie ein Skript verwenden, könnte die Bestätigungsmeldung wie folgt lauten: Sind Sie {{vaScripts.lastUsername}}?. |
| Konversationswechsel | |
| Dieser Abschnitt ist nur verfügbar, wenn die Discovery NLU für die -Instanz aktiviert ist. | |
| Aktivieren, damit Anwender den Betreff ändern können |
Option zum Aktivieren NLU der -Vorhersage für diesen Knoten. Wenn diese Option aktiviert ist, können Benutzer Text eingeben, um Fragen zu beantworten, unabhängig vom Typ des verwendeten Eingabesteuerelements. Virtual Agent verwendet diese Äußerung, um sie mit einer anderen vorhandenen Absicht abzugleichen, sodass der Anwender das Thema wechseln kann. |
| Diesen Knoten ausblenden oder überspringen | |
| Diesen Knoten bedingt anzeigen, wenn |
No-Code-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 der Anwender diesen Knoten überspringt, wenn |
No-Code-Bedingungsanweisung oder Low-Code-Skript, die eine Bedingung angibt, unter der Anwender diesen Knoten in der Konversation überspringen können. Die Bedingung muss als true bewertet werden. Sie können dieses Feld entweder mit dem Bedingungsgenerator oder einem Skript festlegen. |
| Erneute Aufforderung überspringen, wenn | No-Code-Bedingungsanweisung oder Low-Code-Skript, die eine Bedingung angibt, unter der Anwender die erneute Aufforderung in der Konversation überspringen können. Wenn ein vorheriger Knoten über ein Themen-Loopback oder eine Dialoghandlung erneut aufgerufen wird, umgeht Virtual Agent diesen Knoten und behält automatisch seinen ursprünglichen Wert bei. |
Beispiel für ein Anwendereingabesteuerelement für die dynamische Auswahl für die NLU-Themen-Discovery
| Eingabeeigenschaften | Eingabeaufforderung für Liste |
|---|---|
Die Auswahlliste zeigt 10 Elemente pro Seite an. Wenn 10 oder mehr Ergebnisse zurückgegeben werden:
|
|
Die Auswahlliste enthält fünf Elemente pro Seite. Wenn mindestens fünf Ergebnisse zurückgegeben werden, bietet die Liste die Option zum Anzeigen weiterer Ergebnisse. Hinweis: Die Suchfunktion wird unterdrückt, wenn eine Headerkarte verwendet wird. |
Skriptbeispiele für dynamische Auswahl
(function execute() {
var pagingUtil = new global.VirtualAgentChoicePagingUtil(null, "sys_user", 10, "user_name,name",
"active=true", null, vaVars);
var selectedOptions = pagingUtil.getSavedSelectedOptions("user", vaSystem);
if (!selectedOptions || selectedOptions.length == 0) {
// Secondary labels can be passed to selected options
selectedOptions.push({ "value": "abel.tuter", "label": "Abel Tuter"
,"secondary_label": ["abel.tuter@example.com", "male"]
});
selectedOptions.push({ "value": "Beth.anglin", "label": "Beth Anglin"
,"secondary_label": ["beth.anglin@example.com", "female"]
});
}
vaSystem.setSelectedOptions(selectedOptions, "user", false);
// Topic authors have the ability to define which values should go in the
// secondary labels by adding secondary label functions
pagingUtil.addSecondaryLabelFunction(function (gr) {
return gr.getValue("email");
});
pagingUtil.addSecondaryLabelFunction(function (gr) {
return gr.getValue("gender");
});
var gr = pagingUtil.getPagingGlideRecordSecure("name", false);
var options = pagingUtil.getSecureOptions(gr, null,'user_name', ['user_name']);
return options;
})()Beispiel für den Wertausdruck einer dynamischen Auswahlliste
(function execute(table) {
var options = [];
var gr = new GlideRecordSecure(table);
gr.addEncodedQuery('active=true');
gr.setLimit(5);
gr.query();
while(gr.next()) {
options.push({ 'value': gr.getUniqueValue(), 'label': gr.getValue('short_description') });
}
return options;
})(table)
Das Skript in der Eigenschaft Ausdruck des Wahlwerts definiert ein Array von Auswahlmöglichkeiten und gibt es zurück. Im Beispiel erstellt das Skript das Array options und fügt diesem Array alle durch eine GlideRecord-Abfrage gefundenen Datensätze hinzu. Jedes Element im Array erhält einen Wert in den Schlüsseln Wert und Bezeichnung mit Daten aus diesem GlideRecord. Die Eigenschaft Tabelle der Steuerungen definiert die vom Skript verwendete Tabelle. Dieses Beispielskript verwendet gr.setLimit(5), um die Anzahl der zurückgegebenen Datensätze auf 5 zu begrenzen. Mit dieser Methode wird verhindert, dass zurückgegebene Datensätze eine zu große Auswahlliste erstellen.
| Key | Beschreibung |
|---|---|
| Wert | Der Wert für die Auswahl. Wenn ein Benutzer eine Auswahl aus dem Steuerelement auswählt, wird dieser Wert in der Variablen gespeichert, die in der Eigenschaft Variablenname benannt wird. |
| Bezeichnung | Die Bezeichnung, die für diese Auswahl in der Auswahlliste angezeigt wird. |
Kanalunterstützung
| Kanal | LLM-Unterstützung | NLU-/Stichwort-Unterstützung | Einschränkungen |
|---|---|---|---|
| Web-Benutzerschnittstelle | Nicht unterstützt | Unterstützt | Keine |
| Mobile Anwenderoberfläche | Nicht unterstützt | Unterstützt | Keine |
| Now Assist-Bereich | Nicht unterstützt | Unterstützt | Keine |
| Microsoft Teams | Unterstützt | Unterstützt | Keine |
| Slack | Nicht unterstützt | Unterstützt | Headerkarten werden nicht unterstützt. |
| Workplace | Nicht unterstützt | Unterstützt | Headerkarten werden nicht unterstützt. |
| Facebook Messenger | Nicht unterstützt | Nicht unterstützt | Nicht zutreffend |
| SMS Twilio | Nicht unterstützt | Unterstützt | Headerkarten werden nicht unterstützt. |
| LINE | Nicht unterstützt | Nicht unterstützt | Nicht zutreffend |
| Unterstützt | Unterstützt | Keine | |
| Apple Messages for Business | Nicht unterstützt | Unterstützt | Keine |
| Alexa (Sprache) | Nicht unterstützt | Unterstützt | Verwenden Sie für Bildschirmgeräte Touch-Scrollen. Klicken auf Links wird nicht unterstützt. Verwenden Sie für Geräte ohne Bildschirm die Sprachpaginierung. |