Partager via

Comprendre les transcriptions de conversation téléchargées à partir de Power Apps

Vous pouvez afficher, exporter et télécharger les transcriptions des interactions des clients avec votre assistant dans Power Apps et Copilot Studio. Les informations exportées par chaque application sont légèrement différentes.

Important

Les créateurs disposant du rôle Créateur d’environnement n’ont pas automatiquement accès aux transcriptions.

Cet article explique comment télécharger des transcriptions de conversation dans Power Apps et les utiliser pour créer des rapports dans Power BI. Pour télécharger les transcriptions directement dans Copilot Studio, voir Télécharger les transcriptions de conversation dans Copilot Studio.

Par défaut, Power Apps télécharge les transcriptions des conversations des 30 derniers jours. Vous pouvez modifier la période de rétention.

Nonte

Les réponses de l’assistant qui utilisent SharePoint comme source de connaissances ne sont pas incluses dans les transcriptions de conversation.

Les transcriptions de conversation ne sont pas écrites pour :

  • Environnements Microsoft Dataverse for Teams
  • Environnements de développeur Dataverse
  • Assistants Microsoft 365 Copilot

Conditions préalables

Afficher et exporter les transcriptions de conversation de bot à partir du portail Power Apps

  1. Connectez-vous à Power Apps.

  2. Dans le volet latéral, sélectionnez Tables, puis sélectionnez Tout.

    Capture d’écran du nœud Tables avec Tous sélectionnés.

  3. Entrer conversation dans la zone recherche.

  4. Sélectionnez la table ConversationTranscript.

    Une page pour la table Transcription de conversation s’ouvre.

  5. Dans la barre de menus supérieure, sélectionnez Exporter>Exporter les données.

    Il faut quelques minutes pour compiler les données pour exporter.

    Capture d’écran montrant le menu Exporter avec l’option Exporter les données.

  6. Attendez quelques minutes que Power Apps prépare les données pour l’exportation, puis sélectionnez Télécharger les données exportées.

    Le fichier est enregistré en tant qu’archive ZIP à l’emplacement de téléchargement par défaut de votre navigateur.

Comprendre les transcriptions de conversation

La transcription de la conversation existe sous forme de tableau Dataverse que vous pouvez télécharger sous forme de fichier CSV (valeurs séparées par virgules). La logique qui détermine quand et comment le système enregistre les informations dans les transcriptions de conversation est la suivante :

  • Le système enregistre une conversation dans un enregistrement de transcription après 30 minutes d’inactivité. Si la conversation reprend après le temps d’inactivité, le système sauvegarde les nouvelles activités dans un nouvel enregistrement avec la même Name valeur mais avec une nouvelle ConversationStartTime valeur.
  • Pour les agents publiés sur la chaîne téléphonique, les conversations expirent trois minutes après un événement de fin de conversation .
  • Chaque enregistrement a une limite de 1 Mo pour la transcription (Content colonne). Lorsqu’une transcription dépasse cette limite, le système divise la transcription en plusieurs enregistrements, tous ayant les mêmes Name valeurs de 'et ConversationStartTime ', mais avec des valeurs différentes Metadata.BatchId .
  • Pour fusionner les transcriptions, prenez tous les enregistrements ayant les mêmes Name valeurs de et (et ConversationStartTime de valeurs de ) puis triez ces enregistrements par BatchId.

La table suivante décrit les champs les plus importants dans vos transcriptions de conversation.

Champ Descriptif Exemple
Content Transcription complète au format JSON Voir Champ de contenu
ConversationStartTime Heure de début de la conversation (et non l’heure à laquelle l’enregistrement de la transcription a été écrit dans le magasin de données) 2021-04-19T20:39:09Z
ConversationTranscript Identificateur unique de la ligne dans la table Dataverse 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata JSON qui inclut l’identifiant de l’agent, l’identifiant locataire, le nom de l’agent et l’identifiant de lot {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name Le nom de la ligne personnalisée créée de ConversationId suit de BotId 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript ID de l’agent aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on Date et heure de création de l’enregistrement de la transcription 2021-04-20T02:40:13Z

Champs de contenu

Le champ Content est un journal brut de toutes les activités des utilisateurs avec l’agent. Les types d’activités communes sont message et event :

  • Les activités de message représentent le contenu affiché dans une conversation. Les activités de message peuvent contenir du texte, de la voix, des cartes interactives et des pièces jointes binaires ou inconnues.
  • Les activités d’événement communiquent les informations programmatiques d’un client ou d’un canal à l’agent.

Pour obtenir plus d’informations sur les types d’activités, consultez le Schéma d’activité de Bot Framework.

Le tableau suivant décrit un certain nombre des champs clés dans le contenu de type JSON :

Touche Descriptif
ID GUID unique de l’objet d’activité
valueType Le type de valeur stockée dans l’activité ; dicte les informations fournies par l’activité (Types de valeurs d’activité courants)
timestamp Horodateur de la génération de l’activité, au format Epoch (nombre de secondes depuis minuit UTC le 1er janvier 1970)
type Type d’activité, par exemple, message, event ou trace
replyToId ID de l’activité à laquelle l’activité actuelle répond
from Contient les champs id et role :
  • id : ID du demandeur
  • role : contient 0 ou 1
    • 0 - l’activité provient de l’agent
    • 1 : l’activité provient de l’utilisateur qui interagit avec l’agent
Remarques :
l’id peut être utilisé pour calculer le nombre d’utilisateurs actifs qui interagissent avec l’agent si le canevas transmet un ID unique de l’utilisateur. Si le canevas ne transmet pas d’ID, un ID unique par conversation est transmis.
Pour des raisons de sécurité et de confidentialité, le système hache l’ID avant de l’écrire sur la transcription.
channelId L’ID du canal d’où provient l’activité ; par exemple, directline, msteams ou facebook
textFormat Format du texte, par exemple, plain ou markdown
attachments Les données dynamiques enrichies associées à l’activité, par exemple, AdaptiveCards, HeroCards ou Carousel data
text Texte des activités de message
value Champs spécifiques à l’activité selon le type de valeur ; ce champ est là où se trouvent la plupart des informations utiles
channeldata Contient les données de canal :
  • pour les messages :
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail (contient la valeur attribuée à une variable)
    • CurrentMessageDetail
  • pour les événements :
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name Nom de l’activité d’événement, par exemple, SetPVAContext

Types de valeurs d’activité communes

Type de valeur de l’activité Descriptif
ConversationInfo Indique si la conversation provient du volet de test de l’application Copilot Studio (isDesignMode) et les paramètres régionaux de la conversation
CSATSurveyRequest Une enquête de satisfaction client (CSAT) est présentée à l’utilisateur
CSATSurveyResponse L’utilisateur répond à une enquête CSAT
DialogRedirect L’utilisateur est redirigé vers une autre rubrique
ImpliedSuccess L’utilisateur a atteint un nœud de question dans la rubrique, dans laquelle l’une des conditions pointe vers la rubrique système CSAT Réussite confirmée (bots classiques uniquement) ou appelle la rubrique système Fin de la conversation
IntentRecognition L’utilisateur a déclenché une rubrique
PRRSurveyRequest Il a été demandé à l’utilisateur si la rubrique a répondu à sa question dans la rubrique Fin de la conversation
PRRSurveyResponse Réponse de l’utilisateur indiquant si la rubrique a répondu à sa question dans la rubrique Fin de la conversation
SessionInfo Type (unengaged ou engaged), résultat (Escalated, Resolved, Abandon), Heure de début et de fin de session (startTimeUtc, endTimeUtc) et nombre de tour de la session
VariableAssignment Une valeur est attribuée à une variable

Transcriptions améliorées

Vous pouvez configurer des agents pour générer des transcriptions améliorées incluant des données au niveau des nœuds. Ces données permettent de suivre le flux d’une conversation au sein d’une rubrique. Par exemple, dans une rubrique Gérer les commandes, les utilisateurs peuvent choisir entre soumettre une nouvelle commande ou récupérer une commande existante. Les données au niveau du nœud permettent d’analyser le comportement de l’utilisateur à travers ces options.

Activer les transcriptions améliorées

  1. Ouvrez votre agent.

  2. Accédez à Paramètres>Avancé.

  3. Sélectionnez Améliorer les relevés de notes, puis activez Inclure les détails au niveau du nœud dans les relevés de notes.

Capture d’écran montrant la page des paramètres des transcriptions améliorées.

Données au niveau du nœud

Lorsque vous activez les relevés de notes améliorés, le relevé inclut un nodeTraceData type d’activité pour chaque nœud invoqué par un sujet. Le tableau suivant décrit les champs clés de la valeur de l’activité nodeTraceData.

Touche Descriptif
nodeID Identificateur du nœud
nodeType Type de nœud, par exemple, SendActivity ou SearchAndSummarizeContent
startTime Horodatage de l’appel du nœud
endTime Horodatage de la fin de l’exécution du nœud
topicDisplayName Rubrique appelant le nœud

Analyses personnalisées

Certains scénarios, comme le filtrage des conversations en fonction d’une variable personnalisée, nécessitent une approche personnalisée pour l’analyse. Pour construire des solutions d’analyse personnalisées, les clients peuvent intégrer les transcriptions brutes dans leurs pipelines de données ou utiliser un module complémentaire, comme le Copilot Studio Kit.

La solution Conversation KPIs dans Copilot Studio Kit analyse automatiquement les transcriptions et remplit les données agrégées dans les tables Dataverse.

Modifier la période de rétention par défaut

Un travail de suppression massive de Power Apps supprime automatiquement les transcriptions d’agents datant de plus de 30 jours. Pour conserver les transcriptions plus longtemps, annulez la tâche existante et créez-en une nouvelle qui s’exécute selon une planification différente.

Annuler la tâche de suppression en bloc existante

  1. Dans Power Apps, sélectionnez Paramètres>Paramètres avancés.

    Le portail Dynamics 365 s’ouvre dans un nouvel onglet.

    Capture d’écran du menu Paramètres Power Apps avec les paramètres avancés en surbrillance.

  2. Sélectionnez le caret à côté de Paramètres. Dans Système, sélectionnez Gestion des données.

    Capture d’écran du menu Paramètres, avec l’option Gestion des données en surbrillance.

  3. Sélectionnez Suppression d’enregistrements en bloc.

  4. Dans la liste Vue, sélectionnez Tâches système de suppression en bloc récurrentes.

    Capture d’écran de la liste des tâches de suppression en bloc récurrentes.

  5. Sélectionnez la tâche Supprimer en bloc les enregistrements de transcription de conversation datant de plus d’un mois.

    Capture d’écran d’une liste de tâches de suppression en bloc, avec la première en surbrillance.

  6. Dans la liste Plus d’actions, sélectionnez Annuler.

    Capture d’écran de la liste Plus d’actions, avec l’option Annuler en surbrillance.

Créer une nouvelle tâche de suppression en bloc

  1. Sélectionnez Nouveau pour lancer l’Assistant de suppression en masse. Dans l’assistant, sélectionnez Suivant.

  2. Définissez les critères de recherche suivants :

    • Dans la liste Rechercher, sélectionnez ConversationTranscripts.
    • Sélectionner ConversationStartTime, Sélectionner Antérieur à X mois sur 12.
      Ce paramètre conserve les transcriptions pendant 12 mois. Choisissez une comparaison et une autre valeur si vous le souhaitez.
    • Sélectionnez Schematype, gardez les égaux, et entrez « powervirtualagents ».

    Capture d’écran des paramètres des critères de recherche de tâche de suppression en bloc.

  3. Cliquez sur Suivant.

  4. Saisissez un nom pour la tâche, sélectionnez Exécuter cette tâche tous les et saisissez 1. Choisissez une planification différente si vous ne voulez pas que la tâche s’exécute tous les jours.

    Capture d’écran du nom et des paramètres d’exécution de la tâche de suppression en bloc.

  5. Sélectionnez Suivant, puis Envoyer.

Pourquoi ne puis-je pas voir mes transcriptions de conversation dans la table ConversationTranscript de Power Apps ?

Les administrateurs peuvent empêcher l’enregistrement des transcriptions dans Dataverse. Pour plus d’informations sur la sauvegarde des transcriptions et la gestion de l’accès, voir Control transcript accès.

Important

Les transcriptions ne sont pas stockées pour les agents déployés dans des environnements de développement.

Conseils pour tirer le meilleur parti de vos transcriptions de conversation

Utilisez des variables pour stocker des données pertinentes pour votre contenu d’agent ou votre utilisateur agent. En analysant la variable et sa valeur à partir de la transcription de la conversation, vous pouvez filtrer ou découper les données par la variable.

Les transcriptions de conversation peuvent faire référence au contenu par ID uniquement. Par exemple, dans un nœud Redirection, la rubrique de destination n’est référencée que par son ID. Pour obtenir le nom de cette rubrique, recherchez son ID dans le contenu de l’agent.

  • Last updated on