Le rapport Aperçu inclut les indicateurs clés de performance suivants pour les conversations textuelles et vocales.

• Nombre total de conversations : nombre total de conversations, qui se compose des conversations terminées, non terminées et en cours. Quel que soit le statut, une conversation peut être composée d'un ou plusieurs tours de dialogue. Chaque tour est un échange unique entre l'utilisateur et la brique.
  Remarque
  
  Les conversations ne sont pas les demandes mesurées. Pour en savoir plus sur les mesures, reportez-vous à Descriptions de service de crédits universels Oracle PaaS et IaaS.
• Conversations terminées : conversations qui se sont terminées en répondant à la requête d'un utilisateur. Les conversations qui se terminent par un état de fin de flux ou à un état où le flux de fin (implicite) est sélectionné comme transition sont considérées comme terminées. Dans les briques rédigées par YAML, les conversations sont comptabilisées comme terminées lorsque la traversée du flux de dialogue se termine par une transition return ou à un état avec la propriété insightsEndConversation.
  Remarque
  
  Cette propriété et la transition return ne sont pas disponibles dans Visual Flow Designer.
• Conversations non terminées : conversations que les utilisateurs n'ont pas terminées car ils ont abandonné la brique ou n'ont pas pu terminer en raison d'erreurs au niveau du système, d'expirations ou de boucles infinies.
• Conversations en cours : conversations en cours de traitement (conversations qui n'ont pas encore abouti et n'ont pas expiré). Cette mesure effectue le suivi des conversations à plusieurs niveaux. Une conversation en cours expire après l'expiration d'une session.
• Temps moyen passé sur les conversations : durée moyenne de toutes les conversations de la brique.
• Nombre total d'utilisateurs et Nombre d'utilisateurs uniques – Mesures de base utilisateur qui indiquent le nombre d'utilisateurs dont dispose une brique et le nombre d'utilisateurs renvoyant des utilisateurs.

Toute conversation commençant par une interaction vocale est considérée comme une conversation vocale. Toute conversation démarrée par voix, mais terminée par texte, est considérée comme une conversation basculée. Toutes les autres conversations sont considérées comme des conversations textuelles. Outre les mesures standard, le rapport Aperçu inclut les mesures suivantes, propres aux conversations vocales et basculées. Pour visualiser ces mesures, désactivez Comparer les conversations textuelles et vocales, puis sélectionnez le mode Tout ou Voix.

• Temps moyen passé sur les conversations : durée moyenne des conversations vocales.
• Facteur temps réel moyen : ratio du temps nécessaire au traitement de l'entrée audio par rapport au temps UC. Par exemple, si une seconde de temps UC est nécessaire pour traiter une seconde d'audio, le facteur temps réel est de 1 (1/1). Si 500 millisecondes sont nécessaires pour traiter une seconde d'audio, le facteur temps réel est de 0,5 ou ½. Idéalement, le facteur temps réel doit être inférieur à 1 pour que le traitement ne soit pas décalé par rapport à l'entrée audio. Si le facteur temps réel est supérieur à 1, contactez le support technique Oracle.
• Latence vocale moyenne : délai, en millisecondes, entre la détection de la fin de la variation et la génération du résultat final (ou de la transcription). Si vous observez une latence, contactez le support technique Oracle.
• Temps audio moyen : durée moyenne, en secondes, de toutes les conversations vocales.
• Conversations commutées : pourcentage des conversations de la brique qui ont commencé par des commandes vocales, mais qui ont dû basculer sur du texte pour terminer l'interaction. Cette mesure indique que plusieurs parcours d'exécution ont été impliqués dans le passage de la voix au texte.
  
  
  Description de l'image voice-metrics.png
  
  

S'il existe des conversations non terminées au cours de la période sélectionnée, le nombre total est réparti dans les catégories d'erreur suivantes :

• Expirations : les expirations sont déclenchées lorsqu'une conversation en cours est inactive pendant plus d'une heure, ce qui entraîne l'expiration de la session.
• Erreurs gérées par le système : ces erreurs sont gérées par le système et non par la brique. Ces erreurs se produisent lorsque la définition de flux de dialogue n'est pas équipée de la gestion des erreurs.
• Boucle infinie : des boucles infinies peuvent se produire en raison de défauts dans la définition de flux de dialogue, tels que des transitions mal définies.
• Annulé : nombre de fois où les utilisateurs ont quitté une brique en annulant explicitement la conversation.

En cliquant sur une catégorie d'erreur dans la table ou sur l'un des arcs du graphique, vous pouvez accéder au rapport Conversations pour voir ces erreurs dans le contexte des conversations non terminées. Lorsque vous accédez au rapport Conversations à partir d'ici, les filtres Résultat et Erreurs du rapport sont définis sur Non terminé et sur la catégorie d'erreur sélectionnée. Par exemple, si vous cliquez sur Boucle infinie, le rapport Conversations est filtré sur Non terminé et Boucle infinie. Les filtres Intentions et Résultat du rapport sont définis sur Afficher tout, et le champ Trier par est défini sur Elément le plus récent.

Vous pouvez connaître le nombre d'utilisateurs dont dispose une brique pour un point dans le temps sélectionné à l'aide des mesures suivantes. Vous pouvez les comparer au total en cours affiché dans la mesure Nombre total de conversations lors du filtrage du rapport par canal et période. Pour les intégrations d'agent en direct, vous pouvez évaluer le nombre d'utilisateurs uniques transférés à un agent par rapport au nombre total de conversations qui inclut les transferts d'agent en direct et les conversations gérées par la brique.

• Nombre d'utilisateurs : total en cours d'exécution de tous les types d'utilisateur qui ont interagi avec la brique : utilisateurs avec des ID affectés par canal qui persistent d'une session à l'autre (les utilisateurs uniques) et utilisateurs dont les ID affectés automatiquement durent pour une seule session.
• Nombre d'utilisateurs uniques : nombre d'utilisateurs ayant accédé à la brique, identifié par leurs ID utilisateur uniques. Chaque canal a une méthode différente pour affecter un ID à un utilisateur : les utilisateurs qui discutent avec la brique via le canal Web sont identifiés par la valeur définie pour le champ userId, par exemple. Le canal de test du testeur de briques vous affecte un nouvel ID utilisateur chaque fois que vous terminez une session de discussion en cliquant sur Réinitialiser.
  Une fois affectés, ces ID uniques persistent dans les sessions de discussion de sorte que le nombre d'utilisateurs uniques comptabilisé par cette mesure n'augmente pas lorsqu'un utilisateur revient sur la brique. Le nombre augmente uniquement lorsqu'un autre utilisateur affecté avec un ID unique est ajouté au pool d'utilisateurs.

  Conseil :

  Comme les ID utilisateur ne sont uniques qu'au sein d'un canal (un utilisateur ayant des ID identiques sur deux canaux différents sera compté comme deux utilisateurs, pas un), vous pouvez avoir une meilleure idée de la base d'utilisateurs en filtrant le rapport par canal.

Pour suivre les utilisateurs qui n'ont jamais interagi avec une brique ou un assistant numérique, activez l'option Activer les mesures utilisateur d'analyse dans Paramètres > Configuration. Avant d'activer cette fonctionnalité pour une brique, assurez-vous que les canaux qui y sont acheminés lui affectent un type d'ID utilisateur. Sinon, laissez cette fonction désactivée (son mode par défaut). Chaque fois que les canaux ne fournissent pas d'ID utilisateur, Digital Assistant affecte un nouvel ID utilisateur à chaque session de discussion. L'activation de cette fonctionnalité lorsque ces types de canaux sont utilisés déséquilibre le reporting car de nouveaux utilisateurs seront ajoutés pour chaque nouvelle session de discussion et, par conséquent, la table des utilisateurs sera gonflée de nouvelles entrées. Les nouvelles données utilisateur ne sont pas purgées automatiquement du stockage. Vous devez donc utiliser l'API Oracle Digital Assistant à la place. Pour purger les nouvelles données utilisateur, incluez "purgeUserData": true dans la charge utile de la demande POST de démarrage de tâche d'export.

Le graphique Tendances des conversations présente les éléments suivants pour les intentions transactionnelles (intentions de transfert à un agent incluses) et les intentions de réponse :

• Terminé : conversations que les utilisateurs ont terminées avec succès. Les conversations qui se terminent par un état de fin de flux ou à un état où le flux de fin (implicite) est sélectionné comme transition sont considérées comme terminées. Dans les briques rédigées par YAML, les conversations sont comptabilisées comme terminées lorsque la traversée du flux de dialogue se termine par une transition return ou à un état avec la propriété insightsEndConversation.
  Remarque
  
  Cette propriété et la transition return ne sont pas disponibles dans Visual Flow Designer.
• Non terminé : conversations que les utilisateurs n'ont pas terminées car ils ont abandonné la brique ou n'ont pas pu terminer en raison d'erreurs, d'expirations ou de défauts au niveau de la conception de la brique.
• En cours : conversations en cours de traitement (conversations qui n'ont pas encore abouti et n'ont pas expiré). Cette mesure effectue le suivi des conversations à plusieurs niveaux.

Le graphique à barres Intentions vous permet de repérer non seulement les intentions transactionnelles et les intentions de réponse qui ont terminé des conversations, mais aussi celles qui ont causé des conversations non terminées. Vous pouvez également utiliser ce graphique pour déterminer si l'utilisation globale de ces intentions soutient votre cas d'utilisation. Par exemple, le nombre de conversations terminées d'une intention servant à atteindre un objectif secondaire est-il supérieur à celui de votre intention principale ? En termes plus concrets, votre brique de commande de pizzas est-elle devenue une brique de "dépôt de réclamation" qui achemine la plupart des utilisateurs vers un agent physique ?

Le nuage de mots Intentions les plus populaires fournit une vue complémentaire du graphique à barres Intentions en affichant le nombre de conversations terminées et non terminées pour une intention. Il pondère les intentions les plus fréquemment appelées par taille et par couleur. La taille du mot représente le nombre d'appels pour la période donnée.

La couleur représente le niveau de succès de la résolution d'intention :

• Le vert représente une moyenne élevée de résolution des demandes au niveau ou au-delà du seuil de marge de gain de confiance au cours de la période indiquée.
• Le jaune représente la résolution d'intention qui, en moyenne, n'atteint pas le seuil de marge de gain de confiance au cours de la période donnée. Cette couleur est un bon indicateur signalant que l'intention doit être réentraînée.
• La couleur rouge est réservée à unresolvedIntent. Il s'agit de l'ensemble des demandes utilisateur qui n'ont pas pu être mises en correspondance avec une intention et qui peuvent potentiellement être incorporées au corpus.

Le nuage de mots Intentions les plus populaires est la passerelle permettant de disposer de vues plus détaillées de la façon dont les intentions résolvent les messages utilisateur. La rubrique Examen et réentraînement des intentions à l'aide des nuages d'expressions clés décrit comment effectuer une analyse descendante à partir du nuage de mots des intentions les plus populaires pour en savoir plus sur l'utilisation, les interactions utilisateur et le réentraînement.

Outre la visualisation du message représenté par l'expression en contexte, vous pouvez également ajouter le message (ou les messages regroupés dans une expression clé) au corpus d'entraînement en cliquant sur Réentraîner.

Cette option ouvre le réentraînement, où vous pouvez ajouter l'expression réelle au corpus d'entraînement.

Le graphique en anneau User Rating et le nuage de mots User Feedback permettent de suivre les retours directs et les scores collectés par le composant. Lorsque la boîte de dialogue passe à l'état Retour utilisateur, la brique présente aux utilisateurs un système de notation et, éventuellement, la possibilité de fournir un retour. Par défaut, les utilisateurs peuvent évaluer leur interaction avec la brique en choisissant une plage de un à cinq. Pour ODA version 21.10 et versions ultérieures, le composant feedback est, par défaut, un système d'évaluation par étoiles. Pour les versions précédentes, le composant de retour s'affiche sous forme de liste.

Le score de satisfaction client moyen, qui est proportionnel au nombre de conversations pour chacune des notations, est affiché au centre du graphique en beignet. Les totaux individuels sur une base par conversation pour chaque nombre sur la plage sont représentés sous forme d'arcs du graphique en anneau de notation de l'utilisateur qui varient en longueur selon l'occurrence. Lorsque vous cliquez sur l'un de ces arcs, le rapport Conversations est filtré par score.

Pour capturer les données du graphe Notation des utilisateurs et du nuage de mots Commentaires des utilisateurs, vous devez ajouter une séquence d'états à votre flux de dialogue. Le premier de ces états est un état Retour utilisateur. Pour ajouter cet état, sélectionnez Messagerie utilisateur > Retour utilisateur, puis sélectionnez Suivant comme type de transition. (Dans les flux YAML, vous devez définir une transition explicite vers l'état System.Feedback à l'aide de la transition next.) Votre flux de dialogue peut passer à une séquence d'états de retour utilisateur à chaque fois que vous souhaitez évaluer la réaction d'un utilisateur. Cela peut être, par exemple, une fois qu'un utilisateur a terminé ou annulé une transaction.

Après l'état Commentaires de l'utilisateur, vous devez ajouter les états correspondant à ses above, below et cancel transitions. Dans les flux de dialogue YAML, chacun de ces états comporte des transitions return: done.

Ces états s'adaptent à la plage haute et basse de l'évaluation telle que déterminée par la propriété Seuil. Vous pouvez ajouter ces états en tant que messages utilisateur confirmant la réception de la note de l'utilisateur. Vous pouvez personnaliser la sortie du composant Commentaires utilisateur en modifiant les groupes de ressources liés aux commentaires accessibles via la page Configuration des groupes de ressources ou en modifiant les clés systemComponent_Feedback_ dans un fichier CSV de groupes de ressources.

Vous pouvez obtenir une vue générale des retours positifs, négatifs et ignorés en définissant une dimension liée aux retours utilisateur unique dans un ensemble d'états Définir des mesures personnalisées.

Chacun de ces états Définir des mesures personnalisées correspond à l'un des états nommés par les actions de transition above, below et cancel du composant Commentaires utilisateur. Par exemple, si vous voulez ajouter une mesure nommée Type de retour au rapport Mesures personnalisées, vous devez effectuer les opérations suivantes :

1. Insérez les états Définir des mesures personnalisées avant chacun des états nommés par les actions de transition above, below et cancel du composant Commentaires utilisateur.
2. Pour chaque état, entrez Feedback Type comme nom de dimension.
3. Ajoutez des valeurs distinctes pour chaque état, selon le type de transition (par exemple, Canceled, Positive, Negative). Maintenant que vous avez instrumenté le flux de dialogue pour enregistrer les données de retour, vous pouvez interroger les différentes valeurs dans le rapport Mesures personnalisées.

Vous pouvez ajouter des états Définir des mesures personnalisées lorsque vous souhaitez suivre une valeur d'entité ou une activité dans un flux d'exécution. En fonction de la structure des flux de dialogue (et de votre cas d'emploi), vous pouvez définir plusieurs dimensions dans un seul état Définir des mesures personnalisées, ou avec plusieurs états Définir des mesures personnalisées dans un seul flux de dialogue ou dans plusieurs flux.

Selon la composition et la complexité de la définition du flux de dialogue, les valeurs d'entité à suivre peuvent ne pas être résolues au sein du même flux de dialogue. Dans ce cas, il se peut que vous ne puissiez pas définir toutes les dimensions avec un seul état Set Custom Metrics. Au lieu de cela, vous devrez ajouter des états Définir des mesures personnalisées à différentes parties de la définition du flux de dialogue (ou à différents flux dans leur ensemble).

Si vous cliquez sur Exporter, les données de mesures personnalisées sont téléchargées dans un fichier CSV que vous pouvez utiliser pour vos propres rapports et analyses hors ligne. Vous pouvez filtrer les données téléchargées dans le fichier CSV en fonction des valeurs de dimension. Ce fichier CSV téléchargé contient les champs suivants.

Pour les conversations terminées, le rapport indique le nombre de chemins d'exécution parcourus par les utilisateurs pour terminer ces conversations avec des statistiques sur le temps passé et le nombre d'états visités.

Pour plus de contexte sur les conversations terminées :

• Vous pouvez tracer le chemin d'exécution d'une intention sélectionnée en cliquant sur Afficher le chemin, ce qui ouvre le rapport Chemins filtré par conversations terminées pour l'intention. Pour vous concentrer davantage sur les chemins d'exécution, vous pouvez filtrer les états qui ne vous intéressent pas.
  
  

  
  Description de l'image initial-completed-intent-path.png

  
  
• Vous pouvez lire les transcriptions des conversations terminées pour une intention en cliquant sur Afficher les conversations, ce qui ouvre le rapport Conversations filtré par conversations terminées pour l'intention.
  
  

  
  Description de l'image completed-conversations-report-from-intents.png

  
  

Pour les conversations incomplètes, vous pouvez identifier les états le long du chemin d'exécution de l'intention où ces conversations ont pris fin à l'aide du graphique à barres horizontal Etats incomplets. Ce graphique, qui s'affiche pour les intentions transactionnelles répertoriées dans la barre de navigation de gauche, trace la distribution des conversations incomplètes par état, qui peut être un état défini dans le flux de dialogue ou un état interne qui marque la fin d'une conversation, tel que System.DefaultErrorHandler. Elle vous permet de déterminer si un état de flux de dialogue est un point d'échec continu et les raisons (erreurs, délais d'attente ou entrées utilisateur incorrectes). Ce rapport n'affiche pas les parcours ou la vitesse pour les parcours incomplets car ils ne s'appliquent pas à cette saisie utilisateur. Au lieu de cela, le graphique à barres classe chaque intention en fonction du nombre de messages qui n'ont pas pu être résolus en une intention ou qui auraient pu être résolus (le système aurait pu deviner une intention), mais ne l'ont pas été en raison de faibles scores de confiance. Dans les flux YAML, Insights considère les conversations comme incomplètes lorsque l'état final comporte une transition vide (ou implicite) ({}). Même si la brique gère la transaction avec succès, les analyses classeront toujours la conversation comme incomplète et représenteront l'état final sous la forme System.DefaultErrorHandler.

Pour plus de contexte sur les conversations incomplètes pour une intention :

• Cliquez sur Afficher le chemin pour ouvrir le rapport Chemins filtré et rechercher les conversations incomplètes pour l'intention sélectionnée. Les états de terminal sur ce chemin peuvent inclure des états définis dans la boîte de dialogue ou un état interne qui marque la fin d'une conversation, tel que System.EndSession, System.ExpiredSession, System.MaxStatesExceededHandler et System.DefaultErrorHandler.
  
  
  Description de l'image incomplète-conversations-path-from-intent.png
  
  
• Vous pouvez accéder aux transcriptions des conversations qui mènent à l'échec en cliquant sur Visualiser les conversations. Cette option ouvre le rapport Conversations filtré pour les conversations incomplètes pour l'intention sélectionnée. Vous pouvez affiner davantage les résultats en appliquant un filtre. Par exemple, vous pouvez filtrer le rapport par conditions d'erreur.
  
  

  
  Description de l'image incomplète-conversations-from-intents-report.png

  
  

Vous pouvez visualiser le chemin et les conversations de ces messages non résolus par Visualiser le chemin et Visualiser les conversations, mais vous pouvez également accéder aux messages non résolus via le rapport Réentraînement, dans lequel vous pouvez les évaluer en tant qu'ajouts possibles aux données d'entraînement. Si vous cliquez sur Réentraînement, le rapport Réentraînement est filtré par messages non résolus.

Le rapport Chemins affiche un chemin d'exécution d'intention en fonction des paramètres de votre requête. Vous pouvez interroger ce rapport à la fois pour les chemins d'exécution complets et incomplets de toutes les intentions, définir la longueur du chemin en choisissant un état final et isoler des parties des chemins d'exécution en excluant les états d'importance secondaire. Par exemple, vous pouvez considérer les états qui définissent des variables ou instrumentent la brique pour des mesures personnalisées comme des états de remplissage qui nuisent au focus de votre enquête.

Tous les flux d'exécution s'affichent par défaut une fois que vous avez saisi votre requête. La flèche verte de début représente System.BeginSession, l'état du système qui démarre chaque conversation. L'icône System.Intent peut représenter différentes intentions, en fonction du filtre. Il peut faire référence à une intention spécifique que vous avez choisie comme filtre ou représenter chaque intention définie pour votre brique lorsque vous filtrez le rapport par Tout (paramètre par défaut).

Pour les conversations incomplètes, le chemin peut se terminer par un état interne tel que System.ExpiredSession, System.MaxStatesExceededHandler ou System.DefaultErrorHandler qui représente l'erreur ayant mis fin à la conversation.

Cliquez sur l'état final pour ouvrir le panneau de détails, qui affiche les statistiques, les erreurs, les avertissements et les messages utilisateur finaux.

Le rapport affiche Réponse NULL pour tout message client vide (ou non constitué de texte brut) ou contenant une entrée inattendue. Pour les réponses non textuelles qui constituent des actions de postback, le rapport affiche la charge utile de l'action la plus récente. Par exemple :

{"orderAction":"confirm""system.state":"orderSummary"}

Si vous cliquez sur Afficher les conversations, le rapport Conversations interrogé par le chemin s'ouvre afin que vous puissiez consulter les messages qui ont conclu la conversation dans le contexte d'une transcription.

Cliquez sur Afficher les mesures vocales pour afficher un sous-ensemble moyen des mesures vocales sur toute la conversation. Pour visualiser ces mesures réparties par interaction vocale, cliquez sur l'icône de graphique à barres dans la vue de transcription, accessible en cliquant sur Afficher les conversations.

1. Cliquez sur Paramètres > Général.
2. Activez Activer l'anonymisation des informations d'identification personnelle.
3. Cliquez sur Ajouter une entité pour sélectionner les valeurs d'entité à anonymiser dans les rapports d'analyse et les journaux.
   Remarque
   
   Les valeurs anonymisées sont conservées dans la base de données uniquement après l'activation de l'anonymisation des valeurs d'informations d'identification personnelle pour les entités sélectionnées. Elles ne sont pas appliquées aux conversations précédentes. Selon la plage de dates sélectionnée pour les rapports d'analyse ou les fichiers d'export, les valeurs d'informations d'identification personnelle peuvent apparaître dans leurs formulaires réels et anonymisés. Vous pouvez appliquer l'anonymisation à toute valeur d'informations d'identification personnelle non anonymisée (y compris celles des conversations qui se sont produites avant l'activation de l'anonymisation dans les paramètres de brique ou d'assistant numérique) lorsque vous créez une tâche d'export. Ces anonymes s'appliquent uniquement au fichier exporté et ne sont pas conservés dans la base de données.
   Si vous voulez mettre fin à l'anonymisation d'une valeur d'informations d'identification personnelle ou si vous ne voulez pas qu'un anonymat soit utilisé, sélectionnez l'entité correspondante, puis cliquez sur Supprimer l'entité. Une fois que vous avez supprimé une entité, la valeur d'informations d'identification personnelle réelle apparaît dans les rapports d'analyse pour les conversations suivantes. Sa forme anonyme, cependant, restera pour les conversations antérieures.
   Remarque
   
   L'anonymisation est permanente (nonobstant l'anonymisation appliquée à la tâche d'export). Vous ne pouvez pas récupérer les valeurs d'informations d'identification personnelle après avoir activé l'anonymisation.

Lorsque vous activez les paramètres d'anonymisation des informations d'identification personnelle pour la brique ou l'assistant numérique :

• Les valeurs d'informations d'identification personnelle reconnues pour les entités sélectionnées sont remplacées par des anonymes. Ces anonymes sont conservés dans la base de données et remplacent les valeurs d'informations d'identification personnelle dans les journaux et les rapports d'analyse. Cette anonymisation est appliquée aux conversations qui se produisent après – et non avant – votre activation de l'anonymisation dans les paramètres.
• L'option Activer l'anonymisation des informations d'identification personnelle pour l'option de fichier de la tâche d'export est activée par défaut pour garantir que les valeurs d'informations d'identification personnelle reconnues pour les entités sélectionnées dans les paramètres sont appliquées aux conversations qui ont eu lieu avant la définition de l'anonymisation des informations d'identification personnelle. Les anonymes appliqués lors de l'exportation vers les conversations antérieures à l'anonymisation des informations d'identification personnelle existent uniquement dans le fichier d'exportation. Les valeurs d'informations d'identification personnelle d'origine restent dans la base de données, les journaux d'analyse et les rapports d'analyse).
• Si vous désactivez l'option Activer l'anonymisation des informations d'identification personnelle pour le fichier, seules les valeurs d'informations d'identification personnelle reconnues pour les entités sélectionnées dans les paramètres seront anonymisées. Les fichiers journaux contiennent les anonymes des conversations qui ont eu lieu après l'activation des paramètres d'anonymisation pour la brique ou l'assistant numérique. Les conversations précédentes apparaissent sous la forme de variations originales et non modifiées avec leurs valeurs d'informations d'identification personnelle intactes. Par conséquent, le fichier d'exportation peut inclure des conversations anonymisées et non anonymisées si une partie de la plage de dates de la tâche d'exportation est antérieure à l'anonymisation.
  Remarque
  
  Si votre tâche d'export inclut des conversations anonymisées survenues avant la version 22.04, les anonymes appliqués aux conversations antérieures à la version 22.04 seront modifiés ou rendus anonymisés dans les fichiers d'export lorsque vous sélectionnez Activer l'anonymisation des informations d'identification personnelle pour le fichier pour la tâche d'export. Les anonymes du fichier exporté ne correspondent ni aux anonymes des fichiers d'export antérieurs à la version 22.04, ni aux anonymes qui apparaissent dans les rapports d'analyse.

Lorsque vous désactivez ou ne configurez pas les paramètres d'anonymisation des informations d'identification personnelle pour une brique ou un assistant numérique :

• L'option Activer l'anonymisation des informations d'identification personnelle pour le fichier est désactivée par défaut pour la tâche d'export, de sorte que le fichier exporté contienne toutes les variations non modifiées d'origine, y compris les valeurs d'informations d'identification personnelle.
• Si vous sélectionnez Activer l'anonymisation des informations d'identification personnelle pour le fichier, les valeurs des informations d'identification personnelle seront anonymisées dans le fichier exporté uniquement pour les entités par défaut, PERSON, EMAIL, URL et NUMBER. Les valeurs d'informations d'identification personnelle resteront dans la base de données, les journaux et les rapports d'analyse.

Tenez compte des points suivants lorsque vous ajoutez des messages utilisateur aux corpus d'entraînement :

• Vous pouvez uniquement ajouter une saisie utilisateur au corpus d'entraînement appartenant à une version brouillon d'une brique, et non à une version publiée.
• Vous ne pouvez pas ajouter une saisie utilisateur déjà présente en tant que variation dans le corpus d'entraînement, ou que vous avez déjà ajoutée à l'aide du réentraînement.

Pour mettre à jour une intention transactionnelle ou une intention de réponse à l'aide du réentraînement, procédez comme suit :

1. Etant donné que vous ne pouvez pas mettre à jour une brique publiée, vous devez créer une version brouillon pour pouvoir ajouter de nouvelles données au corpus.

   Conseil :

   Cliquez sur Comparer toutes les versions ou désactivez le commutateur Afficher uniquement la plus récente pour accéder aux versions brouillon et publiée de la brique.
   Si vous examinez une version publiée de la brique, sélectionnez la version brouillon de la brique.
   
   
   
   
2. Dans la version brouillon de la brique, appliquez un filtre, si nécessaire, puis cliquez sur Rechercher.
3. Sélectionnez le message utilisateur, puis choisissez l'intention cible dans le menu Sélectionner une intention. Si votre brique prend en charge plusieurs langues natives, vous pouvez l'ajouter à l'ensemble d'entraînement adapté à la langue en choisissant l'une des langues du menu Langue.

   Conseil :

   Vous pouvez ajouter des variations individuellement à une intention, ou sélectionner plusieurs intentions puis l'intention cible et, si nécessaire, une langue dans le menu Ajouter à situé en haut à gauche de la table. Pour ajouter toutes les demandes renvoyées à une intention, sélectionnez Variations (en haut à droite de la table), puis choisissez l'intention et la langue dans le menu Ajouter à.
4. Cliquez sur Ajouter un exemple.
5. Entraînez de nouveau la brique.
6. Publiez de nouveau la brique.
7. Mettez à jour l'assistant numérique avec la nouvelle brique.
8. Surveillez le rapport Aperçu pour connaître l'évolution des mesures au fil du temps et comparer les différentes versions de la brique afin de déterminer si les nouvelles versions ont contribué au succès global de la brique. La répétition du processus de réentraînement améliore la réactivité de la brique à chaque nouvelle version. Pour les briques intégrées à Oracle Service Cloud Chat, par exemple, le réentraînement doit provoquer une évolution à la baisse des escalades, indiquée par une évolution à la baisse de l'utilisation des intentions de transfert vers un agent.

Une fois le travail créé, il apparaît sur la page Travaux de fabrication de données, où vous pouvez le distribuer aux crowdworkers en partageant le lien.

1. Ouvrez la page Exports et cliquez sur + Exporter.
2. Saisissez le nom du rapport, puis entrez une plage de dates.
3. Cliquez sur Activer l'anonymisation des informations d'identification personnelle pour le fichier exporté pour remplacer les valeurs d'informations d'identification personnelle par des anonymes dans le fichier exporté. Ces anonymes existent uniquement dans le fichier exporté si les informations d'identification personnelle ne sont pas activées dans les paramètres de brique. Dans ce cas, les valeurs d'informations d'identification personnelle, et non leurs équivalents d'anonymat, sont toujours stockées dans la base de données et apparaissent dans les journaux d'analyse exportés et dans les rapports d'analyse, y compris le rapport Conversations, le réentraînement et les expressions clés dans le cloud de mots. Si les informations d'identification personnelle ont été activées dans les paramètres de brique, les journaux et les rapports d'analyse contiendront des anonymes.
   Remarque
   
   L'anonymisation des informations d'identification personnelle activée pour les paramètres de brique ou d'assistant numérique prend en compte la façon dont les valeurs d'informations d'identification personnelle sont anonymisées dans le fichier d'export et contribue également à la consistance de l'anonymisation dans le fichier d'export.
4. Cliquez sur Exporter.
5. Une fois la tâche terminée, cliquez sur Terminé pour télécharger le fichier CSV (ou les fichiers CSV pour les exports importants) sous forme de fichier ZIP. Le nom du fichier CSV d'export au niveau de la brique commence par B_. Les noms de fichier des exports au niveau de l'assistant numérique commencent par D_.

Description de l'image insights-export-dialog.png

Voici certains des champs sur lesquels vous allez probablement vous concentrer le plus souvent. Tous les champs sont décrits dans Champs du journal d'export. Certaines approches de tri des données sont décrites dans Filtrage des données d'analyse exportées.

• BOT_NAME contient le nom de la brique ou le nom de l'assistant numérique. Vous pouvez utiliser cette colonne pour savoir comment le dialogue est acheminé du système numérique vers les briques (et entre les briques).
• CHANNEL_SESSION_ID stocke l'ID de session de canal. Vous pouvez utiliser cet ID, en conjonction avec la troisième colonne, CHANNEL_ID, afin de créer un type d'identificateur unique pour la session. Etant donné que les sessions peuvent expirer ou être interrompues, vous pouvez utiliser cet identificateur pour déterminer si la session a changé.
• TIMESTAMP indique la chronologie ou l'ordre dans lequel les événements se sont produits. En règle générale, le tri est effectué sur cette colonne.
• USER_UTTERANCE et BOT_RESPONSE contiennent la conversation entre la brique et son utilisateur. Ces deux champs affichent clairement l'imbrication des messages de l'utilisateur et de la brique en cas de tri sur TIMESTAMP.

  La colonne USER_UTTERANCE peut contenir des variations en double. Cela peut se produire lorsque les tests utilisateur sont exécutés sur la même instance, mais il est plus probable que cela soit dû à l'utilisation de la variation dans différentes parties de la conversation.

• Vous pouvez utiliser COMPONENT_NAME, CURR_STATE et NEXT_STATE pour déboguer le flux de dialogue.

En général, vous triez les journaux sur la colonne TIMESTAMP pour visualiser la séquence d'événements. Pour d'autres perspectives, par exemple, la conversation entre l'utilisateur et la brique, vous pouvez filtrer les colonnes sur les états internes générés par le système. Les techniques de filtrage courantes sont les suivantes :

• Tri de la conversation entre la brique et l'assistant numérique : lorsqu'un export contient des données provenant d'un assistant numérique et de ses briques inscrites, le contenu du champ BOT_NAME peut sembler confus, car la conversation semble basculer arbitrairement entre les différentes briques, et entre les briques et l'assistant numérique. Pour afficher le dialogue dans le bon ordre (et en contexte), la colonne TIMESTAMP est présentée dans l'ordre croissant.
• Recherche des limites de la conversation : utilisez le champ System.BeginSession et l'un des états terminaux pour rechercher le début et la fin d'une conversation. Les conversations commencent par un état System.BeginSession. Elles peuvent se terminer par l'un des états terminaux suivants :
  • System.EndSession
  • System.ExpiredSession
  • System.MaxStatesExceededHandler
  • System.DefaultErrorHandler
• Examen de la conversation entre l'utilisateur et la brique : pour isoler le contenu des colonnes USER_UTTERANCE et BOT_RESPONSE, filtrez la colonne CURR_STATE sur les états générés par le système System.MsgReceived et System.MsgSent
  Remarque
  
  En cas de réponse à un message non texte, comme celles provenant des états des entités de résolution, la sortie de la brique contient des réponses partielles jointes par un caractère de retour à la ligne.
  Parfois, certaines parties du dialogue entre l'utilisateur et la brique peuvent se répéter dans les colonnes USER_UTTERANCE et BOT_RESPONSE. Le texte utilisateur est répété lorsqu'une transition automatique ne nécessite pas de saisie utilisateur. Les réponses de la brique sont répétées si l'état suivant est l'un des états terminaux, comme System.EndSession ou System.DefaultErrorHandler.
• Examen de l'exécution du flux de dialogue avec le dialogue entre l'utilisateur et la brique : pour visualiser les transactions internes ou afficher uniquement les messages non textuels, vous devez retirer du filtre les états System.MsgReceived et System.MsgReceived de la colonne CURR_STATE (approche opposée à la visualisation du dialogue uniquement).
• Identification d'une session : comparez les valeurs de CHANNEL_SESSION_ID et de SESSION_ID (les unes à côté des autres).

Le fichier CSV exporté pour une brique inclut les champs suivants.