Copilot-transcripties en interactiegegevens downloaden

Klantenservicemedewerkers (servicemedewerkers of vertegenwoordigers) gebruiken Copilot-functies zoals het kopiëren van samenvattingen, het gebruik van een voorgesteld antwoord, feedback en chat. Copilot-interacties worden opgeslagen in de tabellen Copilot Interaction (msdyn_copilotinteraction)), Copilot Interaction Data (msdyn_copilotinteractiondata),Copilot Transcript (msdyn_copilottranscript) en Copilot Transcript Data (msdyn_copilottranscriptdata) in Dataverse. U kunt de transcripties en interactiegegevens downloaden met behulp van Dataverse Web API of SDK voor .NET.

Vereiste voorwaarden

• Zorg ervoor dat het selectievakje Gegevens over ondersteuningservaring is ingeschakeld in Copilot voor vragen en e-mails, zodat de transactie- en interactiegegevens door het systeem worden opgeslagen in Dataverse.
• Zorg ervoor dat je bent ingelogd met de rol van Omnichannel-beheerder of Omnichannel-supervisor.

Gespreksoverzicht ophalen

Wanneer een servicemedewerker Copilot gebruikt om een gespreksoverzicht te genereren, wordt het overzicht opgeslagen in de msdyn_conversationinsight tabel in Dataverse. Er wordt een record gemaakt in de tabel met een unieke gespreks-ID die in het msdyn_ConversationId veld is opgeslagen. De samenvattende tekst wordt in het msdyn_copilotsummary veld opgeslagen.

Na het afronden van een gesprek met een klant gebruikt een servicemedewerker bijvoorbeeld Copilot om een gesprekssamenvatting te genereren. Het gespreksoverzicht wordt opgeslagen in de msdyn_conversationinsight tabel met de volgende waarden.

U kunt het gespreksoverzicht als volgt ophalen:

1. Identificeer de gespreks-ID, de primaire id van de record in de msdyn_ocliveworkitem tabel. In ons voorbeeld is deze waarde 70b76ab52-120b-49e6-9dce-53f235125a01.

2. Gebruik de volgende web-API-aanvraag om de msdyn_conversationinsight tabelrecord te filteren.

   
    [Organization URI]/api/data/v9.2/msdyn_conversationinsights?$filter=_msdyn_conversationid_value eq '<conversation-ID>'
   
   

   In ons voorbeeld is de web-API-aanvraag als volgt.

    https://<yourorg>.crm.dynamics.com/api/data/v9.2/msdyn_conversationinsights?$filter=_msdyn_conversationid_value eq '70b76ab52-120b-496e-9dce-53f235125a01'
   

   Het voorbeeldantwoord voor ons voorbeeld is als volgt:

   {
   "status": { "code": 20000, "message": "Successfully fetched summary from insights" },
   "summary": "Issue: Trouble with the brew valve on the coffee machine.\nTroubleshooting steps: \n- Customer reported the issue.\nOutcome: Issue reported for further assistance."
   }
   

Waar worden mijn interacties met de copiloot opgeslagen?

Elke interactie van een servicevertegenwoordiger met Copilot wordt in de msdyn_copilotinteraction tabel opgeslagen met een unieke interactie-ID. In de volgende tabel wordt aangegeven waar de bijbehorende interactiegegevens voor elk interactietype zijn opgeslagen.

Haal msdyn_copilotinteractionid en msdyn_interactiondataid uit interactierecords van copiloten

Voordat u acties uitvoert, zoals het downloaden van een transcript of het weergeven van woordelijke feedback, moet u de waarden van msdyn_copilotinteractionid en de bijbehorende msdyn_copilotinteractiondata record-ID-waarde ophalen van msdyn_copilotinteraction. U kunt de volgende web-API-aanroep gebruiken om de interactie-id in het msdyn_copilotinteractionid veld en de interactiondataid in het msdyn_interactiondataid_value veld op te halen.

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

De belangrijkste kenmerken uit het record zijn als volgt.

Voorbeeldantwoord

Het volgende antwoord geeft een scenario aan waarin een vertegenwoordiger de copiloot een vraag stelt en vervolgens de knop met de duim omlaag selecteert om feedback te geven. De msdyn_scenariorequestid, msdyn_scenariotype is hetzelfde voor beide interacties. De msdyn_interactiontype-waarden voor de interacties zijn ingesteld op 100230305 en 100230302, wat overeenkomt met Gegenereerd en Duim omlaag.

{
          "@odata.etag": "W/\"17413914\"",
          "msdyn_interactiontype": 100230305,
          "msdyn_clienttimestamp": "2025-03-19T08:00:34Z",
          "modifiedon": "2025-03-19T08:00:34Z",
          "msdyn_interactionforlogicalname": "msdyn_ocliveworkitem",
          "overriddencreatedon": null,
          "msdyn_scenariotype": 100230201,
          "importsequencenumber": null,
          "_modifiedonbehalfby_value": null,
          "msdyn_interactionforid": "2cc5ea06-a4fd-4f83-8e75-0324383b953f",
          "statecode": 0,
          "msdyn_scenariorequestid": "cbdc1bef-6099-7f9a-f1fe-dab02e36315b",
          "_organizationid_value": "7eede269-bbb1-ef11-8a64-000d3a350e1a",
          "versionnumber": 17413914,
          "utcconversiontimezonecode": 190,
          "_msdyn_interactiondataid_value": null,
          "_createdonbehalfby_value": null,
          "_modifiedby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
          "createdon": "2025-03-19T08:00:34Z",
          "msdyn_interactioncontext": "{\"OcSessionId\":\"28dea393-c175-4788-9494-07fd42ee0884\",\"ResponseStatusCode\":20000,\"Plugins\":{\"IsContentRedacted\":false},\"Transcript\":{\"Id\":\"8d1d70e6-3297-644a-4e86-00d8973223a0\",\"DataId\":\"a1584aaf-d5bd-357d-54a8-84dbdba547f9\"},\"Filters\":{\"AgentContextFilters\":[],\"AutomatedFilters\":[]},\"Streaming\":{\"State\":\"GENERATED\"},\"ResponseSource\":{\"category\":\"KnowledgeSearch\",\"subCategory\":\"KnowledgeSearch\"},\"IsAutoPrompt\":true,\"AutoPromptTrigger\":\"follow-up-prompt\",\"IsAutoExpanded\":false,\"IsSuggestedPrompt\":false,\"IsEmbed\":false,\"IsStandalone\":false}",
          "msdyn_name": null,
          "statuscode": 1,
          "msdyn_copilotinteractionid": "c49dc43b-9804-f011-bae2-6045bd014292",
          "_createdby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
          "timezoneruleversionnumber": 0
      },
      {
          "@odata.etag": "W/\"17413983\"",
          "msdyn_interactiontype": 100230302,
          "msdyn_clienttimestamp": "2025-03-19T08:00:37Z",
          "modifiedon": "2025-03-19T08:00:41Z",
          "msdyn_interactionforlogicalname": "msdyn_ocliveworkitem",
          "overriddencreatedon": null,
          "msdyn_scenariotype": 100230201,
          "importsequencenumber": null,
          "_modifiedonbehalfby_value": null,
          "msdyn_interactionforid": "2cc5ea06-a4fd-4f83-8e75-0324383b953f",
          "statecode": 0,
          "msdyn_scenariorequestid": "cbdc1bef-6099-7f9a-f1fe-dab02e36315b",
          "_organizationid_value": "7eede269-bbb1-ef11-8a64-000d3a350e1a",
          "versionnumber": 17413983,
          "utcconversiontimezonecode": 190,
          "_msdyn_interactiondataid_value": null,
          "_createdonbehalfby_value": null,
          "_modifiedby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
          "createdon": "2025-03-19T08:00:41Z",
          "msdyn_interactioncontext": "{\"OcSessionId\":\"28dea393-c175-4788-9494-07fd42ee0884\",\"IsEmbed\":false,\"IsStandalone\":false}",
          "msdyn_name": null,
          "statuscode": 1,
          "msdyn_copilotinteractionid": "cb9dc43b-9804-f011-bae2-6045bd014292",
          "_createdby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
          "timezoneruleversionnumber": 0
      },

Chattranscripties downloaden

Wanneer een servicemedewerker een vraag stelt aan Copilot, wordt de chat opgeslagen als een transcriptie die is gecodeerd in de base64-gecodeerde indeling met behulp van UTF-16LE-tekenset in de msdyn_copilottranscriptdata tabel in Dataverse. U kunt de transcripties downloaden om het gesprek en de antwoorden van Copilot te bekijken.

Tijdens het werken aan een case vraagt de servicemedewerker bijvoorbeeld aan Copilot: "Hoe kan ik een reis boeken?". Copilot genereert een antwoord op basis van een artikel in de kennisbank. Als u het chattranscript wilt downloaden, voert u de volgende stappen uit:

1. Gebruik de web-API-aanroep om de interactie-ID op te halen.

2. Filter de msdyn_copilotinteraction tabel met de vereiste interactie-id om van het msdyn_interactioncontext kenmerk naar Transcript.DataID te gaan. Gebruik de volgende web-API-aanvraag om de gegevens te filteren op interactie-id.

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

   Eigenschap	Waarde voor ons scenario
   msdyn_copilotinteractionid	F0970641-C1E7-EE11-904C-000D3A3BB867
   msdyn_scenariorequestid	93893746-e203-e9b6-18b9-887d68d18daf
   msdyn_scenariotype	Een vraag stellen
   msdyn_interactiontypename	Gegenereerd
   msdyn_interactionforid	1cd6023d-d326-ee11-9966-000d3a3411cf (casus van waaruit de interactie is geïnitieerd)
   msdyn_interactioncontext	{\"OcSessionId\":\"28dea393-c175-4788-9494-07fd42ee0884\",\"ResponseStatusCode\":20000,\"Plugins\":{\"IsContentRedacted\":false},\"Transcript\":{\"Id\":\"8d1d70e6-3297-644a-4e86-00d8973223a0\",\"DataId\":\"a1584aaf-d5bd-357d-54a8-84dbdba547f9\"},\"Filters\":{\"AgentContextFilters\":[],\"AutomatedFilters\":[]},\"Streaming\":{\"State\":\"GENERATED\"},\"ResponseSource\":{\"category\":\"KnowledgeSearch\",\"subCategory\":\"KnowledgeSearch\"},\"IsAutoPrompt\":true,\"AutoPromptTrigger\":\"follow-up-prompt\",\"IsAutoExpanded\":false,\"IsSuggestedPrompt\":false,\"IsEmbed\":false,\"IsStandalone\":false}

3. Kopieer de waarde van de Trasncript.DataId uit de msdyn_interactioncontext. In ons voorbeeld is deze waarde a1584aaf-d5bd-357d-54a8-84dbdba547f9.

4. Met de volgende web-API-aanvraag wordt het gecodeerde transcript opgehaald in de base64/UTF-16LE-indeling.

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

   In ons voorbeeld is de web-API-aanvraag als volgt.

    [Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(a1584aaf-d5bd-357d-54a8-84dbdba547f9)/msdyn_transcriptdata
   

5. Decodeer de gecodeerde gegevens met behulp van een base64-decoder met de UTF-16LE-tekensetoptie om het transcript te krijgen. U kunt een online decodertool gebruiken om de gegevens te decoderen. In ons voorbeeld wordt het gedecodeerde transcript als volgt weergegeven.
   

   
   {
     "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 a representative 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"
     }
   } 
   
   

Letterlijke feedback ophalen

Wanneer een vertegenwoordiger interactie heeft met Copilot, kan deze feedback geven op de antwoorden die Copilot geeft. De feedback wordt opgeslagen in de msdyn_verbatim kolom in de msdyn_copilotinteractiondata tabel in Dataverse.

Het antwoord van de Copilot is bijvoorbeeld niet nauwkeurig en de vertegenwoordiger selecteert het pictogram met de duim omlaag om feedback te geven. De vertegenwoordiger geeft ook woordelijke feedback. De toepassing maakt een record in de msdyn_copilotinteraction-tabel met de msdyn_interactiontypename ingesteld op ThumbsDown.

De belangrijkste kenmerken voor het record zijn als volgt.

U kunt de woordelijke feedback van de vertegenwoordiger als volgt krijgen.

1. Haal de vereiste msdyn_copilotinteractiondata record-ID-waarde op uit de msdyn_copilotinteraction tabel.

2. Voer de volgende web-API-aanvraag uit om de letterlijke feedback op te halen.

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

   In ons voorbeeld is de web-API-aanvraag als volgt.

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

3. Bekijk de volledige feedback die beschikbaar is in de msdyn_verbatim kolom. In ons voorbeeld is de opgehaalde feedback als volgt.
   

   
     {
     "@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
   }
   
   

Interactiegegevens downloaden

Met uitzondering van vraag-afschriften worden voor alle andere interacties tussen vertegenwoordigers en Copilot gegevens opgeslagen in de msdyn_copilotinteractiondata-tabel in Dataverse.

Een interactie kan bijvoorbeeld een vertegenwoordiger zijn die Copilot gebruikt om een e-mail of een case-samenvatting te genereren. De belangrijkste kenmerken voor ons voorbeeld zijn als volgt.

U kunt de interactiegegevens als volgt downloaden.

1. Haal de vereiste msdyn_copilotinteractiondata record-ID-waarde op uit de msdyn_copilotinteraction tabel.

2. Voer de volgende web-API-aanvraag uit om de interactiegegevens op te halen uit de msdyn_copilotinteractiondata tabel in de base64-gecodeerde indeling:

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

   In ons voorbeeld is de web-API-aanvraag als volgt.

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

3. Decodeer de base64-gecodeerde gegevens om het transcript te krijgen. U kunt een online base64-decodertool gebruiken om de gegevens te decoderen. Voor ons e-mailvoorbeeld worden de gedecodeerde interactiegegevens als volgt weergegeven.

Verwante informatie

Copilot gebruiken om problemen van klanten op te lossen
Bekijk het analyserapport van de copilot