Contrôle de l’entrée de l’utilisateur de choix dynamique
Utilisez le contrôle d’entrée utilisateur Choix dynamique dans une Agent virtuel rubrique pour créer dynamiquement une liste de choix disponibles pour vos utilisateurs. Créez ces choix en interrogeant une table ou en utilisant un script pour les créer dynamiquement.
Affichage de la liste de choix
La liste de choix dynamique contient jusqu’à 10 éléments par page. Lorsqu’il existe plus de 10 éléments, vous pouvez afficher les éléments supplémentaires et filtrer les résultats de la recherche. L’invite de la liste de choix contient une icône de recherche que les utilisateurs peuvent sélectionner pour filtrer les résultats.
Si la sélection de plusieurs choix est activée, vous pouvez effectuer une recherche dans le champ Rechercher des options pour filtrer les résultats de la recherche. Sélectionnez ou tapez tous les choix qui s’appliquent, puis sélectionnez . Lorsque vous envoyez vos choix par le biais d’une rubrique LLM, le LLM répond en indiquant si vos choix répondent aux critères de validation.
Vous pouvez également sélectionner un ou plusieurs choix dans une liste dans une conversation LLM en saisissant un énoncé dans la fenêtre de messagerie instantanée. S’il n’y a pas de correspondance pour votre entrée, le vous informe qu’il Agent virtuel ne s’agit pas d’un choix valide et vous invite à essayer une autre entrée.
-
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 fonction 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, consultez Ajouter une propriété système.
Si vous renseignez un nœud de liste de choix dynamique avec un seul choix, lors du test ou de l’utilisation du nœud, vous recevez un message indiquant « Nous avons [choix] en tant que [nom du nœud], est-ce correct ? ». Utilisez les choix multiples dans le nœud de liste de choix dynamique pour éviter de recevoir ce message.
Vous pouvez également modifier le contenu du message en accédant à et la modification de la glide.cs.retry_question_message propriété système. Cette valeur de message est par défaut une chaîne Nous avons {0} comme {1}, est-ce correct ? et est utilisé pour le remplissage d’emplacements dans plusieurs cas en dehors de la liste de choix dynamique. Toutes les modifications que vous apportez sont reflétées dans chaque utilisation de cette propriété.
Propriétés du contrôle de l’entrée de l’utilisateur de choix dynamique 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 . |
| 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 ? Vous pouvez créer du texte enrichi pour modifier le style de l’invite :
|
| 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. |
| Choix | |
| Renseignez les choix par |
Type de variable dynamique à utiliser. Sélectionnez l'une des options suivantes :
|
| Table |
Table dans laquelle rechercher, disponible uniquement si vous avez sélectionné Enregistrement comme méthode de remplissage des choix. |
| Choix de filtres |
Option permettant d’utiliser le Concepteur d'agent virtuel générateur de conditions ou de fournir un script. Sélectionnez l'une des options suivantes :
|
| Autoriser l'utilisateur à sélectionner plus d'un choix |
Option permettant aux utilisateurs de choisir plusieurs choix dans la liste de choix. |
| 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 | |
| Carte d'en-tête |
Activez/désactivez cette option pour ouvrir un champ afin d’ajouter des cartes qui peuvent inclure des images ou des vidéos YouTube. Pour plus d'informations, voir Insérer une carte d’en-tête dans un contrôle de choix statique ou de choix dynamique |
| 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 utilisateur de choix dynamique pour la découverte de rubriques LLM
| Propriétés d’entrée | Invite utilisateur de liste |
|---|---|
|
|
La liste de choix affiche 10 éléments par page. Lorsque 10 résultats ou plus sont renvoyés :
|
Choix dynamique Propriétés du contrôle d’entrée utilisateur 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 ? Vous pouvez créer du texte enrichi pour modifier le style de l’invite :
|
| 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. |
| Choix | |
| Renseignez les choix par |
Type de variable dynamique à utiliser. Sélectionnez l'une des options suivantes :
|
| Table |
Table dans laquelle rechercher, disponible uniquement si vous avez sélectionné Enregistrement comme méthode de remplissage des choix. |
| Choix de filtres |
Option permettant d’utiliser le Concepteur d'agent virtuel générateur de conditions ou de fournir un script. Sélectionnez l'une des options suivantes :
|
| Autoriser l'utilisateur à sélectionner plus d'un choix |
Option permettant aux utilisateurs de choisir plusieurs choix dans la liste de choix. |
| 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 | |
| Carte d'en-tête |
Activez/désactivez cette option pour ouvrir un champ afin d’ajouter des cartes qui peuvent inclure des images ou des vidéos YouTube. Pour plus d'informations, voir Insérer une carte d’en-tête dans un contrôle de choix statique ou de choix dynamique |
| 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 utilisateur de choix dynamique pour la découverte de rubrique NLU
| Propriétés d’entrée | Invite de liste |
|---|---|
La liste de choix affiche 10 éléments par page. Lorsque 10 résultats ou plus sont renvoyés :
|
|
La liste de choix contient cinq éléments par page. Lorsque cinq résultats ou plus sont renvoyés, la liste offre une option permettant d’afficher plus de résultats. Remarque : La fonctionnalité de recherche est supprimée lorsqu’une carte d’en-tête est utilisée. |
Exemples de scripts de choix dynamique
(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;
})()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 de 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 chaque enregistrement trouvé dans une requête GlideRecord à ce tableau. Chaque élément du tableau reçoit 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. L’utilisation de cette méthode permet d’éviter que les enregistrements renvoyés ne créent une liste de choix trop longue.
| 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 | Étiquette qui apparaît pour ce choix dans la liste de choix. |
Prise en charge du canal
| Canal | Prise en charge LLM | Prise en charge NLU/mot clé | Contraintes |
|---|---|---|---|
| Interface utilisateur Web | Non pris en charge | Pris en charge | Néant |
| Interface utilisateur mobile | Non pris en charge | Pris en charge | Néant |
| Panneau Now Assist | Non pris en charge | Pris en charge | Néant |
| Microsoft Teams | Pris en charge | Pris en charge | Néant |
| Slack | Non pris en charge | Pris en charge | Les cartes d’en-tête ne sont pas prises en charge. |
| Workplace | Non pris en charge | Pris en charge | Les cartes d’en-tête ne sont pas prises en charge. |
| Facebook Messenger | Non pris en charge | Non pris en charge | Non applicable |
| SMS Twilio | Non pris en charge | Pris en charge | Les cartes d’en-tête ne sont pas prises en charge. |
| LINE | Non pris en charge | Non pris en charge | Non applicable |
| Pris en charge | Pris en charge | Néant | |
| Apple Messages for Business | Non pris en charge | Pris en charge | Néant |
| Alexa (Voix) | Non pris en charge | Pris en charge | Pour les appareils à écran, utilisez le défilement tactile ; Cliquer sur des liens n’est pas pris en charge. Pour les appareils autres que l’écran, utilisez la pagination vocale. |