Copiloti transkriptsioonide ja suhtlusandmete allalaadimine

Klienditeenindajad (teenindajad või esindajad) kasutavad Copiloti funktsioone, nagu kokkuvõtete kopeerimine, soovitatud vastuse kasutamine, tagasiside ja vestlus. Copiloti interaktsioonid talletatakse Dataverse'i tabelites Copiloti interaktsioon (msdyn_copilotinteraction),Copiloti interaktsiooni andmed (msdyn_copilotinteractiondata),Copiloti ärakiri (msdyn_copilottranscript) ja Copiloti transkriptsiooni andmed (msdyn_copilottranscriptdata). Transkriptsioonid ja interaktsiooniandmed saate alla laadida Dataverse'i veebi API või SDK for .NET abil.

Eeltingimused

  • Veenduge, et küsimuste ja meilide jaoks oleks Copilotis märgitud ruut Tugiteenuse kogemuse andmed, et süsteem salvestaks kande- ja suhtlusandmed Dataverse'is.
  • Veenduge, et oleksite sisse logitud omnikanali administraatori või omnikanali järelevaataja rolliga.

Vestluse kokkuvõtte toomine

Kui teenindaja kasutab vestluse kokkuvõtte loomiseks Copiloti, salvestatakse msdyn_conversationinsight kokkuvõte Dataverse'i tabelisse. Tabelisse luuakse kirje, mille väljale msdyn_ConversationId on salvestatud kordumatu vestluse ID. Kokkuvõtlik tekst talletatakse msdyn_copilotsummary väljal.

Näiteks pärast kliendiga peetud vestluse lõpetamist kasutab teenindaja vestluse kokkuvõtte loomiseks Copiloti. Vestluse kokkuvõte talletatakse msdyn_conversationinsight tabelis järgmiste väärtustega.

Atribuut Valimi väärtus
Vestluse ID 70B76AB52-120B-49E6-9DCE-53F235125A01
Vestluse kokkuvõte "Probleem: Probleem kohvimasina keeduventiiliga. Veaotsingu juhised: klient teatas probleemist. Tulemus: Edasise abi saamiseks teatati probleemist."

Vestluse kokkuvõtte saate alla laadida järgmiselt.

  1. Tuvastage vestluse ID, mis on tabelis msdyn_ocliveworkitem oleva kirje esmane identifikaator. Meie näites on see väärtus 70b76ab52-120b-49e6-9dce-53f235125a01.

  2. Kasutage tabelikirje filtreerimiseks msdyn_conversationinsight järgmist veebi API taotlust.

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

    Meie näites on veebi API päring järgmine.

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

    Meie näite näidisvastus on järgmine:

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

Kuhu on salvestatud minu kaaspiloodi interaktsioonid

Iga teenindusesindaja suhtlus Copilotiga salvestatakse tabelisse msdyn_copilotinteraction kordumatu interaktsiooni ID-ga. Järgmises tabelis on loetletud iga interaktsioonitüübi vastavad interaktsiooniandmed.

Funktsioon Tabel
Esitage küsimus msdyn_copilottranscriptdata
Tagasiside, juhtumi kokkuvõte, e-kirja kirjutamine, vastuse soovitamine msdyn_copilotinteractiondata

Hankige msdyn_copilotinteractionid ja msdyn_interactiondataid kaaspiloodi suhtluskirjetest

Enne toimingute tegemist, nagu transkriptsiooni allalaadimine või sõna-sõnalise tagasiside vaatamine, peate tooma väärtused msdyn_copilotinteractionid ja vastava msdyn_copilotinteractiondata kirje ID väärtuse .msdyn_copilotinteraction Saate kasutada järgmist veebi API kutset, et hankida interaktsiooni ID msdyn_copilotinteractionid väljal ja interactiondataid väljal msdyn_interactiondataid_value .

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

Kirje peamised atribuudid on järgmised.

Atribuut Määratlus
msdyn_copilotinteractionid Olemi eksemplaride kordumatu identifikaator
msdyn_scenariorequestid Rühmitab mitu seotud Copiloti interaktsiooni.
Näiteks: esindaja esitab Copilotile küsimuse ja märgib saadud vastuse pöidlaga üles. Neid peetakse kaheks interaktsiooniks, kuid need on osa samast stsenaariumist.
msdyn_scenariotype Viitab esindaja kasutatavale funktsioonile.
msdyn_interactiontype Viitab konkreetsele esinduslikule suhtlusele Copilotiga.
msdyn_interactionforid Viidatud kirje olemi ID, mille puhul esindaja Copilotiga suhtles.
msdyn_interactionforlogicalname Viidatud kirje olemi loogiline nimi, mille puhul esindaja Copilotiga suhtles.
msdyn_interactioncontext Täiendav kontekst, näiteks viide transkriptsioonidele.
msdyn_interactiondataid Viitab msdyn_copilotinteractiondata olemile, mis sisaldab interaktsiooniandmeid

Näidisvastus

Järgmine vastus näitab stsenaariumi, kus esindaja esitab Copilotile küsimuse ja seejärel valib tagasiside andmiseks pöidla alla. msdyn_scenariorequestid msdyn_scenariotype, on mõlema interaktsiooni puhul sama. Interaktsioonide msdyn_interactiontype väärtused on seatud väärtusele 100230305 ja 100230302, mis vastavad väärtustele Loodud ja Pöidlad alla.


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

Vestluste ärakirjade allalaadimine

Kui teeninduse esindaja esitab Copilotile küsimuse, salvestatakse vestlus transkriptsioonina, mis on kodeeritud base64 kodeeritud vormingus, kasutades Dataverse'i tabelis msdyn_copilottranscriptdata UTF-16LE märgistikku. Saate alla laadida transkriptsioonid, et vaadata üle vestlus ja Copiloti antud vastused.

Näiteks juhtumiga töötades küsib teenindusesindaja Copilotilt "Kuidas ma saan reisi broneerida?". Copilot genereerib vastuse teadmusbaasi artikli põhjal. Kui soovite vestluse transkriptsiooni alla laadida, tehke järgmist.

  1. Kasutage interaktsiooni ID hankimiseks veebi API kutset.

  2. Filtreerige tabeli msdyn_copilotinteraction vajaliku interaktsiooni ID-ga, et jõuda Transcript.DataID atribuudi from.msdyn_interactioncontext Kasutage järgmist veebi API taotlust, et filtreerida andmeid interaktsiooni ID järgi.

    
   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0
    Atribuut Meie stsenaariumi väärtus
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
    msdyn_scenariotype Esitage küsimus
    msdyn_interactiontypename Genereeritud
    msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF (juhtum, millest koostoime alguse sai)
    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. Kopeerige väärtus Trasncript.DataId .msdyn_interactioncontext Meie näites on see väärtus a1584aaf-d5bd-357d-54a8-84dbdba547f9.

  4. Järgmine veebi API päring toob kodeeritud transkriptsiooni base64/UTF-16LE vormingus.

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

    Meie näites on veebi API päring järgmine.

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

  5. Dekodeeritud andmed, kasutades transkriptsiooni saamiseks base64 dekoodrit koos märgistiku valikuga UTF-16LE. Andmete dekodeerimiseks saate kasutada veebipõhist dekoodri tööriista. Meie näite puhul kuvatakse dekodeeritud transkriptsioon järgmiselt.

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

Sõna-sõnalise tagasiside hankimine

Kui esindaja suhtleb Copilotiga, saab ta anda tagasisidet Copiloti antud vastuste kohta. Tagasiside salvestatakse msdyn_verbatim Dataverse'i tabeli veergu.msdyn_copilotinteractiondata

Näiteks ei ole Copiloti vastus täpne ja esindaja valib tagasiside andmiseks pöidla alla ikooni. Esindaja annab ka sõna-sõnalist tagasisidet. Rakendus loob tabelisse msdyn_copilotinteraction kirje, mille väärtuseks msdyn_interactiontypename on seatud ThumbsDown.

Kirje peamised atribuudid on järgmised.

Atribuut Meie näite näidisandmed
msdyn_copilotinteractionid 817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
msdyn_scenariotype Esitage küsimus
msdyn_interactiontype 100230302
msdyn_interactiontypename Pöidlad alla
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactiondataid 807ff9e4-cbe7-ee11-904c-000d3a3bb867

Esindaja antud sõna-sõnalise tagasiside saate järgmiselt.

  1. Hankige tabelist msdyn_copilotinteractionnõutav msdyn_copilotinteractiondata kirje ID väärtus.

  2. Sõna-sõnalise tagasiside hankimiseks käivitage järgmine veebi API päring.

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

    Meie näites on veebi API päring järgmine.

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

  3. Vaadake veerus saadaolevat msdyn_verbatim sõna-sõnalist tagasisidet. Meie näite puhul on saadud tagasiside järgmine.

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

Laadige alla interaktsiooniandmed

Välja arvatud küsimuse esitamise transkriptsioonid, salvestatakse msdyn_copilotinteractiondata andmed kõigi muude esindajate ja Copiloti vaheliste suhtluste puhul Dataverse'i tabelisse.

Näiteks võib suhtlus olla esindaja, kes kasutab Copiloti meili või juhtumi kokkuvõtte loomiseks. Meie näite peamised atribuudid on järgmised.

Atribuut Meie stsenaariumi väärtus
msdyn_copilotinteractionid 0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 42AE7F8E-736F-1CEA-035B-6BF970B48E9C
msdyn_scenariotype Juhtumi kokkuvõte
msdyn_interactiontype 100230305
msdyn_interactiontypename Genereeritud
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}
msdyn_interactiondataid f9d841e5-34e7-ee11-904c-000d3a3bb867

Interaktsiooniandmeid saate alla laadida järgmiselt.

  1. Hankige tabelist msdyn_copilotinteractionnõutav msdyn_copilotinteractiondata kirje ID väärtus.

  2. Käivitage järgmine veebi API päring, et tuua interaktsioonide andmed tabelist msdyn_copilotinteractiondata base64 kodeeritud vormingus:

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

    Meie näites on veebi API päring järgmine.

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

  3. Dekodeerige base64 kodeeritud andmed, et saada transkriptsioon. Andmete dekodeerimiseks saate kasutada veebipõhist base64 dekoodri tööriista. Meie e-posti näite puhul kuvatakse dekodeeritud interaktsiooniandmed järgmiselt.

Märkus.

Esitage küsimus, pakkuge vastust ja koostage e-kiri funktsioonid kasutage UTF-16LE märgistikuga base64 kodeerijat. Teenindusjuhtumi ja vestluse kokkuvõttes kasutatakse UTF-8 märgistikku. Soovitame dekodeerimiseks kasutada sama märgistikku, mida kasutati andmete kodeerimiseks.

Ekraanipilt dekodeeritud interaktsiooniandmetest.

Copiloti kasutamine klientide probleemide lahendamiseks
Vaadake Copiloti analüüsiaruannet

  • Last updated on