Contrôle de l’entrée de l’utilisateur Choix dynamique

Affichage de la liste de choix

La liste de choix dynamiques contient jusqu’à 10 éléments par page. Lorsqu’il existe plus de 10 éléments, les utilisateurs ont la possibilité d’afficher les éléments supplémentaires et de filtrer les résultats de recherche. L’invite de liste de choix contient une icône de recherche que les utilisateurs peuvent sélectionner pour filtrer les résultats.

Conseil :

Si vous souhaitez modifier le nombre par défaut d’éléments répertoriés par page, vous pouvez modifier la com.glide.cs.picker_page_limit propriété système. La valeur par défaut est de 10.

Si la sélection de choix multiples est activée, vous pouvez effectuer une recherche dans le champ Rechercher des options pour filtrer les résultats de recherche. Sélectionnez ou tapez tous les choix qui s’appliquent, puis sélectionnez l’icône d’envoi . Lorsque vous envoyez vos choix par l’intermédiaire d’un LLM activé Agent virtuel, le LLM répond en indiquant si vos choix répondent aux critères de validation.

Le contrôle Choix dynamique offre également la possibilité d’ajouter une carte d’en-tête qui s’affiche au-dessus de la liste de choix. Les cartes d’en-tête sont prises en charge dans les canaux Web et mobile.

La carte d’en-tête peut contenir une grande ou petite image ou une carte vidéo YouTube, ainsi qu’un texte descriptif. La liste de choix contient jusqu’à cinq éléments par défaut, mais la fonctionnalité de recherche est supprimée. S’il y a plus de cinq éléments, les utilisateurs peuvent choisir d’afficher les éléments supplémentaires.
Pour contrôler le nombre d’éléments affichés sous une carte d’en-tête, ajoutez la com.glide.cs.web_header_picker_page_limit propriété système. Utilisez la valeur pour spécifier le nombre d’éléments dans la liste de choix. Pour en savoir plus sur la création d’une propriété système, reportez-vous à la rubrique Ajouter une propriété système.

Propriétés du contrôle d’entrée de l’utilisateur de choix dynamique pour la détection de rubriques LLM


Propriété	Description
Nom du nœud	Nom qui identifie ce nœud de contrôle de l’utilisateur de choix dynamique dans le flux de rubriques.
Détailler la description	La seule information nécessaire de la part de l’utilisateur. Par exemple, `Demander à l’utilisateur de sélectionner un incident.`
Choix
Renseignez les choix par	Type de variable dynamique à utiliser. Sélectionnez l'une des options suivantes : Enregistrement : renvoie les enregistrements de la table sélectionnée. Les valeurs de ces options sont des objets GlideRecord. Script : expression qui renvoie un tableau d’options. Remarque : Pour que la pagination renvoie des résultats plus efficaces pour un jeu de données volumineux lors de l’utilisation d’une expression de script, examinez le script suivant et déterminez si vous souhaitez utiliser ce script : `(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; })()` Pour plus d’informations sur les détails de scripting précédents, consultez les informations sur GlideRecords et les informations supplémentaires : fieldName: le nom du champ est une information facultative. Passer avec `null`. table: nom de table à interroger pour afficher les options disponibles. pageSize: la taille de page est une information facultative. Passer avec `null`. searchColumns: colonnes de table dans une liste séparée par des virgules qui s’applique à n’importe quel texte de recherche. encodedQuery: requête initiale à appliquer aux lignes de la table. Par exemple, `active=true`. searchText: le texte de recherche est une information facultative. Passer avec `null`. vaVars: référence aux variables de contexte de l’agent virtuel (`vaVars`). orderByColumn: colonne de table utilisée pour classer les options. orderDescending: les options apparaissent par ordre décroissant. Seules `les valeurs Vrai` et `Faux` sont acceptées. gr: nom de l’enregistrement Glide. startRow: la ligne de départ est une information facultative. Passer avec `null`. valueColumn: nom de colonne de table à utiliser comme valeur de chaque option. labelColumns: tableau de colonnes de table à utiliser pour chaque affichage d’option.
Table	Si vous avez sélectionné Enregistrement comme méthode de remplissage des choix, sélectionnez la table dans laquelle rechercher. Ce champ n’est disponible que lorsque l’option Enregistrement est sélectionnée.
Choix de filtres	Option pour utiliser le créateur de Concepteur d'agent virtuel condition ou fournir un script. Sélectionnez l'une des options suivantes : Créateur de conditions : crée un filtre utilisé pour sélectionner un sous-ensemble d’enregistrements à partir de la table. Script : définit la liste d’énumération pour les options (liste de choix) à afficher. La paire nom-valeur est stockée sous la forme d’un objet de chaîne. Ce champ n’est disponible que lorsque l’option Enregistrement est sélectionnée.
Avancé
Appliquer l’invite utilisateur	Activez/désactivez cette option pour ouvrir un champ pour un message personnalisé affiché à l’utilisateur au lieu du message généré par le LLM. Vous pouvez créer des messages personnalisés en langage simple, saisir un script ou définir des conditions à l’aide du sélecteur de pastilles de données.
Masquer ce nœud
Afficher conditionnellement ce nœud si	Déclaration de condition no-code ou script low-code qui spécifie une condition de présentation de ce nœud dans la conversation. La condition doit être évaluée comme vraie.

Exemple de contrôle d’entrée utilisateur Choix dynamique pour la détection de rubriques LLM

Remarque :

Concepteur d'agent virtuel Les commandes peuvent s’afficher et fonctionner différemment dans d’autres canaux.


Propriétés d’entrée	Invite de liste
	Figure 1. Invite de liste de choix dynamique de l’interface utilisateur Web La liste de choix affiche 10 éléments par page. Lorsque 10 résultats ou plus sont renvoyés : La liste comprend un lien à la fin de la liste pour afficher plus de résultats. Une icône de recherche () s’affiche dans l’invite pour filtrer les résultats de recherche. Les utilisateurs sélectionnent l’icône pour ouvrir une zone de recherche et entrer le filtre. Lorsque vous sélectionnez plusieurs choix, vous pouvez effectuer une recherche dans le champ Rechercher des options pour filtrer les résultats de recherche. Sélectionnez ou tapez tous les choix qui s’appliquent, puis sélectionnez l’icône d’envoi . Lorsque vous envoyez vos choix, le LLM répond en indiquant si vos choix répondent aux critères de validation.

Propriétés du contrôle d’entrée de l’utilisateur de choix dynamique pour la détection de rubrique NLU


Propriété	Description
Nom du nœud	Nom qui identifie ce nœud de contrôle de l’utilisateur de choix dynamique dans le flux de rubriques.
Nom de variable	Nom de la variable qui stocke la réponse de l’utilisateur à cette invite. Le nom de variable est automatiquement créé à partir de la propriété Nom de nœud .
Invite	Invite ou question pour l’utilisateur. L’invite peut être une chaîne de texte ou un script qui renvoie du texte. Cette valeur n’est utilisée que lorsque la valeur par défaut n’est pas spécifiée. Par exemple : `Comment t’appelles-tu ?`
Entité NLU	Option permettant d’associer une entité NLU au nœud. Si une entité NLU est associée à la variable d’entrée pour ce nœud, Agent virtuel peut remplir le créneau de la valeur spécifiée en fonction de l’énoncé de l’utilisateur. Sélectionnez une entité dans la liste des entités associées à l’intention de la rubrique. Lorsque vous spécifiez une entité pour le nœud, le commutateur Ne pas demander aux utilisateurs de confirmer l’entité reconnue s’affiche. Lorsqu’elle est activée, les utilisateurs ne sont pas invités à confirmer l’entité extraite. Ce champ n’est disponible que lorsque NLU la détection est activée sur l’instance.
Choix
Renseignez les choix par	Type de variable dynamique à utiliser. Sélectionnez l'une des options suivantes : Enregistrement : renvoie les enregistrements de la table sélectionnée. Les valeurs de ces options sont des objets GlideRecord. Script : expression qui renvoie un tableau d’options.
Table	Si vous avez sélectionné Enregistrement comme méthode de remplissage des choix, sélectionnez la table dans laquelle rechercher. Ce champ n’est disponible que lorsque l’option Enregistrement est sélectionnée.
Choix de filtres	Option pour utiliser le créateur de Concepteur d'agent virtuel condition ou fournir un script. Sélectionnez l'une des options suivantes : Créateur de conditions : crée un filtre utilisé pour sélectionner un sous-ensemble d’enregistrements à partir de la table. Script : définit la liste d’énumération pour les options (liste de choix) à afficher. La paire nom-valeur est stockée sous la forme d’un objet de chaîne. Ce champ n’est disponible que lorsque l’option Enregistrement est sélectionnée.
Aucun message de réponse d'enregistrement	Message affiché à l’utilisateur lorsque la recherche dans la table ne renvoie aucun enregistrement. Le message peut être une chaîne de texte ou un script qui renvoie du texte.
Avancé
Masquer ce nœud
Afficher conditionnellement ce nœud si	Déclaration de condition no-code ou script low-code qui spécifie une condition de présentation de ce nœud dans la conversation. La condition doit être évaluée comme vraie.
Carte d'en-tête
Insérer	Basculez le commutateur pour insérer une carte d’en-tête au-dessus de la liste de choix. Vous pouvez utiliser la boîte de dialogue Ajouter une carte ou un script. Pour en savoir plus, consultez la rubrique Insérer une carte d’en-tête dans un contrôle de choix statique ou de choix dynamique.
Voulez-vous de l’aide	Option pour utiliser l’interface Concepteur d'agent virtuel ou fournir un script. Choisissez l’une des options suivantes : Oui : pour créer la carte d’en-tête sans scripting, sélectionnez Ajouter une carte. Non, j’utiliserai Script : pour ouvrir la boîte de dialogue de script, sélectionnez Ajouter un script. Ce champ n’est disponible que lorsque l’option Carte d’en-tête est activée.
Boîte de dialogue Ajouter une carte
Cette section n’est disponible que lorsque la carte d’en-tête est activée.
Type de carte	Type de carte d’en-tête. Choisissez l’une des options suivantes : Grande image avec du texte Petite image avec du texte Carte vidéo Youtube Les champs de la boîte de dialogue changent en fonction de votre choix.
Titre	Titre de l’image ou de la vidéo. Saisissez le texte du titre ou utilisez une pastille de données ou un script pour spécifier le titre.
Lien de titre	URL du lien hypertexte du titre de la vidéo. Saisissez le texte du lien ou utilisez une pastille de données ou un script pour spécifier le lien. Si ce champ est vide, le titre s’affiche sous forme de texte brut. Ce champ n’est disponible que lorsque l’option Carte vidéo YouTube est sélectionnée.
Description	Brève explication de l’image ou de la vidéo.
ID de la vidéo YouTube	Chaîne alphanumérique à la fin de l’URL YouTube. Par exemple, dans la https://www.youtube.com/watch?v=AacDp2mUQ1I d’URL, l’ID de la vidéo YouTube est AacDp2mUQ1I. Ce champ n’est disponible que lorsque l’option Carte vidéo YouTube est sélectionnée.
Lien vers l’URL de l’image	Lien URL de l’image ou du fichier image. Pour définir ce champ, effectuez l’une des actions suivantes : Spécifiez le lien de l’URL en saisissant le texte du lien, en utilisant une pastille de données ou en utilisant un script. Chargez un fichier image en sélectionnant Charger une image. Ce champ n’est disponible que lorsque l’option Grande image avec texte ou Petite image avec texte est sélectionnée.
Texte alt de l'image	Texte alternatif lisible à l’écran qui décrit l’image pour les programmes d’accessibilité. Ce texte est utilisé avec l’image. Saisissez le texte à l’aide du champ de texte, de la pastille de données ou du script. Ce champ n’est disponible que lorsque l’option Grande image avec texte ou Petite image avec texte est sélectionnée.
Valeur par défaut
Valeur par défaut	Valeur prédéfinie pour la réponse de l’utilisateur à la question ou à l’invite. La réponse définie dans le champ de confirmation de la valeur par défaut demande à l’utilisateur de confirmer la valeur par défaut. Si l’utilisateur répond `par non`, la valeur devient nulle. La valeur par défaut peut être une chaîne de texte ou un script qui renvoie du texte. Par exemple, si vous utilisez la remontée pas à pas, la valeur par défaut peut être : `Variables de script > Dernier nom d’utilisateur`. Ou si vous utilisez un script, la valeur par défaut peut être : `{{vaScripts.lastUsername}}`.
Messages de confirmation
Confirmation de l'achèvement de l'entrée	Réponse de l’agent affichée à l’utilisateur lorsque l’interaction du nœud est terminée. Le message peut être une chaîne de texte ou un script qui renvoie du texte. Par exemple, si vous utilisez la remontée pas à pas : `Merci (variables d’entrée > nom d’utilisateur) !` Ou si vous utilisez un script, la confirmation peut être : `Merci, {{vaInputs.username}} !`
Confirmation de la valeur par défaut	Message qui demande à l’utilisateur de vérifier que la valeur dans le champ Par défaut est correcte. Ce message est utilisé à la place d’une valeur dans le champ Invite . Il peut contenir une chaîne de texte ou un script qui renvoie du texte. Par exemple, si vous utilisez la remontée pas à pas : `êtes-vous (variables d’entrée > nom d’utilisateur) ?` Ou si vous utilisez un script, le message de confirmation peut être : `Êtes-vous {{vaScripts.lastUsername}} ?`.
Commutation de conversation
Cette section n’est disponible que lorsque la détection NLU est activée sur l’instance.
Activer pour permettre aux utilisateurs de changer l'objet	Option permettant d’activer la prédiction NLU pour ce nœud. Si cette option est activée, les utilisateurs peuvent saisir du texte pour répondre aux questions, quel que soit le type de contrôle d’entrée utilisé. Virtual Agent utilise cet énoncé pour correspondre à une autre intention existante, ce qui permet à l’utilisateur de changer de rubrique.
Masquer ou ignorer ce nœud
Afficher conditionnellement ce nœud si	Déclaration de condition no-code ou script low-code qui spécifie une condition de présentation de ce nœud dans la conversation. La condition doit être évaluée comme vraie.
Autoriser l’utilisateur à ignorer ce nœud si	Instruction de condition no-code ou script low-code qui spécifie une condition permettant aux utilisateurs d’ignorer ce nœud dans la conversation.

Exemple de contrôle d’entrée utilisateur de choix dynamique pour la détection de rubriques NLU

Remarque :

Concepteur d'agent virtuel Les commandes peuvent s’afficher et fonctionner différemment dans d’autres canaux.


Propriétés d’entrée	Invite de liste
Figure 2. Propriétés de base du contrôle d’entrée de l’utilisateur Choix dynamique	Figure 3. Invite de liste de choix dynamique de l’interface utilisateur Web La liste de choix affiche 10 éléments par page. Lorsque 10 résultats ou plus sont renvoyés : La liste comprend un lien à la fin de la liste pour afficher plus de résultats. Une icône de recherche () s’affiche dans l’invite pour filtrer les résultats de recherche. Les utilisateurs sélectionnent l’icône pour ouvrir une zone de recherche et entrer le filtre. Lorsque vous sélectionnez plusieurs choix, vous pouvez effectuer une recherche dans le champ Rechercher des options pour filtrer les résultats de recherche. Sélectionnez ou tapez tous les choix qui s’appliquent, puis sélectionnez l’icône d’envoi .
	Figure 4. Invite de liste de choix dynamiques de l’interface utilisateur Web avec carte d’en-tête La liste de choix contient cinq éléments par page. Lorsque cinq résultats ou plus sont renvoyés, la liste offre la possibilité d’afficher d’autres résultats. Remarque : La fonctionnalité de recherche est supprimée lorsqu’une carte d’en-tête est utilisée.

Exemple d’expression de valeur de liste de choix dynamique

(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)

Le script dans la propriété Expression de valeur de choix définit et renvoie un tableau de choix. Dans l’exemple, le script crée un tableau appelé options et ajoute à ce tableau chaque enregistrement trouvé dans une requête GlideRecord. Chaque élément du tableau se voit attribuer une valeur dans les clés de valeur et d’étiquette à l’aide des données de ce GlideRecord. La propriété Table du contrôle définit la table utilisée par le script. Cet exemple de script utilise gr.setLimit(5) pour limiter le nombre d’enregistrements renvoyés à 5. Cette méthode permet d’éviter que les enregistrements renvoyés ne créent une liste de choix trop longue.

Tableau 1. Clés d’expression des valeurs du contrôle de choix dynamique
Clé	Description
valide	Valeur du choix. Lorsqu’un utilisateur sélectionne un choix dans le contrôle, cette valeur est stockée dans la variable nommée dans la propriété Nom de variable .
étiquette	L’étiquette qui apparaît pour ce choix dans la liste de choix.

Prise en charge des canaux

Tableau 2. Prise en charge des canaux pour le contrôle d’entrée utilisateur Choix dynamique
Canal	Prise en charge	Contraintes
Interface utilisateur Web	Pris en charge	Aucun
Interface utilisateur mobile	Pris en charge	Aucun
Panneau Now Assist	Pris en charge	Aucun
Microsoft Teams	Pris en charge	Aucun
Slack	Pris en charge	Les cartes d’en-tête ne sont pas prises en charge.
Workplace	Pris en charge	Les cartes d’en-tête ne sont pas prises en charge.
Facebook Messenger	Non pris en charge	Non applicable
SMS Twilio	Pris en charge	Les cartes d’en-tête ne sont pas prises en charge.
LINE	Non pris en charge	Non applicable
WhatsApp	Pris en charge	Aucun
Apple Messages for Business	Pris en charge	Aucun
Alexa (Voix)	Pris en charge	Pour les appareils à écran, utilisez le défilement tactile ; Clics sur les liens non pris en charge. Pour les appareils sans écran, utilisez la pagination vocale.