Créer un bloc de rubriques réutilisable

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 5 minutes de lecture

    • Créez un composant réutilisable qui exécute un flux secondaire spécifique de tâches et d’éléments conversationnels dans Agent virtuel les conversations.

    Avant de commencer

    Conseil :
    Les développeurs et les auteurs de rubriques peuvent avoir besoin d’accéder à des blocs de rubriques créés dans d’autres périmètres de l’application. Pour leur donner accès, reportez-vous à la section Créez des privilèges d’accès entre périmètres pour les blocs de rubriques et les contrôles personnalisés.

    Rôle requis : virtual_agent_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Utilisez des blocs de rubriques pour exécuter des étapes courantes, telles que la récupération de certains enregistrements.

    Procédure

    1. Accédez à la Tout > Interfaces conversationnelles > Agent virtuel > Concepteur.
    2. Sur la page Rubriques , effectuez l’une des actions suivantes :
      • Pour créer un bloc de rubriques à partir de zéro, sélectionnez + Créer.
      • Pour créer un bloc de rubriques basé sur un bloc de rubriques prédéfini, ouvrez-le et procédez comme suit :
        1. Dans la barre d’en-tête, sélectionnez Dupliquer.
        2. Saisissez le nom du nouveau bloc et sélectionnez Enregistrer.
    3. Renseignez les champs de la feuille.
      Tableau 1. Feuille de propriétés du bloc de rubriques
      Champ Description
      Type

      Liste des éléments que vous pouvez créer dans Concepteur d'agent virtuel.

      Sélectionnez Bloc de rubriques et définissez les propriétés supplémentaires.
      Remarque :
      Une fois que vous avez défini cette rubrique comme bloc de rubriques, vous ne pouvez pas la transformer en rubrique normale.
      Nom Nom unique du bloc de rubriques qui reflète son objectif fonctionnel. Ce nom apparaît dans la liste des blocs de rubriques que les auteurs de rubriques peuvent choisir lors de la création ou de la mise à jour d’une rubrique.
      Description Brève explication de l’objectif du bloc de rubriques. Par exemple, pour récupérer des enregistrements.
      Propriétés avancées (facultatif)
      Qui peut accéder à cette rubrique
      Canaux

      Clients de messagerie instantanée dans lesquels la rubrique ou le bloc de rubriques s’exécutera.

      Ces canaux sont différents des canaux par défaut qui sont pris en charge nativement par Agent virtuel. Votre instance peut disposer de canaux supplémentaires pour des intégrations de messagerie instantanée personnalisées . Pour en savoir plus sur les canaux, reportez-vous à la section Déployer des Agent virtuel rubriques dans d’autres canaux.
      Agent actif
      Variables de contexte de l'agent actif Les variables de contexte de l’agent actif qui sont définies dans les paramètres généraux de la messagerie instantanée.

      Sélectionnez les variables qui fournissent un contexte dynamique, c’est-à-dire des informations provenant de la Agent virtuel messagerie instantanée. Ces informations sont transférées de la conversation du bot à l’agent actif.

      Pour en savoir plus sur la liste par défaut des variables de l’agent actif, reportez-vous à la section Variables de contexte de chat d’agent actif.
      Disponible pour le pilote automatique de l'agent Commutateur qui détermine si le bloc de rubriques est disponible pour un agent actif.

      Lorsque cette option est activée, un agent peut rechercher la rubrique et l’appeler. Pour plus d’informations, consultez Pilote automatique de conversation.
      Disponible dans la palette
      Activer Commutateur qui détermine si le bloc de rubriques apparaît comme sa propre icône dans la section Utilitaires de la palette de l’onglet Flux . Les autres auteurs peuvent ainsi accéder facilement au bloc de rubriques.
      Supplémentaire
      Catégories Catégorie qui contient ce bloc. Vous pouvez définir des catégories de rubriques personnalisées pour vos blocs de rubriques.
    4. Sélectionnez Créer.
      L’onglet Flux s’ouvre. Le canevas affiche un flux avec un nœud de début et de fin .
    5. Pour définir une entrée dans le bloc, procédez comme suit :
      1. Sélectionnez le nœud de démarrage dans le canevas.
      2. Dans la feuille Propriétés du segment de départ, sélectionnez + Ajouter
      3. Renseignez les champs de la feuille.
        Tableau 2. Boîte de dialogue Ajouter une entrée
        Champ Description
        Nom Nom de la variable d’entrée qui stocke la valeur d’entrée.
        Type Type de données transmises au bloc de rubriques. Par exemple, chaîne, booléen, etc.

        Les champs changent en fonction de votre choix. Pour plus d'informations, consultez Entrer des types de données dans des Agent virtuel rubriques.
        Obligatoire Option permettant de définir le paramètre selon les besoins.
        Conseil Info-bulle visible lors de la création d’une rubrique d’appel. Reportez-vous à l’exemple suivant :

        Info-bulle de mappage de variables d’entrée dans cet exemple affichant « Tester la chaîne d’indices ».
        Table ServiceNow Table utilisée pour demander une entrée.

        Ce champ n’est disponible que lorsque Référence ou Tableau.Référence est sélectionné dans le champ Type .
        Nombre maximum de lignes Nombre maximal de lignes que le bloc de rubriques est autorisé à définir.

        Ce champ n’est disponible que lorsque l’option Tableau est sélectionnée dans le champ Type .
        Valeur par défaut Valeur par défaut pour la variable. Cette valeur peut être utilisée lors de l’aperçu du bloc.

        Les valeurs par défaut en double ne sont pas autorisées pour les types de données de tableau.
        Par exemple, le bloc de rubriques Recherche contextuelle prédéfini fournit les paramètres d’entrée suivants :

        Les paramètres d’entrée du bloc de rubriques Recherche contextuelle comprennent le contexte, la requête, le portail et kb_knowledge_base.

      4. Sélectionnez Enregistrer.
      La rubrique ou le bloc de rubriques d’appel transmet les paramètres d’entrée au bloc de rubriques.
    6. Faites glisser Concepteur d'agent virtuel les commandes sur le canevas.
      Ces contrôles comprennent l’entrée, les réponses du bot et les utilitaires. Utilisez-les en combinaison pour définir la logique exécutée dans le bloc de rubriques. Pour plus d'informations, consultez Concepteur d'agent virtuel Contrôles.
    7. Pour définir la sortie renvoyée par le bloc de rubriques, procédez comme suit :
      1. Sélectionnez le nœud de fin dans le canevas.
      2. Dans la feuille Propriétés du segment final, cliquez sur + Ajouter nouveau.
      3. Renseignez les champs suivants sur la feuille.
        • Nom : nom de la valeur renvoyée à partir du bloc de rubriques.
        • Valeur : chaîne avec des variables ou script pouvant être utilisé dans la rubrique d’appel. La valeur est présentée sous forme de pastilles de données pour les variables d’entrée que vous avez définies (la valeur par défaut spécifiée dans les paramètres d’entrée et les valeurs d’entrée du nœud dans le bloc de rubriques).
        Par exemple, le bloc de rubriques Recherche contextuelle prédéfini transmet les paramètres de sortie suivants :

        Les paramètres de sortie du bloc de rubriques Recherche contextuelle incluent Résultats retournés et Résultats utiles.

      4. Cliquez sur Enregistrer.
      Lorsque le bloc de rubriques termine son exécution dans la rubrique d’appel, il peut transmettre des variables de sortie à la rubrique d’appel.
    8. Pour voir comment le bloc de rubriques s’exécute, sélectionnez Test.
      Par exemple, le bloc de rubriques Recherche contextuelle a renvoyé les résultats suivants, y compris un message d’aperçu uniquement avec les valeurs de sortie. Le message d’aperçu vous aide à vérifier les sorties attendues et n’est pas visible par vos utilisateurs.

      La fenêtre d’aperçu affiche la conversation de messagerie instantanée et une section d’aperçu uniquement qui affiche les variables de sortie et leurs valeurs. Par exemple, « results_helpful » : vrai.

    9. Si vous êtes prêt à rendre le bloc de rubriques disponible pour une utilisation dans les rubriques d’appel, procédez comme suit :
      1. Supprimez les paramètres par défaut que vous avez utilisés pour le test.
      2. Sélectionnez Enregistrer, puis cliquez sur Publier.
      L’état du bloc de rubriques devient Actif et est prêt à être utilisé pour appeler des rubriques.

    Que faire ensuite

    Ajouter un bloc de rubriques réutilisable à une rubrique d’appel ou à un bloc de rubriques.