Déboguer une Agent virtuel rubrique

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture
  • Examinez et résolvez les comportements inattendus de 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 rubrique LLM dans Agent virtuel et Résoudre Compréhension du langage naturel les problèmes de découverte de rubriques (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. Les é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 Rubriques de test NLU/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 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 des informations nécessaires affichent un badge rouge incomplet dans l’angle 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 du sujet.

    Rechercher des erreurs lorsqu’un aperçu de rubrique ne s’exécute pas

    Figure 2. Erreurs d’aperçu des rubriques 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 sont répertoriés, 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’est peut-être pas le virtual_agent_admin rôle.
    • 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 d’afficher un aperçu de 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.
    widget de messagerie instantanée bloqué lors de la connexion... Une ou plusieurs de vos rubriques sont peut-être manquantes. Vérifiez 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) 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 l’agent virtuel, y compris les transferts d’agents actifs (si vous utilisez la Messagerie instantanée d’agent). Pour plus d’informations, consultez Enregistrements d’interaction d’Agent virtuel.