Partager via

Comprendre les transcriptions de conversation Power Apps

  • Article

Vous pouvez afficher, exporter et télécharger les transcriptions des interactions des clients avec votre copilote à la fois dans Power Apps et Copilot Studio. Les informations exportées par chaque application sont légèrement différentes. 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 en savoir plus, consultez Analyser les informations de session 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.

Note

Si vous n’avez plus accès à votre environnement, vous devrez créer une demande de support dans le Centre d’administration Power Platform.

Conditions préalables

Afficher et exporter les transcriptions des conversations du copilote à partir du portail Power Apps

Vous pouvez consulter et exporter les transcriptions des conversations copilote depuis le portail Power Apps.

Pour lier des entités, vous devez vous connecter avec vos informations d'identification à https://www.powerapps.com.

Afficher les transcriptions de conversation

  1. Dans le volet latéral, sélectionnez le nœud Tables, puis sélectionnez Tout.

    Capture d’écran montrant Tout sélectionné sur le nœud Tables.

  2. Entrez conversation dans la zone de Recherche.

  3. Sélectionnez ConversationTranscript en dessous de Tables.

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

Exporter des transcriptions de conversation

  1. Dans le volet latéral, sélectionnez le nœud Tables, puis sélectionnez Tout.

    Sélectionnez Tout sur le nœud Tables.

  2. Entrez conversation dans la zone de Recherche.

  3. Sélectionnez ConversationTranscript en dessous de Tables.

  4. Sélectionnez Exporter>Exporter des données.

    Il faut quelques minutes pour que les données soit compilés pour exporter.

    Dans le menu Exporter, sélectionnez Exporter les données.

  5. Pour télécharger le contenu, sélectionnez Télécharger les données exportées.

    Téléchargez les données exportées.

Télécharger les transcriptions des conversations du copilote

  1. Dans le menu de navigation de Power Apps, sélectionnez Dataverse>Tables, puis sélectionnez Tout.

  2. Entrez conversation dans la zone de Recherche.

  3. Sélectionnez la table ConversationTranscript.

  4. Sélectionnez Exporter>Exporter des données.

    Capture d’écran de l’option Exporter les données de la table ConversationTranscript.

  5. 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 compressée dans l’emplacement de téléchargement par défaut de votre navigateur.

Comprendre les transcriptions de conversation

La transcription de la conversation est un fichier CSV (valeurs séparées par des virgules). La table suivante décrit les champs les plus importants dans vos transcriptions de conversation.

Champ Description Exemple
Content Transcription complète au format JSON Reportez-vous à la section 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 incluant l’ID du copilote, l’ID du locataire et le nom du copilote {"BotId": "198eca5f-xxxx-4ae6-8c08-835d884a8688", "AADTenantId": "72f988bf-xxxx-41af-91ab-2d7cd011db47", "BotName": "Test Bot"}
Name Nom de la ligne personnalisée créée à partir de ConversationId, suivi de BotId suivi de batch number. Le numéro de lot indique l’ordre lorsqu’il existe plusieurs sessions d’analyse pour la conversation. Les bots classiques n’incluent pas le numéro de lot. 8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0
Bot_ConversationTranscript L’ID du copilote 198eca5f-xxxx-4ae6-8c08-835d884a8688
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 le copilote. 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 au copilote.

Pour obtenir plus d’informations sur les types d’activités, consultez 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 Description
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 du copilote
    • 1 - l’activité provient de l’utilisateur qui interagit avec le copilote
Remarques :
l’id peut être utilisé pour calculer le nombre d’utilisateurs actifs qui interagissent avec le copilote 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é, l’ID est haché avant d’être écrit dans 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é Description
ConversationInfo Indique si la conversation provient du volet de test de 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, où l’une des conditions pointe vers la rubrique système CSAT Réussite confirmée 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) et nombre de tours de la session
VariableAssignment Une valeur est attribuée à une variable

Créer des rapports personnalisés Power BI à partir de transcriptions de conversation

Une manière utile d’approcher la création de rapports personnalisés à partir de transcriptions de conversation consiste à examiner le nombre de messages à traiter.

Approche simple

Connectez Power BI à Dataverse avec un flux de données Power BI. Aucune autre infrastructure n’est nécessaire et tous les enregistrements sont récupérés de Dataverse à chaque actualisation.

Diagramme illustrant le flux de données de Dataverse vers le modèle Power BI.

Avantages Inconvénients
Implémentation la plus facile. Le temps d’actualisation peut augmenter à mesure que les transcriptions augmentent.
Coût élevé pour le stockage dans Dataverse.

Approche Azure Data Lake Storage standard

Exportez les données Dataverse vers Azure Data Lake Storage. Cette méthode nécessite un compte Azure Data Lake Storage, mais aucune autre infrastructure Azure.

Utilisez un flux de données Power Platform sur les transcriptions pour préparer les données, et extrayez les données dans un format structuré.

Power BI actualise les données du flux de données. Power Platform et Power BI gèrent toute l’infrastructure de calcul. Les enregistrements d’un jour donné sont récupérés de Dataverse à chaque actualisation.

Diagramme montrant les données transmises de Dataverse vers Azure Data Lake Storage, traitées par Power Platform et Power BI.

Avantages Inconvénients
Faible coût de stockage dans Azure Data Lake Storage.
Implémentation modérément simple.
Azure Compute n’est pas nécessaire.		 Le temps d’actualisation peut augmenter à mesure que les transcriptions augmentent chaque jour.

Approche Azure Data Lake Storage + Synapse

La taille des données dans l’approche Azure Data Lake Storage standard peut entraîner des actualisations lentes ou d’autres problèmes opérationnels. Dans ce cas, vous pouvez utiliser Azure Synapse Analytics et l’intégrer dans Power BI.

Diagramme des données transmises de Dataverse vers Azure Data Lake, traitées par Azure Synapse et Power Platform.

Avantages Inconvénients
Le temps d’actualisation est constant.
Implémentation modérément simple.
Faible coût de stockage dans Azure Data Lake Storage.		 Coût de calcul pour Azure Synapse.

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

Une tâche de suppression en bloc Power Apps supprime automatiquement les transcriptions du copilote 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.

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

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

  2. Sélectionnez le signe d’insertion en regard de Paramètres, puis sous 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. Pour démarrer l’Assistant Suppression en bloc, sélectionnez Nouveau , puis, 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 valeur différentes si vous le souhaitez.
    • Sélectionner SchemaType, laissez égal à 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.

Conseils pour tirer le meilleur parti de vos transcriptions de conversation

Les variables peuvent être utilisées pour stocker des données pertinentes pour le contenu de votre copilote ou l’utilisateur du copilote. L’analyse de la variable et de sa valeur à partir de la transcription de la conversation vous permet de filtrer ou de répartir les données selon la variable.

Dans de nombreux emplacements, les transcriptions de conversation font référence au contenu par son ID. Par exemple, l’ID de la rubrique vers laquelle est redirigée la rubrique actuelle n’est référencé que par son ID. Pour obtenir le nom de la rubrique, recherchez son nom dans le contenu du copilote.