Déboguer une Agent virtuel rubrique

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 minutes de lecture
  • Examinez et résolvez les comportements inattendus dans vos rubriques, blocs de rubriques et contrôles personnalisés Agent virtuel .

    Pour en savoir plus sur les problèmes liés à la détection de rubriques, reportez-vous à Résoudre les Compréhension du langage naturel problèmes de détection de rubrique (NLU).

    Dupliquer une rubrique active avant de la déboguer et de la modifier

    Dupliquez une rubrique plutôt que de mettre à jour une rubrique active. La rubrique d’origine non modifiée peut servir à la fois de référence et de sauvegarde, et conserver l’original vous permet de restaurer rapidement la rubrique. N’oubliez pas de désactiver la rubrique d’origine avant de publier le doublon.

    Déboguer une rubrique lors du test de vos conversations

    Lorsque vous créez ou mettez à jour une rubrique dans Concepteur d'agent virtuel, utilisez le bouton Test dans la barre d’en-tête de rubrique pour prévisualiser la conversation. La fenêtre de test de messagerie instantanée affiche la conversation telle qu’elle apparaît dans Portail de services. Les éléments de votre conversation peuvent s’afficher différemment dans les applications de messagerie tierces. Testez vos conversations dans toutes les applications tierces sur lesquelles vous avez l’intention de déployer Agent virtuel.

    La fenêtre de messagerie instantanée de test affiche quatre onglets qui fournissent des informations détaillées pour le débogage et l’affinement de votre rubrique : Analyser les phrases de test, Variables, Contexte et Journaux. Pour en savoir plus sur ces onglets, reportez-vous à la section Test NLU/ rubriques de mots clés. L’exemple suivant montre les messages de traitement et les erreurs consignés pendant le test.

    Journaux d’aperçu de conversation affichés dans la fenêtre d’aperçu de la rubrique.

    Surveillez les avertissements sur les contrôles dans votre rubrique

    Figure 1. Avertissements sur un nœud de rubrique dans l’onglet Flux
    Nombre d’avertissements affichés en rouge sur le canevas et sur les contrôles individuels. Pour le contrôle Entrée utilisateur de texte, le nom du nœud et l’invite sont obligatoires

    Les contrôles pour lesquels il manque des informations nécessaires affichent un badge rouge incomplet dans le coin supérieur gauche du contrôle. Le badge affiche un nombre indiquant le nombre de problèmes dans ce contrôle. Sélectionnez ce badge pour afficher une liste des problèmes dans le contrôle.

    Un autre badge d’avertissement apparaît dans le coin supérieur gauche du concepteur pour indiquer le nombre de problèmes dans l’ensemble de la rubrique.

    Rechercher les erreurs lorsque l’aperçu d’une rubrique ne s’exécute pas

    Figure 2. Erreurs d’aperçu de rubrique sur le canevas
    Fenêtre du validateur de rubrique donnant un aperçu des erreurs sur le canevas.

    Des informations supplémentaires s’affichent sous le canevas Concepteur d'agent virtuel lorsqu’une erreur empêche l’exécution de la rubrique. Le nombre total de problèmes est répertorié, ainsi que des détails et un lien hypertexte pour chacun d’eux. Sélectionnez un lien hypertexte pour accéder au nœud et utilisez les informations fournies pour corriger les erreurs dans votre conversation.

    Problèmes courants Agent virtuel

    Problème Résolution possible
    Impossible de voir le concepteur de module sous Conversational Interfaces
    • L’utilisateur n’a peut-être pas le rôle virtual_agent_admin.
    • Agent virtuel module d’extension n’est peut-être pas activé.
    Impossible de modifier une rubrique L’utilisateur connecté doit se trouver dans le même périmètre de l’application que la rubrique.
    Impossible de prévisualiser la rubrique
    • Assurez-vous que tous les champs obligatoires sont renseignés dans les propriétés du nœud.
    • Assurez-vous que votre navigateur est configuré pour autoriser les fenêtres contextuelles à partir de votre instance.
    Client Web bloqué lors de la connexion... Il manque peut-être une ou plusieurs de vos rubriques. Consultez la page Rubriques pour vous assurer que les rubriques sont présentes dans l’instance et à l’état Actif.

    Passer en revue les rubriques qui s’exécutent dans un flux de conversation

    Chaque Agent virtuel conversation (VA) dans une instance génère automatiquement un enregistrement d’interaction dans la table Interactions [interactions], qui consigne la conversation entre un demandeur et un agent virtuel et actif. Vous pouvez examiner la transcription de la conversation entre le demandeur et Virtual Agent, y compris les transferts d’agent en direct (si vous utilisez la Messagerie instantanée d’agent). Pour en savoir plus, consultez Enregistrements d’interaction d’Agent virtuel.