Dynamische Auswahl – Anwendereingabesteuerung
Verwenden Sie die Anwendereingabesteuerung für dynamische Auswahl in einem Virtual Agent Thema zum dynamischen Erstellen einer Liste der verfügbaren Auswahlmöglichkeiten für Ihre Anwender. 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 in einer NLU-Konversation mehr als 10 Elemente vorhanden sind, haben Sie die Möglichkeit, die zusätzlichen Elemente anzuzeigen und auch die Suchergebnisse zu filtern. Die Auswahllistenaufforderung enthält ein Suchsymbol Die Anwender auswählen können, um die Ergebnisse zu filtern. Wenn in einer LLM-Konversation mehr als 10 Elemente vorhanden sind, wird eine Bildlaufleiste angezeigt. Wenn in einer LLM-Konversation mehr als 16 Elemente vorhanden sind, wird eine Suchleiste angezeigt.
Wenn die Auswahl mehrerer Auswahlmöglichkeiten aktiviert ist, können Sie innerhalb von suchen Suchen Sie nach Optionen Feld zum Filtern von Suchergebnissen. Wählen Sie alle zutreffenden Auswahlmöglichkeiten aus, oder geben Sie sie ein, und wählen Sie dann das Sendesymbol . Wenn Sie Ihre Auswahlmöglichkeiten über ein LLM-Thema senden, antwortet das LLM mit, ob Ihre Auswahlmöglichkeiten die Validierungskriterien erfüllen.
Sie können auch eine oder mehrere Auswahlmöglichkeiten aus einer Liste in einer LLM-Konversation auswählen, indem Sie eine Äußerung in das Chatfenster eingeben. Wenn keine Übereinstimmung für Ihre Eingabe vorhanden ist, wird die Virtual Agent Informiert Sie, dass es sich nicht um eine gültige Auswahl handelt, und fordert Sie auf, eine andere Eingabe zu versuchen.
-
Die Header-Karte 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 unter einer Header-Karte angezeigten Elemente zu steuern, fügen Sie hinzu com.glide.cs.web_header_picker_page_limitSystemeigenschaft. Verwenden Sie Wert Um die Anzahl der Elemente in der Auswahlliste anzugeben. Weitere Informationen zum Erstellen einer Systemeigenschaft finden Sie unter Fügen Sie eine Systemeigenschaft hinzu .
Wenn Sie einen Knoten der dynamischen Auswahlliste mit nur einer Auswahl ausfüllen, erhalten Sie beim Testen oder Verwenden des Knotens eine Nachricht, die gelesen wird „Wir haben [Auswahl] als [Knotenname], ist das richtig?“ . Verwenden Sie mehrere Auswahlmöglichkeiten im Knoten der dynamischen Auswahlliste, um zu vermeiden, dass diese Nachricht empfangen wird.
Sie können den Nachrichteninhalt auch ändern, indem Sie zu navigieren Und bearbeiten glide.cs.retry_question_messageSystemeigenschaft. Dieser Nachrichtenwert ist standardmäßig eine Zeichenfolge Wir haben {0} als {1}, ist das richtig? Und wird zum Ausfüllen von Zeitfenstern in mehreren Fällen außerhalb der dynamischen Auswahlliste verwendet. Alle von Ihnen vorgenommenen Änderungen werden bei jeder Verwendung dieser Eigenschaft berücksichtigt.
Eigenschaften der Anwendereingabesteuerung für dynamische Auswahl 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 erstellt Knotenname Eigenschaft. |
| Aufforderung |
Prompt 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 lautet Ihr Name? Sie können Rich-Text erstellen, um die Stile der Eingabeaufforderung zu ändern:
|
| NLU-Entität |
Option zum Zuordnen von NLU Entität mit dem Knoten. Wenn ein NLU Entität ist der Eingabevariable für diesen Knoten zugeordnet, Virtual Agent Kann den angegebenen Wert basierend auf der Äußerung des Anwenders in einem Slot 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 Anwender nicht bitten, erkannte Entität zu bestätigen angezeigt. Wenn diese Option aktiviert ist, werden Anwender nicht aufgefordert, die extrahierte Entität zu bestätigen. Dieses Feld ist nur verfügbar, wenn NLU Discovery ist auf der Instanz aktiviert. |
| Auswahlmöglichkeiten | |
| Auswahlmöglichkeiten ausfüllen nach |
Typ der zu verwendenden dynamischen Variable. Wählen Sie eine der folgenden Optionen aus:
|
| Tabelle |
Zu durchsuchende Tabelle, nur verfügbar, wenn Sie ausgewählt haben Datensatz Als Methode zum Ausfüllen von Auswahlmöglichkeiten. |
| Auswahlmöglichkeiten filtern |
Option zur Verwendung von Virtual Agent-Designer Bedingungsgenerator, oder geben Sie ein Skript an. 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 |
Nachricht, 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, die Bilder oder YouTube-Videos enthalten können. 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 in definierte Antwort Bestätigung des Standardwerts Im Feld wird der Anwender aufgefordert, den Standardwert zu bestätigen. Wenn der Anwender mit antwortet Nein , Der Wert wird null. Der Standardwert kann entweder eine Textzeichenfolge oder ein Skript sein, das Text zurückgibt. Wenn Sie beispielsweise Dot-Walking verwenden, kann der Standardwert wie folgt lauten: Skriptvariablen > letzter Anwendername . Oder wenn Sie ein Skript verwenden, kann der Standardwert sein: {{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, kann die Bestätigung lauten: Vielen Dank, {{vaInputs.username}}! |
| Standardwertbestätigung |
Nachricht, in der der Anwender aufgefordert wird, den Wert in zu überprüfen Standardwert Feld ist korrekt. Diese Nachricht wird anstelle eines Werts in verwendet Eingabeaufforderung Feld. Es 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, kann die Bestätigungsnachricht lauten: Sind Sie {{vaScripts.lastUsername}}? . |
| Konversationswechsel | |
| Dieser Abschnitt ist nur verfügbar, wenn NLU Discovery ist auf der Instanz aktiviert. | |
| Aktivieren, damit Anwender den Betreff ändern können |
Option zum Aktivieren NLU Vorhersage für diesen Knoten. Wenn diese Option aktiviert ist, können Anwender Text eingeben, um Fragen zu beantworten, unabhängig vom Typ der verwendeten Eingabesteuerung. Virtual Agent Verwendet diese Äußerung, um einer anderen vorhandenen Absicht zu entsprechen, sodass der Anwender Themen wechseln kann. |
| Diesen Knoten ausblenden oder überspringen | |
| Diesen Knoten bedingt anzeigen, wenn |
Anweisung für keine Codebedingung oder Low-Code-Skript, das eine Bedingung für die Präsentation dieses Knotens in der Konversation angibt. Die Bedingung muss als true bewertet werden. |
| Zulassen, dass Anwender diesen Knoten überspringen, wenn |
Keine Codebedingungsanweisung oder Low-Code-Skript, das eine Bedingung angibt, mit 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 | Keine Codebedingungsanweisung oder Low-Code-Skript, das eine Bedingung angibt, mit der Anwender die erneute Aufforderung in der Konversation überspringen können. Wenn ein vorangehender Knoten durch eine Themen-Loopback- oder Dialoganwendung erneut aufgerufen wird, umgeht Virtual Agent diesen Knoten und behält automatisch seinen ursprünglichen Wert bei. |
Beispiel für die Anwendereingabesteuerung für dynamische Auswahl für die LLM-Themen-Discovery
| Eingabeeigenschaften | Listen Sie die Anwenderaufforderung auf |
|---|---|
|
|
|
Eigenschaften der Anwendereingabesteuerung für dynamische Auswahl 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 erstellt Knotenname Eigenschaft. |
| Aufforderung |
Prompt 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 lautet Ihr Name? Sie können Rich-Text erstellen, um die Stile der Eingabeaufforderung zu ändern:
|
| NLU-Entität |
Option zum Zuordnen von NLU Entität mit dem Knoten. Wenn ein NLU Entität ist der Eingabevariable für diesen Knoten zugeordnet, Virtual Agent Kann den angegebenen Wert basierend auf der Äußerung des Anwenders in einem Slot 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 Anwender nicht bitten, erkannte Entität zu bestätigen angezeigt. Wenn diese Option aktiviert ist, werden Anwender nicht aufgefordert, die extrahierte Entität zu bestätigen. Dieses Feld ist nur verfügbar, wenn NLU Discovery ist auf der Instanz aktiviert. |
| Auswahlmöglichkeiten | |
| Auswahlmöglichkeiten ausfüllen nach |
Typ der zu verwendenden dynamischen Variable. Wählen Sie eine der folgenden Optionen aus:
|
| Tabelle |
Zu durchsuchende Tabelle, nur verfügbar, wenn Sie ausgewählt haben Datensatz Als Methode zum Ausfüllen von Auswahlmöglichkeiten. |
| Auswahlmöglichkeiten filtern |
Option zur Verwendung von Virtual Agent-Designer Bedingungsgenerator, oder geben Sie ein Skript an. 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 |
Nachricht, 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, die Bilder oder YouTube-Videos enthalten können. 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 in definierte Antwort Bestätigung des Standardwerts Im Feld wird der Anwender aufgefordert, den Standardwert zu bestätigen. Wenn der Anwender mit antwortet Nein , Der Wert wird null. Der Standardwert kann entweder eine Textzeichenfolge oder ein Skript sein, das Text zurückgibt. Wenn Sie beispielsweise Dot-Walking verwenden, kann der Standardwert wie folgt lauten: Skriptvariablen > letzter Anwendername . Oder wenn Sie ein Skript verwenden, kann der Standardwert sein: {{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, kann die Bestätigung lauten: Vielen Dank, {{vaInputs.username}}! |
| Standardwertbestätigung |
Nachricht, in der der Anwender aufgefordert wird, den Wert in zu überprüfen Standardwert Feld ist korrekt. Diese Nachricht wird anstelle eines Werts in verwendet Eingabeaufforderung Feld. Es 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, kann die Bestätigungsnachricht lauten: Sind Sie {{vaScripts.lastUsername}}? . |
| Konversationswechsel | |
| Dieser Abschnitt ist nur verfügbar, wenn NLU Discovery ist auf der Instanz aktiviert. | |
| Aktivieren, damit Anwender den Betreff ändern können |
Option zum Aktivieren NLU Vorhersage für diesen Knoten. Wenn diese Option aktiviert ist, können Anwender Text eingeben, um Fragen zu beantworten, unabhängig vom Typ der verwendeten Eingabesteuerung. Virtual Agent Verwendet diese Äußerung, um einer anderen vorhandenen Absicht zu entsprechen, sodass der Anwender Themen wechseln kann. |
| Diesen Knoten ausblenden oder überspringen | |
| Diesen Knoten bedingt anzeigen, wenn |
Anweisung für keine Codebedingung oder Low-Code-Skript, das eine Bedingung für die Präsentation dieses Knotens in der Konversation angibt. Die Bedingung muss als true bewertet werden. |
| Zulassen, dass Anwender diesen Knoten überspringen, wenn |
Keine Codebedingungsanweisung oder Low-Code-Skript, das eine Bedingung angibt, mit 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 | Keine Codebedingungsanweisung oder Low-Code-Skript, das eine Bedingung angibt, mit der Anwender die erneute Aufforderung in der Konversation überspringen können. Wenn ein vorangehender Knoten durch eine Themen-Loopback- oder Dialoganwendung erneut aufgerufen wird, umgeht Virtual Agent diesen Knoten und behält automatisch seinen ursprünglichen Wert bei. |
Beispiel für eine Anwendereingabesteuerung für dynamische Auswahl für die NLU-Themen-Discovery
| Eingabeeigenschaften | Eingabeaufforderung für Liste |
|---|---|
In der Auswahlliste werden 10 Elemente pro Seite angezeigt. Wenn 10 oder mehr Ergebnisse zurückgegeben werden:
|
|
Die Auswahlliste enthält fünf Elemente pro Seite. Wenn fünf oder mehr Ergebnisse zurückgegeben werden, bietet die Liste eine Option zum Anzeigen weiterer Ergebnisse. Hinweis: Die Suchfunktion wird unterdrückt, wenn eine Header-Karte 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 einen dynamischen Auswahllistenwertausdruck
(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 beschränken. Mit dieser Methode können Sie verhindern, dass zurückgegebene Datensätze eine übermäßig große Auswahlliste erstellen.
| Schlüssel | 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-Support | NLU-/Stichwortunterstü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 | Header-Karten werden nicht unterstützt. |
| Workplace | Nicht unterstützt | Unterstützt | Header-Karten werden nicht unterstützt. |
| Facebook Messenger | Nicht unterstützt | Nicht unterstützt | Nicht zutreffend |
| SMS Twilio | Nicht unterstützt | Unterstützt | Header-Karten 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 den Touch-Scroll. Klicken auf Links wird nicht unterstützt. Verwenden Sie für Geräte ohne Bildschirm die Sprachpaginierung. |