Contrôle d’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écouverte de rubriques LLM


Propriété	Description
Nom du nœud	Nom qui identifie ce nœud 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 la variable est automatiquement créé à partir de la propriété Nom du nœud .
Autoriser le remplissage automatique des créneaux	Activez cette option pour permettre à la valeur de ce nœud d’être définie automatiquement par d’autres nœuds, ainsi que lors de la découverte de rubriques. Lorsque cette option est activée, le champ Description détaillée passe d’un sélecteur de pastilles de données dynamique et d’options de script à un champ de texte statique.
Détailler la description	Description des informations dont vous avez besoin de la part des utilisateurs. Si l’option Autoriser le remplissage automatique des créneaux est désactivée, vous pouvez créer une description détaillée dynamique en sélectionnant l’icône Sélecteur de pour définir des conditions, ou sélectionnez l’icône Ouvrir l’éditeur pour entrer un script. Si l’option Autoriser le remplissage automatique des créneaux est activée, vous ne pouvez saisir qu’une description statique.
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’élément de carrousel dans cette rubrique.
Avancé (facultatif)
Appliquer l'invite utilisateur
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 grand modèle de langage (LLM). Vous pouvez créer des messages personnalisés en langage clair, saisir un script ou définir des conditions avec le sélecteur de pastilles de données.
Validation	Ajoutez un script pour valider l’entrée de l’utilisateur. Par exemple, vérifiez si l’utilisateur a entré une adresse e-mail valide.
Instructions supplémentaires pour LLM	Instructions supplémentaires au LLM, telles que l’ajout de formats de données, de restrictions ou de valeurs par défaut pour les réponses utilisateur. Vous pouvez créer des instructions supplémentaires en langage brut, saisir un script ou définir des conditions à l’aide du sélecteur de pastilles de données.
Masquer ou ignorer ce nœud
Afficher conditionnellement ce nœud si	Instruction de condition sans 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 ne s’applique pas lorsque le nœud de manège est utilisé dans le nœud Collecteur d’entrées.
Autoriser l’utilisateur à ignorer ce nœud si	Instruction de condition sans code ou script low-code qui spécifie une condition permettant aux utilisateurs d’ignorer ce nœud dans la conversation. La condition doit être évaluée comme vraie. Vous pouvez définir ce champ à l’aide du générateur de conditions ou d’un script. Si les utilisateurs saisissent une valeur telle que `Ignorer cette étape` lorsque les conditions ne l’autorisent pas, ils reçoivent un message indiquant que le nœud ne peut pas être ignoré et sont à nouveau invités à fournir une réponse.

Exemple de contrôle d’entrée sous forme de carrousel pour la découverte de rubriques LLM


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

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


Propriété	Description
Nom du nœud	Nom qui identifie ce nœud 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 la variable est automatiquement créé à partir de la propriété Nom du 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 vous appelez-vous ?`
Entité NLU	Option permettant d’associer une NLU entité au nœud. Si une NLU entité 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. Lorsque cette option est activée, les utilisateurs ne sont pas invités à confirmer l’entité extraite. Ce champ est disponible uniquement 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’élément de carrousel dans cette rubrique.
Aucun message de réponse d'enregistrement	Message affiché à l’utilisateur lorsque la recherche de table ne renvoie aucun enregistrement. Le message peut être une chaîne de texte ou un script qui renvoie du texte.
Avancés
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 Valeur par défaut demande à l’utilisateur de confirmer la valeur par défaut. Si l’utilisateur répond `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 une 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 une 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 Valeur par défaut est correcte. Ce message est utilisé au lieu 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 une 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 est disponible uniquement lorsque NLU la détection est activée sur l’instance.
Activer pour permettre aux utilisateurs de changer l'objet	Option permettant d’activer NLU la prédiction pour ce nœud. Si cette option est activée, les utilisateurs peuvent entrer du texte pour répondre aux questions, quel que soit le type de contrôle d’entrée utilisé. Agent virtuel 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	Instruction de condition sans 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 sans code ou script low-code qui spécifie une condition permettant aux utilisateurs d’ignorer ce nœud dans la conversation. La condition doit être évaluée comme vraie. Vous pouvez définir ce champ à l’aide du générateur de conditions ou d’un script.
Ignorer la resollicitation si	Instruction de condition sans code ou script low-code qui spécifie une condition permettant aux utilisateurs d’ignorer la resollicitation dans la conversation. Lorsqu’un nœud précédent est revisité via un bouclage de rubrique ou une action de boîte de dialogue, Agent virtuel contourne ce nœud et conserve automatiquement sa valeur d’origine.

Exemple de contrôle d’entrée de carrousel pour la découverte 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 d’interface utilisateur Web
	Figure 3. ServiceNow Mobile Invite de carrousel

Exemple d’expression d’é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'
                'Card_name': 'AcmeCard'
                'Card_data': {"identifier":"IT hardware and software","header":"Acme keyboard model 200","description":"The model 200 keyboard is a ten-key-less keyboard."}
            }
       );
       options.push(
            {
                'Name': 'Item 2',
                'Value': 'item_2',
                'Description': 'Acme keyboard model 300',
                'Body': 'https://images.pexels.com/photos/916472/pexels-photo-916472.jpeg'
                'Card_name': 'AcmeCard'
                'Card_data': {"identifier":"IT hardware and software","header":"Acme keyboard model 300","description":"The model 300 keyboard is a full-size keyboard with a ten-key pad."}
            }
       );
       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 de nom, de valeur et de 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 de carrousel. Ce nom est affiché sous l’image sur le carrousel.
Valeur	Valeur pour 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 qui décrit l’élément de carrousel. La description est affichée sous le nom de l’image. Un carrousel avec plus de trois éléments affiche des flèches gauche et droite pour faire défiler les images et un bouton Sélectionner sous chaque élément. Si une description compte 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 une URL pour un fichier image.
Card_name	En-tête de chaîne de texte identifiant la carte affichée dans le carrousel.
Card_data	Tableau contenant des chaînes de texte à présenter sur la carte. Les valeurs comprennent l’identificateur, l’en-tête et la description.

Prise en charge du canal

Tableau 2. Prise en charge du canal pour le contrôle d’entrée de l’utilisateur sous forme de carrousel
Canal	Prise en charge LLM	Prise en charge NLU/mot clé	Contraintes
Interface utilisateur Web	Non pris en charge	Pris en charge	Aucun
Interface utilisateur mobile	Non pris en charge	Pris en charge	Aucun
Panneau Now Assist	Non pris en charge	Pris en charge	Aucun
Microsoft Teams	Non pris en charge	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	Non pris en charge	Pris en charge	Aucun
Workplace	Non pris en charge	Pris en charge	Aucun
Facebook Messenger	Non pris en charge	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 pris en charge	Non applicable
LINE	Non pris en charge	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é figure dans la table Propriétés système [sys_properties].
WhatsApp	Non pris en charge	Pris en charge	Aucun
Apple Messages for Business	Non pris en charge	Pris en charge	Aucun
Alexa (Voix)	Non pris en charge	Pris en charge	Pour les appareils à écran, utilisez le défilement tactile. Pour les appareils autres que l’écran, utilisez la pagination vocale.