Anwendereingabesteuerung für dynamische Auswahl
Verwenden Sie das Anwendereingabesteuerelement für dynamische Auswahl in einem Virtual AgentThema zum dynamischen Erstellen einer Liste der verfügbaren Auswahlmöglichkeiten für Ihre Anwender. Erstellen Sie diese Auswahlmöglichkeiten, indem Sie eine Tabelle abfragen oder ein Skript verwenden, um sie dynamisch zu erstellen.
Anzeige der Auswahlliste
Die dynamische Auswahlliste enthält bis zu 10 Elemente pro Seite. Wenn 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 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 Symbol „Senden“ aus 
. Wenn Sie Ihre Auswahlmöglichkeiten über ein LLM-Thema senden, antwortet der LLM mit, ob Ihre Auswahlmöglichkeiten die Validierungskriterien erfüllen.
Sie können auch eine Auswahl 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 Virtual AgentInformiert 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 Elemente zu steuern, die unter einer Header-Karte angezeigt werden, fügen Sie hinzu com.glide.cs.web_header_picker_page_limitSystemeigenschaft. Verwenden Sie Wert Um die Anzahl der Elemente in der Auswahlliste anzugeben. Details 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 „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.
Anwendereingabesteuerungseigenschaften für dynamische Auswahl für LLM-Themen-Discovery
| Eigenschaft | Beschreibung |
|---|---|
| Knotenname |
Name, der diesen Knoten im Themen-Flow identifiziert. |
| Variablenname |
Name der Variable, die die Anwenderantwort auf diesen Prompt speichert. Der Variablenname wird automatisch aus erstellt Knotenname Eigenschaft. |
| Aufforderung |
Prompt oder Frage für den Anwender. Der Prompt 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 des Prompts zu ändern:
|
| NLU-Entität |
Option zum Zuordnen von NLUEntität mit dem Knoten. Wenn NLUEntität ist der Eingabevariable für diesen Knoten zugeordnet. Virtual AgentKann 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 „Anwender nicht bitten, die 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 NLUDiscovery 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-DesignerBedingungsgenerator, 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 Anwenderantwort auf die Frage oder den Prompt. Die in definierte Antwort Standardwertbestätigung 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 folgendermaßen 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 Prompt 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 NLUDiscovery ist auf der Instanz aktiviert. | |
| Aktivieren, damit Anwender den Betreff ändern können |
Option zum Aktivieren NLUVorhersage 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 AgentVerwendet diese Äußerung, um eine andere vorhandene Absicht abzugleichen, 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 „wahr“ ausgewertet werden. |
| Zulassen, dass Anwender diesen Knoten überspringen, wenn |
Anweisung für keine Codebedingung oder Low-Code-Skript, das eine Bedingung angibt, mit der Anwender diesen Knoten in der Konversation überspringen können. Die Bedingung muss als „wahr“ ausgewertet werden. Sie können dieses Feld entweder mit dem Bedingungsgenerator oder einem Skript festlegen. |
| Erneute Aufforderung überspringen, wenn | Anweisung für keine Codebedingung oder Low-Code-Skript, das eine Bedingung angibt, mit der Anwender Neuaufforderungen in der Konversation überspringen können. Wenn ein vorangehender Knoten über eine Themen-Loopback- oder Dialogaktion erneut aufgerufen wird, umgeht der 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 |
|---|---|
|
|
In der Auswahlliste werden 10 Elemente pro Seite angezeigt. Wenn 10 oder mehr Ergebnisse zurückgegeben werden:
|
Anwendereingabesteuerungseigenschaften für dynamische Auswahl für die NLU-Themen-Discovery
| Eigenschaft | Beschreibung |
|---|---|
| Knotenname |
Name, der diesen Knoten im Themen-Flow identifiziert. |
| Variablenname |
Name der Variable, die die Anwenderantwort auf diesen Prompt speichert. Der Variablenname wird automatisch aus erstellt Knotenname Eigenschaft. |
| Aufforderung |
Prompt oder Frage für den Anwender. Der Prompt 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 des Prompts zu ändern:
|
| NLU-Entität |
Option zum Zuordnen von NLUEntität mit dem Knoten. Wenn NLUEntität ist der Eingabevariable für diesen Knoten zugeordnet. Virtual AgentKann 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 „Anwender nicht bitten, die 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 NLUDiscovery 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-DesignerBedingungsgenerator, 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 Anwenderantwort auf die Frage oder den Prompt. Die in definierte Antwort Standardwertbestätigung 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 folgendermaßen 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 Prompt 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 NLUDiscovery ist auf der Instanz aktiviert. | |
| Aktivieren, damit Anwender den Betreff ändern können |
Option zum Aktivieren NLUVorhersage 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 AgentVerwendet diese Äußerung, um eine andere vorhandene Absicht abzugleichen, 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 „wahr“ ausgewertet werden. |
| Zulassen, dass Anwender diesen Knoten überspringen, wenn |
Anweisung für keine Codebedingung oder Low-Code-Skript, das eine Bedingung angibt, mit der Anwender diesen Knoten in der Konversation überspringen können. Die Bedingung muss als „wahr“ ausgewertet werden. Sie können dieses Feld entweder mit dem Bedingungsgenerator oder einem Skript festlegen. |
| Erneute Aufforderung überspringen, wenn | Anweisung für keine Codebedingung oder Low-Code-Skript, das eine Bedingung angibt, mit der Anwender Neuaufforderungen in der Konversation überspringen können. Wenn ein vorangehender Knoten über eine Themen-Loopback- oder Dialogaktion erneut aufgerufen wird, umgeht der Virtual Agent diesen Knoten und behält automatisch seinen ursprünglichen Wert bei. |
Beispiel für die Anwendereingabesteuerung für die NLU-Themen-Discovery
| Eingabeeigenschaften | Listenaufforderung |
|---|---|
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 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 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 Auswahlwertausdruck Eigenschaft definiert ein Array von Auswahlmöglichkeiten und gibt sie zurück. Im Beispiel erstellt das Skript ein Array namens Optionen , Und fügt diesem Array jeden in einer GlideRecord-Abfrage gefundenen Datensatz hinzu. Jedes Element im Array erhält einen Wert in Wert Und Bezeichnung Schlüssel, die Daten aus diesem GlideRecord verwenden. Die Tabelle Eigenschaft der Steuerung 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.
| Key | Beschreibung |
|---|---|
| Wert | Der Wert für die Auswahl. Wenn ein Anwender eine Auswahl aus der Steuerung auswählt, wird dieser Wert in der Variable gespeichert, die in genannt wird Variablenname Eigenschaft. |
| label | Die Bezeichnung, die für diese Auswahl in der Auswahlliste angezeigt wird. |
Kanalunterstützung
| Kanal | LLM-Support | NLU-/Stichwortunterstützung | Einschränkungen |
|---|---|---|---|
| Web-UI | 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 (Sprachfunktionen) | 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. |