Downloade Copilot-afskrifter og -interaktionsdata

Kundeservicemedarbejdere (servicerepræsentanter eller repræsentanter) bruger Copilot-funktioner som f.eks. kopiering af oversigter, brug af et foreslået svar, feedback og chat. Copilot-interaktioner gemmes i tabellerne Copilot-interaktion (msdyn_copilotinteraction),Copilot-interaktionsdata (msdyn_copilotinteractiondata),Copilot-afskrift (msdyn_copilottranscript) og Copilot-afskriftsdata (msdyn_copilottranscriptdata) i Dataverse. Du kan downloade afskrifter og interaktionsdata ved hjælp af Dataverse Web API eller SDK til .NET.

Fra august 2025 gemmes copilot-interaktioner i msdyn_copilotevents tabellen. msdyn_copilotinteraction- og msdyn_copilotinteractiondata-tabellerne indeholder poster før august.

Forudsætninger

  • Sørg for, at afkrydsningsfeltet Supportoplevelsesdata er markeret i Copilot for spørgsmål og mails, så transaktions- og interaktionsdataene gemmes af systemet i Dataverse.
  • Sørg for, at du er logget på med rollen Omnikanal-administrator eller Omnikanal-tilsynsførende.

Hent samtaleoversigt

Når en servicemedarbejder bruger Copilot til at generere en samtaleoversigt, gemmes oversigten i msdyn_conversationinsight tabellen i Dataverse. Der oprettes en post i tabellen med et entydigt samtale-id, gemt i feltet msdyn_ConversationId. Oversigtsteksten gemmes i msdyn_copilotsummary feltet.

Når en servicemedarbejder f.eks. har afsluttet en samtale med en kunde, bruger han Copilot til at generere en samtaleoversigt. Samtaleoversigten gemmes i msdyn_conversationinsight tabellen med følgende værdier.

Attribut Eksempel på værdi
Samtale-ID 70B76AB52-120B-49E6-9DCE-53F235125A01
Samtaleoversigt "Problem: Problemer med bryggeventilen på kaffemaskinen. Trin til fejlfinding: Kunden har rapporteret problemet. Resultat: Problem rapporteret for yderligere assistance."

Du kan hente samtaleoversigten på følgende måde:

  1. Identificer samtale-id'et, som er det primære id for posten i msdyn_ocliveworkitem tabellen. I vores eksempel er denne værdi 70b76ab52-120b-49e6-9dce-53f235125a01.

  2. Brug følgende web-API-anmodning til at filtrere tabelposten msdyn_conversationinsight .

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

    I vores eksempel er web-API-anmodningen som følger.

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

    Eksempelsvaret for vores eksempel er som følger:

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

Hvor gemmes mine copilot-interaktioner

Hver servicerepræsentant-interaktion med Copilot gemmes i msdyn_copilotinteraction ELLER-tabellen msdyn_copilotevents med et unikt interaktions-ID. I følgende tabel vises, hvor de tilsvarende interaktionsdata er gemt for hver interaktionstype.

Funktion Tabel
Stil et spørgsmål msdyn_copilottranscriptdata
Feedback, sagsresumé, skriv en e-mail, foreslå et svar msdyn_copilotinteractiondata, msdyn_copilotevents

Bemærk

Copilot-interaktionsposter gemmes i msdyn_copilotevents tabellen fra august 2025. Optegnelser før august opbevares i msdyn_copilotinteraction og msdyn_copilotinteractiondata tabellerne.

Få msdyn_copilotinteractionid og msdyn_interactiondataid fra copilot-interaktionsposter

Før du udfører handlinger som f.eks. at downloade en afskrift eller se ordret feedback, skal du hente værdierne for msdyn_copilotinteractionid og den tilsvarende msdyn_copilotinteractiondata post-id-værdi fra msdyn_copilotinteraction. Du kan bruge følgende web-API-kald til at hente interaktions-id'et msdyn_copilotinteractionid i feltet og interactiondataid i msdyn_interactiondataid_value feltet.

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

Få msdyn_copilotinteractionid fra Copilot Event Records

Før du downloader et transkript eller ser ordret feedback, skal du hente værdierne af msdyn_copilotinteractionid fra msdyn_copilotevents tabellen. Du kan bruge følgende Web API-kald til at få interaktions-ID'et i feltet msdyn_copilotinteractionid .

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

Vigtige attributter

De vigtigste egenskaber fra registret er som følger.

Attribut Definition
msdyn_copilotinteractionid Entydigt id for objektforekomster
msdyn_scenariorequestid Grupperer flere relaterede Copilot-interaktioner.
For eksempel: En repræsentant stiller Copilot et spørgsmål og markerer derefter det modtagne svar med tommelfinger op. De betragtes som to interaktioner, men er en del af det samme scenarie.
msdyn_scenariotype Henviser til den funktion, der bruges af repræsentanten.
msdyn_interactiontype Henviser til den specifikke repræsentative interaktion med Copilot.
msdyn_interactionforid Enheds-id'et for den refererede post, som repræsentanten interagerede med Copilot for.
msdyn_interactionforlogicalname Det logiske enhedsnavn på den post, der refereres til, som repræsentanten interagerede med Copilot for.
msdyn_interactioncontext Yderligere kontekst såsom henvisning til transskriptioner.
msdyn_interactiondataid Refererer til msdyn_copilotinteractiondata objekt, der indeholder interaktionsdata

Eksempelsvar

Følgende svar angiver et scenarie, hvor en repræsentant stiller Copilot et spørgsmål og derefter vælger tommelfingeren ned-knappen for at give feedback. , msdyn_scenariorequestidmsdyn_scenariotype er den samme for begge interaktioner. Værdierne msdyn_interactiontype for interaktionerne er angivet til 100230305 og 100230302, hvilket svarer til Genereret og Tommelfinger nedad.


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

Download chatudskrifter

Når en servicemedarbejder stiller Copilot et spørgsmål, gemmes chatten som en afskrift, der er kodet i det base64-kodede format ved hjælp af UTF-16LE-tegnsættet msdyn_copilottranscriptdata i tabellen i Dataverse. Du kan downloade transskriptionerne for at gennemgå samtalen og svarene fra Copilot.

For eksempel, mens han arbejder på en sag, spørger servicerepræsentanten Copilot "Hvordan kan jeg booke en rejse?". Copilot genererer et svar baseret på en vidensbaseartikel. Hvis du vil downloade chatafskriften, skal du udføre følgende trin:

  1. Brug web-API-kaldet til at hente interaktions-id'et.

  2. Filtrer tabellen msdyn_copilotinteraction med det påkrævede interaktions-id for at få adgang til attributten Transcript.DataID from msdyn_interactioncontext . Brug følgende web-API-anmodning til at filtrere dataene efter interaktions-id.

    
       [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
       Accept: application/json  
       OData-MaxVersion: 4.0  
       OData-Version: 4.0  
    
    Attribut Værdi for vores scenarie
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid 93893746-E203-E9B6-18B9-887D68D18DAF
    msdyn_scenariotype Stil et spørgsmål
    msdyn_interaktionstypnavn Genereret
    msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF (Tilfælde, hvorfra interaktionen blev indledt)
    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. Kopier værdien af Trasncript.DataId fra msdyn_interactioncontext. I vores eksempel er denne værdi a1584aaf-d5bd-357d-54a8-84dbdba547f9.

  4. Følgende web-API-anmodning henter den kodede afskrift i base64/UTF-16LE-formatet.

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

    I vores eksempel er web-API-anmodningen som følger.

     [Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(a1584aaf-d5bd-357d-54a8-84dbdba547f9)/msdyn_transcriptdata
    
  5. Afkod de kodede data ved hjælp af en base64-dekoder med UTF-16LE-tegnsættet for at få transskriptionen. Du kan bruge et online dekoderværktøj til at afkode dataene. I vores eksempel vises den afkodede udskrift som følger.

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

Hent nøjagtig feedback

Når en repræsentant interagerer med Copilot, kan de give feedback på de svar, som Copilot giver. Feedbacken msdyn_verbatim gemmes i kolonnen i msdyn_copilotinteractiondata tabellen i Dataverse.

Copilotens svar er f.eks. ikke nøjagtigt, og repræsentanten vælger tommelfingeren ned-ikonet for at give feedback. Repræsentanten giver også ordret feedback. Programmet opretter en post i msdyn_copilotinteraction tabellen med indstillingen msdyn_interactiontypename til Tommelfinger ned.

De vigtigste attributter for posten er som følger.

Attribut Eksempeldata til vores eksempel
msdyn_copilotinteractionid 817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-E203-E9B6-18B9-887D68D18DAF
msdyn_scenariotype Stil et spørgsmål
msdyn_interactiontype 100230302
msdyn_interaktionstypnavn Tommelfinger ned
msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF
msdyn_interactiondataid 807ff9e4-cbe7-ee11-904c-000d3a3bb867
partitionid 20250622-20250628-100230203

Bemærk

PartitionID gælder kun, hvis du bruger tabellen msdyn_copilotevents .

Du kan få den ordrede feedback fra repræsentanten som følger.

  1. Hent den påkrævede post-id-værdi for msdyn_copilotinteractiondata fra msdyn_copilotinteraction tabellen.

Bemærk

Spring dette trin over, hvis du bruger tabellen msdyn_copilotevents . Det er msdyn_copilotinteractiondataid allerede tilgængeligt i tabellen msdyn_copilotevents .

  1. Kør følgende web-API-anmodning for at hente den ordrede feedback.

    Hvis du bruger tabellen msdyn_copilotevents , så brug følgende:

    [Organization URI]/api/data/v9.1/msdyn_copilotevents(msdyn_copiloteventid=<GUID>,partitionid='<partitionId>')
    

    I vores eksempel er Web API-anmodningen som følger:

    [Organization URI]/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')
    
  2. Se den ordret feedback, der er tilgængelig i kolonnen msdyn_verbatim. For vores eksempel er den feedback, der hentes, som følger.

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

Download interaktionsdata

Bortset fra udskrifter af spørgsmål, gemmes data for alle andre interaktioner mellem repræsentanter og Copilot i msdyn_copilotinteractiondata tabellen i msdyn_copilotevents Dataverse.

En interaktion kan f.eks. være en repræsentant, der bruger Copilot til at generere en e-mail eller et sagsresumé. De vigtigste egenskaber for vores eksempel er som følger.

Attribut Værdi for vores scenarie
msdyn_copilotinteractionid 0DD941E5-34E7-EE11-904C-000D3A3BB867
msdyn_scenariorequestid 42ae7f8e-736f-1cea-035b-6bf970b48e9c
msdyn_scenariotype Sagsoversigt
msdyn_interactiontype 100230305
msdyn_interaktionstypnavn Genereret
msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF
msdyn_interactioncontext {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}
msdyn_interactiondataid F9D841E5-34E7-EE11-904C-000D3A3BB867

Du kan downloade interaktionsdataene på følgende måde.

  1. Hent den påkrævede post-id-værdi for msdyn_copilotinteractiondata fra msdyn_copilotinteraction tabellen.

Bemærk

Spring dette trin over, hvis du bruger tabellen msdyn_copilotevents . Det er msdyn_copilotinteractiondataid allerede tilgængeligt i tabellen msdyn_copilotevents .

  1. Kør følgende Web API-anmodning for at hente interaktionsdataene i base64-kodede format:

    Hvis du bruger msdyn_copilotevents-tabellen, så brug følgende:

    <org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=<GUID>,partitionid='<partitionId>')/msdyn_interactiondata/$value 
    

    I vores eksempel er Web API-anmodningen som følger:

    <org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')/msdyn_interactiondata/$value 
    

  1. Afkod de base64-kodede data for at få udskriften. Du kan bruge et online base64-dekoderværktøj til at afkode dataene. I vores e-mail-eksempel vises de afkodede interaktionsdata som følger.

Bemærk

Stil et spørgsmål, foreslå et svar, og udkast til en e-mail-funktion Brug base64-koderen med UTF-16LE-tegnsættet. Sags- og samtaleoversigt bruger UTF-8-tegnsæt. Vi anbefaler, at du bruger det samme tegnsæt, som blev brugt til at kode data for at afkode dem.

Skærmbillede af de afkodede interaktionsdata.

Bruge Copilot til at løse kundeproblemer
Vis copilot-analyserapport