„Copilot“ transkripcijų ir sąveikos duomenų atsisiuntimas

Klientų aptarnavimo atstovai (aptarnavimo atstovai arba atstovai) naudoja "Copilot" funkcijas, pvz., suvestinių kopijavimą, siūlomo atsakymo, atsiliepimo ir pokalbių naudojimą. "Copilot" sąveikos saugomos "Dataverse" lentelėse "Copilot Interaction (msdyn_copilotinteraction)", "Copilot Interaction Data" (msdyn_copilotinteractiondata), "Copilot Transcript" (msdyn_copilottranscript) ir "Copilot Transcript Data" (msdyn_copilottranscriptdata ). Nuorašus ir sąveikos duomenis galite atsisiųsti naudodami "Dataverse" žiniatinklio API arba SDK, skirtą .NET.

Nuo 2025 m. rugpjūčio kopiloto sąveikos saugomos msdyn_copilotevents lentelėje. msdyn_copilotinteraction ir msdyn_copilotinteractiondata lentelėse pateikiami įrašai iki rugpjūčio.

Būtinosios sąlygos

  • Įsitikinkite, kad "Copilot" pažymėtas žymimasis laukelis Palaikymo patirties duomenys klausimams ir el. laiškams, kad operacijų ir sąveikos duomenis sistema saugotų "Dataverse".
  • Įsitikinkite, kad esate prisijungę naudodami daugiakanalio administratoriaus arba daugiakanalio prižiūrėtojo vaidmenį.

Pokalbio suvestinės gavimas

Kai tarnybos atstovas pokalbio suvestinei generuoti naudoja "Copilot", suvestinė saugoma msdyn_conversationinsight "Dataverse" lentelėje. Lentelėje sukuriamas įrašas su lauke saugomu msdyn_ConversationId unikaliu pokalbio ID. Suvestinės msdyn_copilotsummary tekstas saugomas lauke.

Pavyzdžiui, užbaigęs pokalbį su klientu, aptarnavimo atstovas naudoja "Copilot", kad sugeneruotų pokalbio suvestinę. Pokalbio suvestinė saugoma msdyn_conversationinsight lentelėje su šiomis reikšmėmis.

Atributas Imties vertė
Pokalbio ID 70B76AB52-120B-49E6-9DCE-53F235125A01
Pokalbio suvestinė "Problema: bėda su kavos aparato virimo vožtuvu. Trikčių šalinimo veiksmai: klientas pranešė apie problemą. Rezultatas: pranešta apie problemą dėl tolesnės pagalbos."

Pokalbio suvestinę galite gauti taip:

  1. Identifikuokite pokalbio ID, kuris yra pirminis lentelės įrašo msdyn_ocliveworkitem identifikatorius. Mūsų pavyzdyje ši vertė yra 70b76ab52-120b-49e6-9dce-53f235125a01.

  2. Norėdami filtruoti lentelės įrašą, msdyn_conversationinsight naudokite šią žiniatinklio API užklausą.

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

    Mūsų pavyzdyje žiniatinklio API užklausa yra tokia.

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

    Mūsų pavyzdžio atsakymo pavyzdys yra toks:

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

Kur saugomos mano kopiloto sąveikos

Kiekviena paslaugų atstovo sąveika su Copilot saugoma msdyn_copilotinteraction OR msdyn_copilotevents lentelėje su unikaliu sąveikos ID. Toliau pateiktoje lentelėje išvardyta, kur saugomi kiekvieno sąveikos tipo atitinkami sąveikos duomenys.

Funkcija Lentelė
Užduoti klausimą msdyn_copilottranscriptdata
Atsiliepimai, atvejo santrauka, el. laiško rašymas, atsakymo siūlymas msdyn_copilotinteractiondata, msdyn_copilotevents

Pastaba.

Copilot sąveikos įrašai saugomi lentelėje msdyn_copilotevents nuo 2025 m. rugpjūčio. Įrašai iki rugpjūčio saugomi msdyn_copilotinteraction ir msdyn_copilotinteractiondata lentelėse.

Gaukite msdyn_copilotinteractionid ir msdyn_interactiondataid iš kopiloto sąveikos įrašų

Prieš atlikdami veiksmus, pvz., atsisiųsdami nuorašą arba peržiūrėdami pažodinį atsiliepimą, turite nuskaityti reikšmes msdyn_copilotinteractionid ir atitinkamą msdyn_copilotinteractiondata įrašo ID reikšmę iš msdyn_copilotinteraction. Galite naudoti šį žiniatinklio API iškvietimą, kad gautumėte sąveikos ID msdyn_copilotinteractionid lauke ir interactiondataid msdyn_interactiondataid_value lauke.

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

Gaukite msdyn_copilotinteractionid iš copilot įvykių įrašų

Prieš atsisiųsdami transkriptą arba peržiūrėdami žodinį grįžtamąjį ryšį, turite gauti reikšmes msdyn_copilotinteractionid iš msdyn_copilotevents lentelės. Galite naudoti šį Web API kvietimą, kad gautumėte sąveikos ID msdyn_copilotinteractionid lauke.

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

Pagrindiniai atributai

Pagrindiniai įrašo atributai yra šie.

Atributas Apibrėžtis
msdyn_copilotinteractionid Objekto egzempliorių unikalus identifikatorius
msdyn_scenariorequestid Grupuoja kelias susijusias "Copilot" sąveikas.
Pavyzdžiui: atstovas užduoda "Copilot" klausimą ir tada pažymi gautą atsakymą nykščiais į viršų. Jie laikomi dviem sąveikomis, tačiau yra to paties scenarijaus dalis.
msdyn_scenariotype Nurodo funkciją, kurią naudoja atstovas.
msdyn_interactiontype Nurodo specifinę reprezentatyvią sąveiką su "Copilot".
msdyn_interactionforid Nurodyto įrašo, dėl kurio atstovas bendravo su "Copilot", objekto ID.
msdyn_interactionforlogicalname Nurodyto įrašo objekto loginis pavadinimas, dėl kurio atstovas bendravo su "Copilot".
msdyn_interactioncontext Papildomas kontekstas, pvz., nuoroda į nuorašus.
msdyn_interactiondataid Nurodo objektą msdyn_copilotinteractiondata kuriame yra sąveikos duomenų

Atsakymo pavyzdys

Toliau pateiktame atsakyme nurodomas scenarijus, kai atstovas užduoda "Copilot" klausimą, o tada pasirenka nykščio žemyn mygtuką, kad pateiktų atsiliepimą. , msdyn_scenariorequestidmsdyn_scenariotype yra tas pats abiem sąveikoms. Sąveikų msdyn_interactiontype reikšmės nustatomos į 100230305 ir 100230302, kurios atitinka sugeneruotas ir nykščius žemyn.


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

Pokalbių stenogramų atsisiuntimas

Kai tarnybos atstovas užduoda "Copilot" klausimą, pokalbis įrašomas kaip nuorašas, užkoduotas "base64" užkoduotu formatu, naudojant UTF-16LE simbolių rinkinį msdyn_copilottranscriptdata "Dataverse" lentelėje. Galite atsisiųsti nuorašus, kad peržiūrėtumėte pokalbį ir "Copilot" pateiktus atsakymus.

Pavyzdžiui, dirbdamas su byla, tarnybos atstovas klausia "Copilot" "Kaip galiu užsisakyti kelionę?". Kopilotas sugeneruoja atsakymą, pagrįstą žinių bazės straipsniu. Jei norite atsisiųsti pokalbio stenogramą, atlikite šiuos veiksmus:

  1. Naudokite žiniatinklio API skambutį, kad gautumėte sąveikos ID.

  2. Filtruokite msdyn_copilotinteraction lentelę su reikiamu sąveikos ID, kad pasiektumėte atributą Transcript.DataID nuo msdyn_interactioncontext . Naudokite šią žiniatinklio API užklausą, kad filtruotumėte duomenis pagal sąveikos ID.

    
   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0
    Atributas Mūsų scenarijaus vertė
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
    msdyn_scenariotype Užduoti klausimą
    msdyn_interactiontypename Generuota
    msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF (atvejis, kai buvo inicijuota sąveika)
    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. Nukopijuokite reikšmę Trasncript.DataId iš msdyn_interactioncontext. Mūsų pavyzdyje ši vertė yra a1584aaf-d5bd-357d-54a8-84dbdba547f9.

  4. Ši žiniatinklio API užklausa nuskaito užkoduotą transkripciją base64/UTF-16LE formatu.

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

    Mūsų pavyzdyje žiniatinklio API užklausa yra tokia.

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

  5. Dekoduokite užkoduotus duomenis naudodami base64 dekoderį su UTF-16LE simbolių rinkinio parinktimi, kad gautumėte transkripciją. Duomenims iššifruoti galite naudoti internetinį dekoderio įrankį. Mūsų pavyzdyje dekoduotas transkriptas rodomas taip.

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

Gauti pažodinį atsiliepimą

Kai atstovas bendrauja su "Copilot", jis gali pateikti atsiliepimus apie "Copilot" pateiktus atsakymus. Atsiliepimas saugomas msdyn_verbatim "Dataverse" lentelės stulpelyje msdyn_copilotinteractiondata .

Pavyzdžiui, "Copilot" atsakymas nėra tikslus ir atstovas pasirenka nykščio žemyn piktogramą, kad pateiktų atsiliepimą. Atstovas taip pat pateikia stenogramą. Programa sukuria įrašą lentelėje, msdyn_copilotinteraction kurioje msdyn_interactiontypename nustatyta į ThumbsDown.

Pagrindiniai įrašo atributai yra šie.

Atributas Duomenų pavyzdžiai mūsų pavyzdžiui
msdyn_copilotinteractionid 817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
msdyn_scenariotype Užduoti klausimą
msdyn_interactiontype 100230302
msdyn_interactiontypename NykščiaiŽemyn
msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF
msdyn_interactiondataid 807ff9e4-cbe7-ee11-904c-000d3a3bb867
partitionid 20250622-20250628-100230203

Pastaba.

PartitionID taikomas tik tuo atveju, jei naudojate msdyn_copilotevents lentelę.

Atstovo pateiktus atsiliepimus apie stenogramą galite gauti taip.

  1. Iš lentelės gaukite reikiamą msdyn_copilotinteractiondata įrašo ID reikšmęmsdyn_copilotinteraction.

Pastaba.

Praleiskite šį žingsnį, jei naudojate msdyn_copilotevents stalą. Tai msdyn_copilotinteractiondataid jau yra lentelėje msdyn_copilotevents .

  1. Paleiskite šią žiniatinklio API užklausą, kad gautumėte stenogramą.

    Jei naudojate msdyn_copilotevents lentelę, naudokite šiuos:

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

    Mūsų pavyzdyje Web API užklausa yra tokia:

    [Organization URI]/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')

  2. Peržiūrėkite stenogramą, pateiktą msdyn_verbatim stulpelyje. Mūsų pavyzdyje gauti atsiliepimai yra tokie.

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

Sąveikos duomenų atsisiuntimas

Išskyrus klausimų uždavimo stenogramas, visoms kitoms atstovų ir Copilot sąveikoms duomenys saugomi msdyn_copilotinteractiondata arba msdyn_copilotevents lentelėje Dataverse.

Pavyzdžiui, sąveika gali būti atstovas, naudojantis "Copilot", kad sugeneruotų el. laišką arba atvejo suvestinę. Pagrindiniai mūsų pavyzdžio atributai yra šie.

Atributas Mūsų scenarijaus vertė
msdyn_copilotinteractionid 0DD941E5-34E7-EE11-904C-000D3A3BB867
msdyn_scenariorequestid 42AE7F8E-736F-1CEA-035B-6BF970B48E9C
msdyn_scenariotype Bylos santrauka
msdyn_interactiontype 100230305
msdyn_interactiontypename Generuota
msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF
msdyn_interactioncontext {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}
msdyn_interactiondataid F9D841E5-34E7-EE11-904C-000D3A3BB867

Sąveikos duomenis galite atsisiųsti taip.

  1. Iš lentelės gaukite reikiamą msdyn_copilotinteractiondata įrašo ID reikšmęmsdyn_copilotinteraction.

Pastaba.

Praleiskite šį žingsnį, jei naudojate msdyn_copilotevents stalą. Tai msdyn_copilotinteractiondataid jau yra lentelėje msdyn_copilotevents .

  1. Paleiskite šią žiniatinklio API užklausą, kad gautumėte sąveikų duomenis base64 koduotu formatu:

    Jei naudojate msdyn_copilotevents lentelę, naudokite šiuos:

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

    Mūsų pavyzdyje Web API užklausa yra tokia:

    <org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')/msdyn_interactiondata/$value
  1. Dekoduokite bazinius64 užkoduotus duomenis, kad gautumėte transkriptą. Duomenims iššifruoti galite naudoti internetinį "base64" dekoderio įrankį. Mūsų el. pašto pavyzdyje dekoduoti sąveikos duomenys rodomi taip.

Pastaba.

Užduokite klausimą, pasiūlykite atsakymą ir sukurkite el. laiško funkcijų juodraštį naudodami base64 kodavimo įrenginį su UTF-16LE simbolių rinkiniu. Atvejo ir pokalbio suvestinėje naudojamas UTF-8 simbolių rinkinys. Rekomenduojame naudoti tą patį simbolių rinkinį, kuris buvo naudojamas duomenims koduoti, kad juos iššifruotumėte.

Dekoduotų sąveikos duomenų ekrano kopija.

Naudokite "Copilot", kad išspręstumėte klientų problemas
Peržiūrėkite "Copilot" analizės ataskaitą

  • Paskutinį kartą atnaujinta