Déboguer une Agent virtuel rubrique

  • Rversion finale: Xanadu
  • Mis à jour 1 août 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écouverte de rubriques, reportez-vous Résoudre les Compréhension du langage naturel problèmes de découverte 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 afficher un aperçu de la conversation. La fenêtre de test de la 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 que 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 enregistrées 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 au sein de 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 les 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 lorsqu’un aperçu de rubrique ne s’exécute pas

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

    Des informations supplémentaires apparaissent sous le Concepteur d'agent virtuel canevas 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 les interfaces conversationnelles
    • L’utilisateur n’a peut-être pas le rôle virtual_agent_admin.
    • Agent virtuel Le 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é à Connexion en cours... Une ou plusieurs de vos rubriques peuvent être manquantes. Vérifiez 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 consulter la transcription de la conversation entre le demandeur et Virtual Agent, y compris les transferts d’agents actifs (si vous utilisez la Messagerie instantanée d’agent). Pour en savoir plus, consultez Enregistrements d’interaction d’Agent virtuel.