Contrôle de l’entrée de l’utilisateur sous forme de carrousel

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.

Propriétés du contrôle d’entrée de carrousel pour la détection de rubriques LLM


Propriété	Description
Nom du nœud	Nom qui identifie ce nœud de contrôle d’entrée de l’utilisateur sous forme de carrousel dans le flux de rubriques.
Nom de variable	Nom de la variable qui stocke la sélection effectuée par l’utilisateur. Le nom de variable est automatiquement créé à partir de la propriété Nom de nœud .
Détailler la description	Description des informations dont vous avez besoin de la part des utilisateurs.
Définir des éléments de carrousel	Utilisez un script pour créer des éléments à sélectionner dans votre carrousel. Le script doit renvoyer un tableau contenant un ou plusieurs éléments. Consultez la section Exemple d’expression d’un élément de carrousel dans cette rubrique.
Avancé (facultatif)
Appliquer l’invite utilisateur
Appliquer l’invite utilisateur	Basculez pour ouvrir le champ d’invite utilisateur . La valeur dans le champ Invite utilisateur s’affiche aux utilisateurs plutôt que le message généré par LLM. Vous pouvez créer des messages personnalisés à l’aide d’un langage simple, de scripts 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. Ce champ n’est pas applicable lorsque le nœud Carrousel est utilisé dans le nœud Collecteur d’entrée.

Exemple de contrôle d’entrée Carrousel pour la détection de rubriques LLM


Propriétés du carrousel	Invite de carrousel
	Figure 1. Invite de carrousel de l’interface utilisateur Web

Propriétés du contrôle d’entrée de carrousel pour la détection de rubriques NLU


Propriété	Description
Nom du nœud	Nom qui identifie ce nœud de contrôle d’entrée de l’utilisateur sous forme de carrousel dans le flux de rubriques.
Nom de variable	Nom de la variable qui stocke la sélection effectuée par l’utilisateur. 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.
Définir des éléments de carrousel	Utilisez un script pour créer des éléments à sélectionner dans votre carrousel. Le script doit renvoyer un tableau contenant un ou plusieurs éléments. Consultez la section Exemple d’expression d’un élément de carrousel dans cette rubrique.
Aucun message de réponse d'enregistrement	Message à l’utilisateur indiquant qu’aucun enregistrement n’a été trouvé. Le message peut être une chaîne de texte ou un script qui renvoie du texte.
Avancé
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 Carrousel 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 du carrousel	Invite de carrousel
	Figure 2. Invite de carrousel de l’interface utilisateur Web
	Figure 3. ServiceNow Mobile invite de carrousel

Exemple d’expression d’un élément de carrousel

(function execute() {
    var options = [];
       options.push(
            {
                'Name': 'Item 1',
                'Value': 'item_1',
                'Description': 'Acme keyboard model 200',
                'Body': 'https://images.pexels.com/photos/688666/pexels-photo-688666.jpeg'
            }
       );
       options.push(
            {
                'Name': 'Item 2',
                'Value': 'item_2',
                'Description': 'Acme keyboard model 300',
                'Body': 'https://images.pexels.com/photos/916472/pexels-photo-916472.jpeg'
            }
       );
       return options;

})()

Le script de la propriété Expression d’élément de carrousel définit et renvoie un tableau contenant les éléments qui apparaissent dans votre carrousel. Les éléments de ce tableau doivent contenir des clés Nom, Valeur et Corps . Dans l’exemple, le script crée un tableau appelé options et ajoute deux éléments, chacun avec les clés requises. Les images ici sont codées en dur à titre d’exemple.

Tableau 1. Exemple de clé de code
Clé	Description
Nom	Nom de l’élément carrousel. Ce nom est affiché sous l’image sur le carrousel.
Valeur	Valeur de l’élément. Lorsqu’un utilisateur sélectionne un élément de carrousel, cette valeur est stockée dans la variable nommée dans la propriété Nom de variable .
Description	Chaîne de texte décrivant l’élément de carrousel. La description est affichée sous le nom de l’image. Un carrousel de plus de trois éléments affiche des flèches gauche et droite pour faire défiler les images, ainsi qu’un bouton Sélectionner sous chaque élément. Si une description fait plus de 140 caractères, les utilisateurs peuvent développer le contenu.
Détails	Image utilisée dans l’élément de carrousel. La valeur est l’URL d’un fichier image.

Prise en charge des canaux

Tableau 2. Prise en charge des canaux pour le contrôle d’entrée utilisateur Carrousel
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. Si le carrousel contient plus de 10 éléments, les utilisateurs doivent sélectionner Suivant pour examiner les éléments restants.
Slack	Pris en charge	Aucun
Workplace	Pris en charge	Aucun
Facebook Messenger	Pris en charge	Le titre d’une image a une limite maximale de 40 caractères. Le texte de l’image a une limite de caractères maximale de 60 caractères. Un utilisateur ne peut afficher que 10 images à la fois. S’il y a plus de 10 images, le format de pagination est utilisé pour afficher plus d’options. La valeur par défaut du nombre maximal d’images dans un carrousel pour une page est définie dans la sn_va_fb_messenger.max_carousel_cards propriété système. Cette propriété se trouve dans la table Propriétés système [sys_properties].
SMS Twilio	Non pris en charge	Non applicable
LINE	Pris en charge	Le titre d’une image a une limite maximale de 40 caractères. Le texte de l’image a une limite de caractères maximale de 60 caractères. Un utilisateur ne peut afficher que 10 images à la fois. S’il y a plus de 10 images, le format de pagination est utilisé pour afficher plus d’options. La valeur par défaut du nombre maximal d’images dans le carrousel pour une page est définie dans la sn_va_line.max.carousel.cards propriété système. La propriété se trouve dans la table Propriétés système [sys_properties].
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. Pour les appareils sans écran, utilisez la pagination vocale.