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 montrant Tout sélectionné sur le nœud Tables.

  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 que les données soit compilés 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 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.

Nonte

  • Si une conversation a 30 minutes d’inactivité, la conversation est enregistrée dans un enregistrement de transcription. Si la conversation continue après l'inactivité, elle est enregistrée dans une nouvelle transcription avec le même Name.
  • Si un enregistrement de transcription pour une conversation est supérieur à 1 Mo, la transcription est divisée en plusieurs enregistrements, chacun n’étant pas supérieur à 1 Mo, et chacun ayant les mêmes valeurs Name et ConversationStartTime.
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’ID d’agent, l’ID de locataire et le nom de l’agent {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot"}
Name Nom de la ligne personnalisée créée à partir de ConversationIdBotId. 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é, 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é 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

Les assistants peuvent être configurés pour générer des transcriptions améliorées qui incluent des données au niveau du nœud. 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 transcriptions, puis activez l’option Inclure les détails au niveau du nœud dans les transcriptions.

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

Données au niveau du nœud

Lorsque les transcriptions améliorées sont activées, un type d’activité nodeTraceData apparaît dans la transcription pour chaque nœud appelé par une rubrique. 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. Les clients qui créent des solutions d’analyse personnalisées peuvent ingérer les transcriptions brutes dans leurs pipelines de données ou utiliser un module complémentaire, tel que le Kit Copilot Studio

La solution KPI de conversation dans le Kit Copilot Studio analyse automatiquement les transcriptions et remplit les données agrégées dans des tables Dataverse.

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

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

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 de détails sur la façon dont les transcriptions sont enregistrées et sur la façon de gérer l’accès, voir Contrôler l’accès aux transcriptions.

Important

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

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 assistant ou l’utilisateur de l’assistant. 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.

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