Dynamische Auswahl der Benutzereingabesteuerung

  • Freigeben Version: Washingtondc
  • Aktualisiert 12. März 2024
  • 11 Minuten Lesedauer
  • Verwenden Sie das Steuerelement für die Benutzereingabe für 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, haben Benutzer die Möglichkeit, die zusätzlichen Elemente anzuzeigen und die Suchergebnisse zu filtern. Die Auswahllisten-Eingabeaufforderung enthält ein Suchsymbol, mit dem Benutzer die Ergebnisse filtern können.

    Tipp:
    Wenn Sie die Standardanzahl der aufgelisteten Elemente pro Seite ändern möchten, können Sie die Systemeigenschaft com.glide.cs.picker_page_limit ändern. Der Standardwert ist 10.

    Wenn die Auswahl mehrerer Auswahlmöglichkeiten aktiviert ist, können Sie im Feld Suchen nach Optionen 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 Senden-Pfeilsymbolaus. Wenn Sie Ihre Auswahl über ein LLM-fähiges Virtual Agentsenden, antwortet das LLM mit der Frage, ob Ihre Auswahl die Validierungskriterien erfüllt.

    Das Steuerelement „Dynamische Auswahl“ bietet auch die Option zum Hinzufügen einer Header-Karte, die über der Auswahlliste angezeigt wird. Headerkarten werden in Web- und Mobile-Kanälen unterstützt.
    • 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 Benutzer die zusätzlichen Elemente anzeigen.

    • Um die Anzahl der unter einer Headerkarte angezeigten Elemente zu steuern, fügen Sie die Systemeigenschaft com.glide.cs.web_header_picker_page_limit hinzu. Verwenden Sie den Wert, um die Anzahl der Elemente in der Auswahlliste anzugeben. Weitere Informationen zum Erstellen einer Systemeigenschaft finden Sie unter Systemeigenschaften hinzufügen.

    Dynamische Auswahl der Benutzereingabe-Steuerungseigenschaften für die LLM-Themenerkennung

    Eigenschaft Beschreibung
    Knotenname Name, der diesen Dynamic-Choice-Benutzersteuerungsknoten im Themen-Flow identifiziert.
    Detailbeschreibung Die einzige Information, die vom Benutzer benötigt wird. Beispiel: Benutzer bitten, einen Incident auszuwählen.
    Auswahlmöglichkeiten
    Auswahlmöglichkeiten ausfüllen nach Typ der zu verwendenden dynamischen Variablen. Wählen Sie eine der folgenden Optionen aus:
    • Datensatz: Gibt Datensätze aus der ausgewählten Tabelle zurück. Die Werte für diese Optionen sind GlideRecord-Objekte.
    • Skript: Ausdruck, der ein Array von Optionen zurückgibt.
      Hinweis:

      Um effizientere Paginierungsergebnisse für einen großen Datensatz zu erhalten, wenn Sie einen Skriptausdruck verwenden, überprüfen Sie das folgende Skript, und bestimmen Sie, ob Sie dieses Skript verwenden möchten:

      (function execute() {
       
      var pagingUtil = new global.VirtualAgentChoicePagingUtil(null, "sys_user", null, "user_name,name",
      "active=true", null, vaVars);
       
      var gr = pagingUtil.getPagingGlideRecordSecure("name", false);
      
      var options = pagingUtil.getSecureOptions(gr, null,'user_name', ['user_name','name']);
      
      return options;
      })()
      

      Weitere Informationen zu den vorherigen Skriptdetails finden Sie in den Informationen zu GlideRecords und in den zusätzlichen Informationen:

      • fieldName: Feldname ist eine optionale Information. Übergeben Sie mit NULL.
      • table: Tabellenname, der zur Anzeige der verfügbaren Optionen abgefragt werden soll.
      • pageSize: Seitengröße ist eine optionale Angabe. Übergeben Sie mit NULL.
      • searchColumns: Tabellenspalten in einer durch Kommas getrennten Liste, die für jeden Suchtext gilt.
      • encodedQuery: Anfängliche Abfrage, die auf Tabellenzeilen angewendet werden soll. Beispiel: active=true.
      • searchText: Suchtext ist eine optionale Information. Übergeben Sie mit NULL.
      • vaVars: Verweis auf Virtual Agent-Kontextvariablen (vaVars).
      • orderByColumn: Tabellenspalte, die zum Sortieren der Optionen verwendet wird.
      • orderDescending: Optionen werden in absteigender Reihenfolge angezeigt. Nur „true“ - oder „false“ -Werte werden akzeptiert.
      • gr: Name des Glide-Datensatzes.
      • startRow: Die Startzeile enthält optionale Informationen. Übergeben Sie mit NULL.
      • valueColumn: Tabellenspaltenname, der als Wert für jede Option verwendet werden soll.
      • labelColumns: Array von Tabellenspalten, die für jede Optionsanzeige verwendet werden sollen.
    Tabelle Wenn Sie Datensatz als Methode zum Ausfüllen von Auswahlmöglichkeiten ausgewählt haben, wählen Sie die zu durchsuchende Tabelle aus.

    Dieses Feld ist nur verfügbar, wenn die Option Datensatz ausgewählt ist.

    Auswahlmöglichkeiten filtern Option zur Verwendung des Bedingungsgenerators Virtual Agent-Designer oder zur Bereitstellung eines Skripts. Wählen Sie eine der folgenden Optionen aus:
    • Bedingungsgenerator: Erstellt einen Filter, der zum Auswählen einer Teilmenge von Datensätzen aus der Tabelle verwendet wird.
    • Skript: Definiert die Aufzählungsliste für die anzuzeigenden Optionen (Auswahlliste). Das Name-Wert-Paar wird als Zeichenfolgenobjekt gespeichert.

    Dieses Feld ist nur verfügbar, wenn die Option Datensatz ausgewählt ist.

    Erweitert
    Benutzeraufforderung erzwingen

    Umschalter, um ein Feld für eine benutzerdefinierte Nachricht zu öffnen, die dem Benutzer anstelle der vom LLM generierten Nachricht angezeigt wird. Sie können benutzerdefinierte Nachrichten im Klartext erstellen, ein Skript eingeben 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.

    Beispiel für die Benutzereingabesteuerung „Dynamische Auswahl“ für LLM-Themenerkennung

    Hinweis:
    Virtual Agent-Designer -Steuerungen werden in anderen Kanälen möglicherweise anders angezeigt und funktionieren.
    Eingabeeigenschaften Eingabeaufforderung für Liste

    Zu den grundlegenden Eigenschaften gehören Name, Beschreibung, Auswahl nach Liste ausfüllen und Filteroptionen. Zu den erweiterten Optionen gehören Benutzeraufforderung erzwingen und Zusätzliche Anweisungen für LLM, definiert durch Texteingabe, Bedingungen oder Skripts.

    Abbildung : 1. Eingabeaufforderung für dynamische Auswahlliste der Web-UI
    Eine dynamische Auswahlliste gibt eine Liste der vom Benutzer erstellten Incidents zurück.
    Die Auswahlliste zeigt 10 Elemente pro Seite an. Wenn 10 oder mehr Ergebnisse zurückgegeben werden:
    • Die Liste enthält einen Link am Ende der Liste, um weitere Ergebnisse anzuzeigen.
    • Ein Suchsymbol () wird in der Eingabeaufforderung zum Filtern von Suchergebnissen angezeigt. Benutzer wählen das Symbol aus, um ein Suchfeld zu öffnen und den Filter einzugeben.
    • Wenn Sie mehrere Auswahlmöglichkeiten auswählen, können Sie im Feld Suchen nach Optionen 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 Senden-Pfeilsymbolaus. Wenn Sie Ihre Auswahlmöglichkeiten senden, antwortet das LLM mit der Frage, ob Ihre Auswahlmöglichkeiten die Validierungskriterien erfüllen.

    Dynamische Auswahl der Benutzereingabe-Steuerungseigenschaften für die NLU-Themenerkennung

    Eigenschaft Beschreibung
    Knotenname Name, der diesen Dynamic-Choice-Benutzersteuerungsknoten 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

    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.

    Auswahlmöglichkeiten
    Auswahlmöglichkeiten ausfüllen nach Typ der zu verwendenden dynamischen Variablen. Wählen Sie eine der folgenden Optionen aus:
    • Datensatz: Gibt Datensätze aus der ausgewählten Tabelle zurück. Die Werte für diese Optionen sind GlideRecord-Objekte.
    • Skript: Ausdruck, der ein Array von Optionen zurückgibt.
    Tabelle Wenn Sie Datensatz als Methode zum Ausfüllen von Auswahlmöglichkeiten ausgewählt haben, wählen Sie die zu durchsuchende Tabelle aus.

    Dieses Feld ist nur verfügbar, wenn die Option Datensatz ausgewählt ist.

    Auswahlmöglichkeiten filtern Option zur Verwendung des Bedingungsgenerators Virtual Agent-Designer oder zur Bereitstellung eines Skripts. Wählen Sie eine der folgenden Optionen aus:
    • Bedingungsgenerator: Erstellt einen Filter, der zum Auswählen einer Teilmenge von Datensätzen aus der Tabelle verwendet wird.
    • Skript: Definiert die Aufzählungsliste für die anzuzeigenden Optionen (Auswahlliste). Das Name-Wert-Paar wird als Zeichenfolgenobjekt gespeichert.

    Dieses Feld ist nur verfügbar, wenn die Option Datensatz ausgewählt ist.

    Antwortnachricht ohne Datensätze Nachricht, die dem Benutzer 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
    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.

    Header-Karte
    Einfügen Umschalter, um eine Header-Karte über der Auswahlliste einzufügen. Sie können das Dialogfeld Karte hinzufügen oder ein Skript verwenden.

    Header-Kartenabschnitt des Steuerelements „Dynamische Auswahl von Benutzereingaben“, mit Umschalter „Einfügen“ und Optionsfeld „Wenden Sie Hilfe“ aktiviert.

    Ausführliche Informationen finden Sie unter Fügen Sie eine Header-Karte in ein Steuerelement für statische Auswahl oder dynamische Auswahl ein.

    Benötigen Sie Hilfe?
    Option zur Verwendung der Schnittstelle Virtual Agent-Designer oder zur Bereitstellung eines Skripts. Wählen Sie eine der folgenden Optionen:
    • Ja: Um die Header-Karte ohne Skripting zu erstellen, wählen Sie Karte hinzufügen.
    • Nein, ich werde Skript verwenden: Um das Dialogfeld „Skript“ zu öffnen, wählen Sie Skript hinzufügen.
    Dieses Feld ist nur verfügbar, wenn die Option Header-Karte aktiviert ist.
    Dialogfeld „Karte hinzufügen“.
    Dieser Abschnitt ist nur verfügbar, wenn die Karte „Header “ aktiviert ist.
    Kartentyp
    Typ der Header-Karte. Wählen Sie eine der folgenden Optionen:
    • Großes Bild mit Text
    • Kleines Bild mit Text
    • Youtube-Videokarte
    Die Felder im Dialogfeld ändern sich basierend auf Ihrer Auswahl.
    Titel

    Bild- oder Videotitel. Geben Sie den Titeltext ein, oder verwenden Sie eine Datenpille oder ein Skript, um den Titel anzugeben.

    Titellink URL des Hyperlinks zum Videotitel. Geben Sie den Linktext ein, oder verwenden Sie eine Datenpille oder ein Skript, um den Link anzugeben. Wenn dieses Feld leer ist, wird der Titel als Nur-Text angezeigt.

    Dieses Feld ist nur verfügbar, wenn die Option YouTube-Videokarte ausgewählt ist.

    Beschreibung Kurze Erklärung des Bilds oder Videos.
    YouTube-Video-ID Alphanumerische Zeichenfolge am Ende der YouTube-URL. Beispiel: In der URL https://www.youtube.com/watch?v=AacDp2mUQ1Ilautet die YouTube-Video-ID AacDp2mUQ1I.

    Dieses Feld ist nur verfügbar, wenn die Option YouTube-Videokarte ausgewählt ist.

    URL-Link zum Bild
    URL-Link für das Bild oder die Bilddatei. Führen Sie einen der folgenden Schritte aus, um dieses Feld festzulegen:
    • Geben Sie den URL-Link an, indem Sie entweder den Linktext eingeben, eine Datenpille verwenden oder ein Skript verwenden.
    • Laden Sie eine Bilddatei hoch, indem Sie Bild hochladenauswählen.

    Dieses Feld ist nur verfügbar, wenn die Option Großes Bild mit Text oder Kleines Bild mit Text ausgewählt ist.

    Alternativer Text für Bild Alternativer, bildschirmlesbarer Text, der das Bild für barrierefreie Programme beschreibt. Dieser Text wird zusammen mit dem Bild verwendet. Geben Sie den Text mithilfe des Textfelds, der Datenpille oder des Skripts ein.

    Dieses Feld ist nur verfügbar, wenn die Option Großes Bild mit Text oder Kleines Bild mit Text ausgewählt ist.

    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-Benutzereingabesteuerung für dynamische Auswahl für NLU-Themenerkennung

    Hinweis:
    Virtual Agent-Designer -Steuerungen werden in anderen Kanälen möglicherweise anders angezeigt und funktionieren.
    Eingabeeigenschaften Eingabeaufforderung für Liste
    Abbildung : 2. Dynamische Auswahl der Benutzereingaben steuern grundlegende Eigenschaften
    Zu den grundlegenden Eigenschaften gehören der Knotenname, die Eingabeaufforderung, die NLU-Entität und die Auswahlmöglichkeiten nach Liste ausfüllen.
    Abbildung : 3. Eingabeaufforderung für dynamische Auswahlliste der Web-UI
    Eine dynamische Auswahlliste gibt eine Liste der vom Benutzer erstellten Incidents zurück.
    Die Auswahlliste zeigt 10 Elemente pro Seite an. Wenn 10 oder mehr Ergebnisse zurückgegeben werden:
    • Die Liste enthält einen Link am Ende der Liste, um weitere Ergebnisse anzuzeigen.
    • Ein Suchsymbol () wird in der Eingabeaufforderung zum Filtern von Suchergebnissen angezeigt. Benutzer wählen das Symbol aus, um ein Suchfeld zu öffnen und den Filter einzugeben.
    • Wenn Sie mehrere Auswahlmöglichkeiten auswählen, können Sie im Feld Suchen nach Optionen 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 Senden-Pfeilsymbolaus.
    Abbildung : 4. Dynamische Auswahllisten-Eingabeaufforderung der Web-UI mit Header-Karte
    Die Eingabeaufforderung fragt: „Was möchten Sie überprüfen?“ gefolgt von einem Foto und der Überschrift eines Hotel. Zur Auswahl stehen „Essen“, „Suiten“ und „Einrichtungen“.
    Die Auswahlliste enthält fünf Elemente pro Seite. Wenn fünf oder mehr Ergebnisse zurückgegeben werden, bietet die Liste die Option, weitere Ergebnisse anzuzeigen.
    Hinweis:
    Die Suchfunktion wird unterdrückt, wenn eine Header-Karte verwendet wird.

    Beispiel für 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 übermäßig große Auswahlliste erstellen.

    Tabelle : 1. Schlüssel für dynamische Auswahlsteuerungswertausdrücke
    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

    Tabelle : 2. Kanalunterstützung für die Benutzereingabesteuerung „Dynamische Auswahl“.
    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
    Slack Unterstützt Header-Karten werden nicht unterstützt.
    Workplace Unterstützt Header-Karten werden nicht unterstützt.
    Facebook Messenger Nicht unterstützt Nicht zutreffend
    SMS Twilio Unterstützt Header-Karten werden nicht unterstützt.
    LINE Nicht unterstützt Nicht zutreffend
    WhatsApp Unterstützt Keine
    Apple Messages for Business Unterstützt Keine
    Alexa (Sprache) Unterstützt Verwenden Sie für Bildschirmgeräte den Touch-Bildlauf. Klicken auf Links wird nicht unterstützt. Verwenden Sie für Geräte ohne Bildschirm die Sprachpaginierung.