Del via

Last ned Copilot-utskrifter og -samhandlingsdata

Kundeservicerepresentanter (servicerepresentanter eller representanter) bruker Copilot-funksjoner som å kopiere sammendrag, bruke et foreslått svar, tilbakemelding og chat. Copilot-samhandlinger lagres i tabellene Copilot-samhandling (msdyn_copilotinteraction),Copilot-samhandlingsdata (msdyn_copilotinteractiondata),Copilot-utskrift (msdyn_copilottranscript) og Copilot-transkripsjonsdata (msdyn_copilottranscriptdata) i Dataverse. Du kan laste ned utskriftene og samhandlingsdataene ved hjelp av Dataverse Web API eller SDK for .NET.

Forutsetninger

  • Kontroller at det er merket av for Støtteopplevelsesdata i Copilot for spørsmål og e-postmeldinger, slik at transaksjons- og samhandlingsdataene lagres av systemet i Dataverse.
  • Kontroller at du er logget på med rollen Omnikanaladministrator eller Omnikanal-leder.

Hente diskusjonssammendrag

Når en servicerepresentant bruker Copilot til å generere et diskusjonssammendrag, lagres sammendraget i msdyn_conversationinsight tabellen i Dataverse. Det opprettes en oppføring i tabellen med en unik diskusjons-ID som er lagret i msdyn_ConversationId feltet. Oppsummeringsteksten lagres i msdyn_copilotsummary feltet.

Etter å ha avsluttet en samtale med en kunde, bruker en servicerepresentant for eksempel Copilot til å generere et diskusjonssammendrag. Diskusjonssammendraget lagres i msdyn_conversationinsight tabellen med følgende verdier.

Attributt Eksempel på verdi
Samtale-ID 70B76AB52-120B-49E6-9DCE-53F235125A01
Samtalesammendrag "Problem: Problemer med bryggeventilen på kaffemaskinen. Feilsøkingstrinn: Kunden rapporterte problemet. Utfall: Problem rapportert for ytterligere hjelp."

Du kan hente samtalesammendraget på følgende måte:

  1. Identifiser diskusjons-ID-en, som er den primære identifikatoren for oppføringen i msdyn_ocliveworkitem tabellen. I vårt eksempel er denne verdien 70b76ab52-120b-49e6-9dce-53f235125a01.

  2. Bruk følgende web-API-forespørsel til å filtrere tabelloppføringen msdyn_conversationinsight .

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

    I vårt eksempel er Web API-forespørselen 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 vårt 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 lagres copilot-interaksjonene mine

Hver servicerepresentantinteraksjon med Copilot lagres i msdyn_copilotinteraction tabellen med en unik interaksjons-ID. Tabellen nedenfor viser hvor de tilsvarende samhandlingsdataene er lagret for hver samhandlingstype.

Funksjon Tabell
Still et spørsmål msdyn_copilottranscriptdata
Tilbakemelding, sakssammendrag, skrive en e-post, foreslå et svar msdyn_copilotinteractiondata

Få msdyn_copilotinteractionid og msdyn_interactiondataid fra copilot-samhandlingsoppføringer

Før du utfører handlinger som å laste ned en utskrift eller vise ordrett tilbakemelding, må du hente verdiene msdyn_copilotinteractionid til og den tilsvarende msdyn_copilotinteractiondata post-ID-verdien fra msdyn_copilotinteraction. Du kan bruke følgende web-API-kall til å hente samhandlings-ID-en i msdyn_copilotinteractionid 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

Nøkkelattributtene fra registeret er som følger.

Attributt Definisjon
msdyn_copilotinteractionid Unik identifikator for enhetsinstanser
msdyn_scenariorequestid Grupperer flere relaterte Copilot-interaksjoner.
For eksempel: En representant stiller Copilot et spørsmål og markerer deretter svaret som mottas med tommel opp. De betraktes som to interaksjoner, men er en del av samme scenario.
msdyn_scenariotype Refererer til funksjonen som brukes av representanten.
msdyn_interactiontype Refererer til den spesifikke representative interaksjonen med Copilot.
msdyn_interactionforid Enhets-ID-en for den refererte oppføringen, som representanten samhandlet med Copilot for.
msdyn_interactionforlogicalname Det logiske navnet på enheten for den refererte oppføringen, som representanten samhandlet med Copilot for.
msdyn_interactioncontext Ytterligere kontekst som referanse til transkripsjoner.
msdyn_interactiondataid Refererer til msdyn_copilotinteractiondata enhet som inneholder samhandlingsdata

Eksempelsvar

Følgende svar angir et scenario der en representant stiller Copilot et spørsmål, og deretter velger tommel ned-knappen for å gi tilbakemelding. , msdyn_scenariorequestidmsdyn_scenariotype er den samme for begge interaksjonene. Verdiene msdyn_interactiontype for samhandlingene er satt til 100230305 og 100230302, som tilsvarer Generert og Tommel ned.


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

Last ned chat-transkripsjoner

Når en servicerepresentant stiller Copilot et spørsmål, lagres chatten som en utskrift kodet i det base64-kodede formatet ved hjelp av UTF-16LE-tegnsettet i msdyn_copilottranscriptdata tabellen i Dataverse. Du kan laste ned transkripsjonene for å se gjennom samtalen og svarene fra Copilot.

For eksempel, mens han jobber med en sak, spør servicerepresentanten Copilot "Hvordan kan jeg bestille en tur?". Copilot genererer et svar basert på en kunnskapsbaseartikkel. Hvis du vil laste ned chatutskriften, utfører du følgende trinn:

  1. Bruk web-API-kallet til å hente samhandlings-ID-en.

  2. Filtrer msdyn_copilotinteraction tabellen med den nødvendige interaksjons-ID-en for å gå til from-attributtet Transcript.DataIDmsdyn_interactioncontext . Bruk følgende web-API-forespørsel til å filtrere dataene etter samhandlings-ID.

    
   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0
    Attributt Verdi for scenarioet vårt
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid 93893746-E203-E9B6-18B9-887D68D18DAF
    msdyn_scenariotype Still et spørsmål
    msdyn_interactiontypename Generert
    msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF (sak som interaksjonen ble initiert fra)
    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 verdien til fra Trasncript.DataId .msdyn_interactioncontext I vårt eksempel er denne verdien a1584aaf-d5bd-357d-54a8-84dbdba547f9.

  4. Følgende Web API-forespørsel henter den kodede utskriften 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 vårt eksempel er Web API-forespørselen som følger.

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

  5. Dekod de kodede dataene ved hjelp av en base64-dekoder med UTF-16LE-tegnsettalternativet for å få transkripsjonen. Du kan bruke et online dekoderverktøy for å dekode dataene. For vårt eksempel vises den dekodede transkripsjonen 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 ordrett tilbakemelding

Når en representant samhandler med Copilot, kan de gi tilbakemelding på svarene som Copilot gir. Tilbakemeldingen msdyn_verbatim lagres i kolonnen i msdyn_copilotinteractiondata tabellen i Dataverse.

Copilotens svar er for eksempel ikke nøyaktig, og representanten velger tommel ned-ikonet for å gi tilbakemelding. Representanten gir også ordrett tilbakemelding. Programmet oppretter en post i msdyn_copilotinteraction tabellen med msdyn_interactiontypename satt til ThumbsDown.

Nøkkelattributtene for oppføringen er som følger.

Attributt Eksempeldata for vårt eksempel
msdyn_copilotinteractionid 817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-E203-E9B6-18B9-887D68D18DAF
msdyn_scenariotype Still et spørsmål
msdyn_interactiontype 100230302
msdyn_interactiontypename ThumbsDown
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactiondataid 807ff9e4-cbe7-ee11-904c-000d3a3bb867

Du kan få den ordrette tilbakemeldingen gitt av representanten som følger.

  1. Hent den nødvendige msdyn_copilotinteractiondata oppførings-ID-verdien fra msdyn_copilotinteraction tabellen.

  2. Kjør følgende web-API-forespørsel for å hente den ordrette tilbakemeldingen.

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

    I vårt eksempel er Web API-forespørselen som følger.

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

  3. Se den ordrette tilbakemeldingen som er tilgjengelig i msdyn_verbatim kolonnen. For vårt eksempel er tilbakemeldingene som 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
}

Laste ned interaksjonsdata

Med unntak av utskrifter av et spørsmål, lagres data i msdyn_copilotinteractiondata tabellen i Dataverse for alle andre samhandlinger mellom representanter og Copilot.

En samhandling kan for eksempel være en representant som bruker Copilot til å generere en e-post eller et sakssammendrag. De viktigste egenskapene for vårt eksempel er som følger.

Attributt Verdi for scenarioet vårt
msdyn_copilotinteractionid 0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 42ae7f8e-736f-1cea-035b-6bf970b48e9c
msdyn_scenariotype Sakssammendrag
msdyn_interactiontype 100230305
msdyn_interactiontypename Generert
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}
msdyn_interactiondataid F9D841E5-34E7-EE11-904C-000D3A3BB867

Du kan laste ned samhandlingsdataene på følgende måte.

  1. Hent den nødvendige msdyn_copilotinteractiondata oppførings-ID-verdien fra msdyn_copilotinteraction tabellen.

  2. Kjør følgende web-API-forespørsel for å hente samhandlingsdataene fra msdyn_copilotinteractiondata tabellen i base64-kodede format:

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

    I vårt eksempel er Web API-forespørselen som følger.

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

  3. Dekod de base64-kodede dataene for å få utskriften. Du kan bruke et online base64-dekoderverktøy for å dekode dataene. For vårt e-posteksempel vises de dekodede interaksjonsdataene som følger.

Merk deg

Still et spørsmål, foreslå et svar og utkast til en e-postfunksjon bruk base64-koderen med UTF-16LE-tegnsettet. Saks- og samtalesammendrag bruker UTF-8-tegnsett. Vi anbefaler at du bruker det samme tegnsettet som ble brukt til å kode data for å dekode dem.

Skjermbilde av de dekodede samhandlingsdataene.

Bruk Copilot til å løse kundeproblemer
Vis Copilot-analyse-rapport

  • Last updated on