Utilitaire de bloc de rubriques

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture
  • Utilisez un bloc de rubriques dans une Agent virtuel conversation pour exécuter une fonction ou un flux secondaire spécifique qui exécute certaines étapes dans une rubrique d’appel.

    Propriétés de l’utilitaire de bloc de rubriques

    Pour plus d'informations, consultez Ajouter un bloc de rubriques réutilisable à une rubrique d’appel ou à un bloc de rubriques.

    Propriété Description
    Utiliser le bloc de rubriques dynamiques Définissez cette option pour activer les options de bloc de rubriques dynamiques.
    Bloc de rubriques Une liste des blocs de rubriques publiés. Sélectionnez un bloc de rubriques à ajouter à la rubrique d’appel.

    Lorsque l’option Utiliser le bloc de rubriques dynamiques est active, utilisez le créateur de conditions pour saisir une condition ou un script à la place.

    Nom du nœud Nom du nœud de bloc de rubriques. Le nom est automatiquement attribué en fonction du bloc de rubriques que vous sélectionnez. Par exemple, si vous choisissez le bloc de rubriques Recherche contextuelle Acme, le nom est Recherche contextuelle Acme.

    Lorsque l’option Utiliser le bloc de rubriques dynamiques est active, saisissez un nom de votre choix.

    Mappage d’entrée

    Les variables à utiliser comme entrée dans le bloc de rubriques sélectionné. Par exemple, l’image suivante a des exemples de variables :

    Dans cet exemple, les variables de mappage d’entrée comprennent l’ID de l’élément de catalogue, l’exécution de la recherche contextuelle, la confirmation de l’élément de catalogue et l’affichage de la carte de l’état de fin.

    Le contenu de cette zone change en fonction du bloc de rubriques que vous avez sélectionné. Les options peuvent inclure une entrée de chaîne, des enregistrements référencés, des scripts, etc.

    Lorsque l’option Utiliser le bloc de rubriques dynamique est active, vous ajoutez manuellement tous les mappages d’entrée en sélectionnant l’icône Gérer les entrées à définir (). Les entrées sont traitées de la même manière que la boîte de dialogue Paramètres d’entrée dans le segment Démarrer d’un bloc de rubriques réutilisable.

    Mappage de sortie

    Variables à générer par le bloc de rubriques sélectionné. Par exemple, l’image suivante comporte des exemples de variables qui sont activées :

    Dans cet exemple, les variables de mappage de sortie comprennent l’ID d’enregistrement, la table d’enregistrement et les variables d’option utilisateur.

    Le contenu de cette zone change en fonction du bloc de rubriques que vous avez sélectionné.

    Lorsque l’option Utiliser le bloc de rubriques dynamique est active, vous ajoutez manuellement tous les mappages d’entrée en sélectionnant l’icône Gérer les sorties à définir (). Les entrées sont traitées de la même manière que la boîte de dialogue Paramètres d’entrée dans le segment Démarrer d’un bloc de rubriques réutilisable.

    Avancés
    Masquer ce nœud
    Utiliser conditionnellement ce nœud si

    Une instruction de condition no-code ou un 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.

    Exemples d’utilitaires de bloc de rubriques

    Les propriétés de l’utilitaire de bloc de rubriques incluent la référence à un bloc de rubriques disponible, les variables de mappage d’entrée au bloc de rubriques et les variables de sortie transmises par le bloc de rubriques.Propriétés de l’utilitaire de bloc de rubriques lorsque le commutateur Utiliser le bloc de rubriques dynamiques est activé.

    Utilisation de blocs de rubriques dynamiques

    Le basculement du paramètre dynamique sur le bloc de rubriques vous permet de choisir par programmation le ou les blocs de rubriques à appeler, en fonction d’un nombre quelconque de conditions. Vous pouvez transmettre un ensemble dynamique d’entrées sans correspondance explicite et un-à-un pour une définition de bloc de rubriques.

    Par exemple, supposons que vous ayez deux blocs de rubriques. L’un définit votre mot de passe en prenant votre nom d’utilisateur et en renvoyant un message de réussite ou d’échec. L’autre réinitialise votre mot de passe, mais nécessite que vous envoyiez un jeton d’authentification à deux facteurs (2FA) avec la demande avant de renvoyer un message de réussite ou d’échec et un mot de passe temporaire.

    Vous pouvez créer deux invocations de bloc de rubriques distinctes pour gérer la procédure de réinitialisation du mot de passe, ou vous pouvez créer un bloc de rubriques avec le paramètre dynamique actif et défini comme suit :

    • Ajouter un script qui vérifie si le type de réinitialisation est includesTwoFactor = true. Si l’instruction est évaluée comme vraie, vous renvoyez TwoFactorReset, sinon vous renvoyez NormalPasswordReset.
    • Définissez deux mappages d’entrée : mot de passe et twoFactorToken, tous deux définis égaux à un objet transmis dans lequel contient leurs valeurs.
    • Définissez deux mappages de sortie : réussi et tempPass, ce dernier n’étant défini que s’il existe dans la valeur de retour du bloc de rubriques.
    • Définissez deux nœuds de sortie pour générer la réussite ou l’échec, ainsi qu’une sortie pour vous confirmer si la valeur tempPass est vraie.

    Exemple d’expression de bloc de rubriques dynamiques

    (function execute() {
        /* Return the name of the topic block to run. For example:
            switch (vaVars.car_make) {
                case 'Ford':
                    return 'Ford troubleshooting';
                case 'Toyota':
                    return 'Toyota troubleshooting';
                default:
                    return 'General car troubleshooting';
            }
        */
    })()

    Le script de l’expression de bloc de rubriques dynamique renvoie une valeur en fonction de votre entrée. Dans cet exemple, si vous entrez Ford ou Toyota, l’Agent virtuel appellera la rubrique de dépannage appropriée. Si vous entrez une autre valeur, Agent virtuel renvoie une rubrique de dépannage générale à la place.