Déboguer une Agent virtuel rubrique

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 de découverte de rubriques, reportez-vous aux sections Découverte de rubriques LLM dans Agent virtuel et Résoudre Compréhension du langage naturel les 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 la conservation de 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 tout en testant 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 la rubrique pour prévisualiser la conversation. La fenêtre de test de la messagerie instantanée affiche la conversation telle qu’elle apparaît dans Portail de services. Certains éléments de votre conversation peuvent apparaître 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 le perfectionnement de votre rubrique : Analyser les phrases de test, les variables, le contexte et les journaux. Pour en savoir plus sur ces onglets, reportez-vous à la section Test en cours 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 la conversation affichés dans la fenêtre d’aperçu de la rubrique.

    Surveiller les avertissements sur les contrôles 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 d’entrée de l’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 canevas pour indiquer le nombre de problèmes dans l’ensemble de la rubrique.

    Rechercher les erreurs lorsqu’un aperçu de rubrique n’est pas exécuté

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

    Des informations supplémentaires s’affichent dans un onglet Problèmes de validation sur la barre latérale du canevas lorsqu’une erreur empêche l’exécution de Concepteur d'agent virtuel la rubrique. Le nombre total de problèmes est répertorié, ainsi que des détails et un lien hypertexte pour chaque nœud. Sélectionnez un lien hypertexte pour accéder au nœud et utilisez les informations fournies pour corriger toute erreur dans votre conversation. Vous pouvez fermer l’onglet sans corriger les problèmes, mais tant qu’ils ne sont pas corrigés, l’onglet Problèmes de validation s’affiche lorsque vous sélectionnez Publier. L’onglet Problèmes de validation se ferme si vous sélectionnez Publier après avoir corrigé tous les problèmes.

    Problèmes courants Agent virtuel

    Problème Résolution possible
    Impossible d’afficher le concepteur de module sous 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 d’afficher un aperçu de la rubrique
    • Assurez-vous que tous les champs obligatoires sont renseignés dans les propriétés de nœud.
    • Assurez-vous que votre navigateur est configuré pour autoriser les fenêtres contextuelles à partir de votre instance.
    widget de messagerie instantanée bloqué lors de la connexion... Il manque peut-être une ou plusieurs de vos rubriques. Vérifiez les pour vous assurer que les rubriques sont présentes sur 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) d’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 l’agent virtuel, 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.