Téléchargez les transcriptions et les données d’interaction de Copilot

Article
12/04/2024

Lorsque les agents utilisent Copilot, les interactions des agents avec Copilot, telles que la copie de résumés, l’utilisation d’une réponse suggérée, les commentaires et les transcriptions de chat, sont stockées dans le fichier msdyn_copilotinteraction, msdyn_copilotinteractiondata, msdyn_copilottranscript et msdyn_copilottranscriptdata tableaux dans Dataverse. Vous pouvez télécharger les transcriptions et les données d’interaction à l’aide de requêtes API Web.

Conditions préalables

Assurez-vous que la case Données d’expérience de l’agent est cochée dans volet d’aide de Copilot, afin que les données de transaction et d’interaction est stocké par le système dans Dataverse.
Assurez-vous que vous êtes connecté avec le rôle Administrateur ou Superviseur.
Obtenir ID de l’interaction.

Télécharger la transcriptions de la conversation

Lorsqu’un agent pose une question à Copilot, la conversation est enregistrée sous forme de transcription codée au format codé base64 dans le msdyn_transcriptdata tableau de Dataverse. Vous pouvez télécharger les transcriptions pour revoir la conversation et les réponses fournies par Copilot.

Par exemple, alors qu’il travaille sur un dossier, l’agent demande à Copilot "Comment puis-je réserver un voyage ?". Copilot génère une réponse basée sur un article de la base de connaissances. Si vous souhaitez télécharger la transcription de conversation instantanée, procédez comme suit :

Utilisez l’appel de l’API Web pour obtenir l’ID d’interaction.

Filtrez la table msdyn_copilotinteractions avec l’ID d’interaction requis pour accéder au DataID. Utilisez la requête API Web suivante pour filtrer les données par ID d’interaction.


   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0

Les principaux attributs du dossier sont les suivants.

Attribute	Définition	Valeur pour notre scénario
msdyn_copilotinteractionid		F0970641-C1E7-EE11-904C-000D3A3BB867
msdyn_scenariorequestid	Regroupe plusieurs interactions Copilot liées. Par exemple : un agent pose une question à Copilot puis marque le réponse reçu avec un pouce levé. Ces deux interactions sont considérées comme deux interactions, mais font partie du même scénario.	93893746-e203-e9b6-18b9-887d68d18daf
msdyn_scenariotype	Fait référence à la fonctionnalité utilisée par l’agent.	Poser une question
msdyn_interactiontypename	Fait référence à l’interaction spécifique de l’agent avec Copilot.	Généré
msdyn_interaction pour l’ID	Le cas ou la conversation à partir de laquelle l’agent a interagi avec Copilot	1cd6023d-d326-ee11-9966-000d3a3411cf (cas à partir duquel l’interaction a été initiée)
msdyn_interactioncontext	Contexte supplémentaire tel qu’une référence à des transcriptions.
msdyn_interactiondataid	Fait référence à l’entité msdyn_copilotinteractiondata qui contient des données d’interaction

Copiez la valeur du DataId à partir du msdyn_interactioncontext. Voici un exemple du contexte JSON.


     { 
      "ResponseStatusCode": 20000, 
      "Plugins": { 
       }, 
       "Transcript": { 
       "Id": "c477c6dd-d877-c6d1-9337-31e5b54e4a1b", 
       "DataId": "0a7a438f-c2a5-58d7-e03d-c932812b3095"  
       }, 
       "Filters": { 
        "AgentContextFilters": [ 
        ], 
        "DynamicFilters": { 
          "IsApplied": false 
       } 
    } 
  }

Dans notre exemple, cette valeur est 0a7a438f-c2a5-58d7-e03d-c932812b3095.

La requête d’API Web suivante récupère la transcription dans la transcription codée en base64.

 [Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(<Trascript:DataID>)/msdyn_transcriptdata)
 Accept: application/json  
 OData-MaxVersion: 4.0  
 OData-Version: 4.0

Dans notre exemple, la requête API Web est la suivante.

 [Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(0a7a438f-c2a5-58d7-e03d-c932812b3095)/msdyn_transcriptdata

Décodez les données codées en base64 pour obtenir la transcription. Vous pouvez utiliser un outil de décodage base64 en ligne pour décoder les données. Pour notre exemple, la transcription décodée s’affiche comme suit.


{
  "messages": [
    {
      "id": "283c2269-b131-dac2-3aed-847bd99402e7",
      "requestId": "93893746-e203-e9b6-18b9-887d68d18daf",
      "message": "How can I book a trip?",
      "sequence": 0,
      "user": "user",
      "timestamp": 1711052758750,
      "isActivityError": false,
      "context": {}
    },
    {
      "id": "eba9e9d5-71e2-9502-0bca-9387246fb094",
      "requestId": "93893746-e203-e9b6-18b9-887d68d18daf",
      "message": "To book a trip, follow these steps:\n\n1. Go to the travel portal.\n2. Click on \"Travel\" and then select \"Book a Trip\".\n3. Fill in your name, contact information, and the dates of your trip.\n4. Choose your destination from the drop-down menu. Here's the data you'll be working with:\n\n```json\n{\n    \"id\": \"11bb11bb-cc22-dd33-ee44-55ff55ff55ff\",\n    \"title\": \"Booking Travel\",\n    \"source\": \"internal_kb\"\n}\n```\n\n5. Select a hotel from the drop-down menu and specify the check-in and check-out dates. If you don't want to book a hotel, you can check the \"I do not want to book a hotel\" box.\n6. Choose the type of rental car you want. If you don't want to rent a car, you can check the \"I do not want to rent a car\" box.\n7. Click \"Submit\".\n\nOnce you've submitted your booking request, you will receive a follow-up communication from an agent with a quote. You can also add any notes or additional information by clicking on the case from the My Bookings screen.",
      "sequence": 1,
      "user": "bot",
      "timestamp": 1711052776968,
      "isActivityError": false,
      "sources": [
        {
          "id": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
          "title": "Booking Travel",
          "source": "internal_kb"
        }
      ],
      "context": {
        "customerIntent": "How to book a trip?"
      }
    }
  ],
  "context": {
    "chatId": "21b27e83-299d-a639-3e4a-8dcd6332e184",
    "sessionId": "session-id-2",
    "entityId": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
    "entityName": "knowledgearticle"
  }
}

Récupérer des commentaires textuels

Lorsqu’un agent interagit avec Copilot, il peut fournir des commentaires sur les réponses fournies par Copilot. Les commentaires sont stockés dans la table msdyn_copilotinteraction Dataverse.

Par exemple, le réponse du copilote n’est pas exact et l’agent sélectionne l’icône du pouce vers le bas pour fournir un commentaire. L’agent fournit également des commentaires textuels. L’application crée un enregistrement dans la table avec le paramètre ThumbsDown. msdyn_copilotinteraction msdyn_interactiontypename

Les principaux attributs du dossier sont les suivants.

Attribute	Exemple de données pour notre exemple
msdyn_copilotinteractionid	817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid	93893746-e203-e9b6-18b9-887d68d18daf
msdyn_scenariotype	Poser une question
msdyn_interactiontypename	ThumbsDown
msdyn_interaction pour l’ID	1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext
msdyn_interactiondataid	807ff9e4-cbe7-ee11-904c-000d3a3bb867

Vous pouvez obtenir le retour textuel fourni par l’agent comme suit.

Obtenez la valeur requise dans la table.msdyn_interactiondataid msdyn_copilotinteraction

Exécutez la requête API Web suivante pour récupérer les commentaires textuels au format codé en base64.


   [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_copilotinteractiondataid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0

Dans notre exemple, la requête API Web est la suivante.

[Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(807ff9e4-cbe7-ee11-904c-000d3a3bb867)

Décodez les données codées en base64 pour obtenir le retour textuel. Vous pouvez utiliser un outil de décodage base64 en ligne pour décoder les données. Pour notre exemple, le feedback textuel est disponible dans la colonne msdyn_verbatim .


  {
  "@odata.context": "https://ocrealtimeperftest001.crm.dynamics.com/api/data/v9.1/$metadata#msdyn_copilotinteractiondatas/$entity",
  "@odata.etag": "W/\"29538313\"",
  "_owningbusinessunit_value": "0e9ec0a2-eb6a-ed11-9561-000d3a336228",
  "statecode": 0,
  "statuscode": 1,
  "_createdby_value": "586cb7a8-eb6a-ed11-9561-000d3a336228",
  "msdyn_copilotinteractiondataid": "807ff9e4-cbe7-ee11-904c-000d3a3bb867",
  "_ownerid_value": "586cb7a8-eb6a-ed11-9561-000d3a336228",
  "modifiedon": "2024-03-21T21:42:21Z",
  "msdyn_verbatim": "Article is outdated",
  "_owninguser_value": "586cb7a8-eb6a-ed11-9561-000d3a336228",
  "_modifiedby_value": "586cb7a8-eb6a-ed11-9561-000d3a336228",
  "versionnumber": 29538313,
  "createdon": "2024-03-21T21:42:21Z",
  "msdyn_interactiondata_name": null,
  "overriddencreatedon": null,
   "importsequencenumber": null,
  "_modifiedonbehalfby_value": null,
  "msdyn_interactiondata": null,
  "utcconversiontimezonecode": null,
  "_createdonbehalfby_value": null,
  "msdyn_name": null,
  "_owningteam_value": null,
  "timezoneruleversionnumber": null
}

Téléchargement des données interaction

Pour toutes les autres interactions entre les agents et Copilot, les données sont stockées dans le msdyn_copilotinteractiondata tableau de Dataverse.

Par exemple, une interaction peut être un agent utilisant Copilot pour générer un e-mail et un résumé du dossier. Les attributs clés de notre exemple sont les suivants.

Attribute	Valeur pour notre scénario
msdyn_copilotinteractionid	0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid	42ae7f8e-736f-1cea-035b-6bf970b48e9c
msdyn_scenariotype	Résumé de l’incident
msdyn_interactiontypename	Généré
msdyn_interaction pour l’ID	1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext	`{"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}`
msdyn_interactiondataid	f9d841e5-34e7-ee11-904c-000d3a3bb867

Vous pouvez télécharger les données d’interaction comme suit.

Utilisez l’appel de l’API Web pour obtenir l’ID d’interaction.

Exécutez la requête API Web suivante pour récupérer les données d’interaction de la table au format codé en base64 : msdyn_copilotinteraction

 [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_interactiondataid>)/msdyn_copilotinteractiondata
 Accept: application/json  
 OData-MaxVersion: 4.0  
 OData-Version: 4.0

Dans notre exemple, la requête API Web est la suivante.

  [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatasf9d841e5-34e7-ee11-904c-000d3a3bb867)/msdyn_interactiondata

Décodez les données codées en base64 pour obtenir la transcription. Vous pouvez utiliser un outil de décodage base64 en ligne pour décoder les données. Pour notre exemple de Courrier électronique, la données interaction décodée s’affiche comme suit.

Obtenir ID interaction

Chaque interaction d’agent avec Copilot est stockée dans la msdyn_copilotinteraction table avec un ID d’interaction unique. Vous pouvez utiliser l’appel d’API Web suivant pour obtenir l’ID d’interaction dans le champ msdyn_copilotinteractionid .

[Organization URI]/api/data/v9.1/msdyn_copilotinteractions
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0

Les interactions sont affichées dans la réponse comme suit.


{
"@odata.context": "https://copilotchatorg260224.crm10.dynamics.com/api/data/v9.1/$metadata#msdyn_copilotinteractions",
"value": [
  {
    "_createdby_value": "78866530-afd0-ee11-904d-6045bdff74d5",
    "createdon": "2024-03-06T06:30:58Z",
    "_createdonbehalfby_value": null,
    "importsequencenumber": null,
    "_modifiedby_value": "78866530-afd0-ee11-904d-6045bdff74d5",
    "modifiedon": "2024-03-06T06:30:58Z",
    "_modifiedonbehalfby_value": null,
    "msdyn_clienttimestamp": "2024-03-06T06:30:51Z",
    "msdyn_copilotinteractionid": "1be35d14-83db-ee11-904c-000d3a100664",
    "msdyn_interactioncontext": "{}",
    "_msdyn_interactiondataid_value": null,
    "msdyn_interactionforid": "78866530-afd0-ee11-904d-6045bdff74d5",
    "msdyn_interactionforlogicalname": "systemuser",
    "msdyn_interactiontype": 100230309,
    "msdyn_name": null,
    "msdyn_scenariorequestid": null,
    "msdyn_scenariotype": 100230201,
    "_organizationid_value": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
    "overriddencreatedon": null,
    "statecode": 0,
    "statuscode": 1,
    "timezoneruleversionnumber": 4,
    "utcconversiontimezonecode": 92,
    "versionnumber": 7002510,
    "@odata.etag": "W/\"7002510\""
  },
  {
    "_createdby_value": "f691f2d2-6fd4-ee11-904c-6045bdd8b8c9",
    "createdon": "2024-03-11T04:45:40Z",
    "_createdonbehalfby_value": null,
    "importsequencenumber": null,
    "_modifiedby_value": "f691f2d2-6fd4-ee11-904c-6045bdd8b8c9",
    "modifiedon": "2024-03-11T04:45:40Z",
    "_modifiedonbehalfby_value": null,
    "msdyn_clienttimestamp": "2024-03-11T04:45:38Z",
    "msdyn_copilotinteractionid": "d44ad235-62df-ee11-904c-000d3a100664",
    "msdyn_interactioncontext": "{}",
    "_msdyn_interactiondataid_value": null,
    "msdyn_interactionforid": "f691f2d2-6fd4-ee11-904c-6045bdd8b8c9",
    "msdyn_interactionforlogicalname": "systemuser",
    "msdyn_interactiontype": 100230309,
    "msdyn_name": null,
    "msdyn_scenariorequestid": null,
    "msdyn_scenariotype": 100230201,
    "_organizationid_value": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
    "overriddencreatedon": null,
    "statecode": 0,
    "statuscode": 1,
    "timezoneruleversionnumber": 4,
    "utcconversiontimezonecode": 92,
    "versionnumber": 7310986,
    "@odata.etag": "W/\"7310986\""
  },

Utiliser Copilot pour résoudre les problèmes des clients
Afficher le rapport d’analyse du copilote

Partager via

Téléchargez les transcriptions et les données d’interaction de Copilot

Conditions préalables

Télécharger la transcriptions de la conversation

Récupérer des commentaires textuels

Téléchargement des données interaction

Obtenir ID interaction

Commentaires

Ressources supplémentaires

Partager via

Téléchargez les transcriptions et les données d’interaction de Copilot

Conditions préalables

Télécharger la transcriptions de la conversation

Récupérer des commentaires textuels

Téléchargement des données interaction

Obtenir ID interaction

Informations associées

Commentaires

Ressources supplémentaires