Muat turun transkrip dan data interaksi Copilot

Wakil perkhidmatan pelanggan (wakil perkhidmatan atau wakil) menggunakan ciri Copilot seperti menyalin ringkasan, menggunakan jawapan yang dicadangkan, maklum balas dan sembang. Interaksi Copilot disimpan dalam jadual Interaksi Copilot (msdyn_copilotinteraction),Data Interaksi Copilot (msdyn_copilotinteractiondata),Transkrip Copilot (msdyn_copilottranscript) dan Data Transkrip Copilot (msdyn_copilottranscriptdata) dalam Dataverse. Anda boleh memuat turun transkrip dan data interaksi menggunakan Dataverse Web API atau SDK untuk .NET.

Mulai Ogos 2025, interaksi copilot disimpan dalam jadual msdyn_copilotevents . Jadual msdyn_copilotinteraction dan msdyn_copilotinteractiondata mengandungi rekod sebelum Ogos.

Prasyarat

  • Pastikan kotak semak data pengalaman sokongan dipilih dalam Copilot untuk soalan dan e-mel, supaya data transaksi dan interaksi disimpan oleh sistem dalam Dataverse.
  • Pastikan anda log masuk dengan peranan pentadbir Omnichannel atau penyelia Omnichannel.

Dapatkan ringkasan perbualan

Apabila wakil perkhidmatan menggunakan Copilot untuk menjana ringkasan perbualan, ringkasan disimpan dalam msdyn_conversationinsight jadual dalam Dataverse. Rekod dicipta dalam jadual dengan ID perbualan unik yang disimpan dalam msdyn_ConversationId medan. Teks ringkasan disimpan dalam msdyn_copilotsummary medan.

Sebagai contoh, selepas mengakhiri perbualan dengan pelanggan, wakil perkhidmatan menggunakan Copilot untuk menjana ringkasan perbualan. Ringkasan perbualan disimpan dalam msdyn_conversationinsight jadual dengan nilai berikut.

Atribut Nilai Sampel
ID Perbualan 70b76ab52-120b-49e6-9dce-53f235125a01
Ringkasan perbualan "Isu: Masalah dengan injap minuman pada mesin kopi. Langkah penyelesaian masalah: Pelanggan melaporkan isu tersebut. Hasil: Isu dilaporkan untuk bantuan lanjut."

Anda boleh mendapatkan ringkasan perbualan seperti berikut:

  1. Kenal pasti ID perbualan, yang merupakan pengecam utama rekod dalam msdyn_ocliveworkitem jadual. Dalam contoh kami, nilai ini ialah 70b76ab52-120b-49e6-9dce-53f235125a01.

  2. Gunakan permintaan API Web berikut untuk menapis msdyn_conversationinsight rekod jadual.

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

    Dalam contoh kami, permintaan API Web adalah seperti berikut.

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

    Contoh respons untuk contoh kami adalah seperti berikut:

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

Di manakah interaksi copilot saya disimpan

Setiap interaksi wakil perkhidmatan dengan Copilot disimpan dalam msdyn_copilotinteraction jadual atau msdyn_copilotevents dengan ID interaksi unik. Jadual berikut menyenaraikan tempat data interaksi yang sepadan disimpan untuk setiap jenis interaksi.

Ciri Jadual
Tanyakan soalan msdyn_copilottranscriptdata
Maklum balas, ringkasan kes, tulis e-mel, cadangkan respons msdyn_copilotinteractiondata, msdyn_copilotevents

Nota

Rekod interaksi Copilot disimpan dalam msdyn_copilotevents jadual, bermula Ogos 2025. Rekod sebelum Ogos disimpan dalam msdyn_copilotinteraction jadual dan msdyn_copilotinteractiondata .

Dapatkan msdyn_copilotinteractionid dan msdyn_interactiondataid daripada rekod interaksi copilot

Sebelum anda melakukan tindakan seperti memuat turun transkrip atau melihat maklum balas kata demi kata, anda mesti mendapatkan semula nilai msdyn_copilotinteractionid dan nilai ID rekod msdyn_copilotinteractiondata yang sepadan daripada msdyn_copilotinteraction. Anda boleh menggunakan panggilan API Web berikut untuk mendapatkan ID interaksi dalam msdyn_copilotinteractionid medan dan interactiondataid dalam msdyn_interactiondataid_value medan.

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

Dapatkan msdyn_copilotinteractionid daripada rekod acara copilot

Sebelum anda memuat turun transkrip atau melihat maklum balas verbatim, anda mesti mendapatkan nilai dari msdyn_copilotinteractionidmsdyn_copilotevents jadual. Anda boleh menggunakan panggilan API Web berikut untuk mendapatkan ID interaksi dalam msdyn_copilotinteractionid medan.

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

Atribut utama

Atribut utama daripada rekod adalah seperti berikut.

Atribut Takrif
msdyn_copilotinteractionid Pengecam unik untuk tika entiti
msdyn_scenariorequestid Kumpulan pelbagai interaksi Copilot yang berkaitan.
Sebagai contoh: Seorang wakil bertanya soalan kepada Copilot dan kemudian menandakan respons yang diterima dengan ibu jari. Mereka dianggap sebagai dua interaksi, tetapi merupakan sebahagian daripada senario yang sama.
msdyn_scenariotype Merujuk kepada ciri yang digunakan oleh wakil.
msdyn_interactiontype Merujuk kepada interaksi perwakilan khusus dengan Copilot.
msdyn_interactionforid ID entiti rekod yang dirujuk, yang mana wakil berinteraksi dengan Copilot.
msdyn_interactionforlogicalname Nama logik entiti bagi rekod yang dirujuk, yang mana wakil berinteraksi dengan Copilot.
msdyn_interactioncontext Konteks tambahan seperti rujukan kepada transkrip.
msdyn_interactiondataid Merujuk kepada entiti msdyn_copilotinteractiondata yang mengandungi data interaksi

Contoh respons

Respons berikut menunjukkan senario di mana wakil bertanya soalan kepada Copilot, dan kemudian memilih butang ibu jari ke bawah untuk memberikan maklum balas. msdyn_scenariorequestid, msdyn_scenariotype adalah sama untuk kedua-dua interaksi. msdyn_interactiontype Nilai untuk interaksi ditetapkan kepada 100230305 dan 100230302, yang sepadan dengan Dijana dan Ibu Jari ke bawah.


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

Muat turun transkrip sembang

Apabila wakil perkhidmatan bertanya soalan kepada Copilot, sembang disimpan sebagai transkrip yang dikodkan dalam format yang dikodkan base64 menggunakan set aksara UTF-16LE dalam msdyn_copilottranscriptdata jadual dalam Dataverse. Anda boleh memuat turun transkrip untuk menyemak perbualan dan respons yang disediakan oleh Copilot.

Sebagai contoh, semasa mengerjakan kes, wakil perkhidmatan bertanya kepada Copilot "Bagaimanakah saya boleh menempah perjalanan?". Copilot menjana respons berdasarkan artikel pangkalan pengetahuan. Jika anda mahu memuat turun transkrip sembang, lakukan langkah berikut:

  1. Gunakan panggilan API web untuk mendapatkan ID interaksi.

  2. Tapis jadual msdyn_copilotinteraction dengan ID interaksi yang diperlukan untuk mendapatkan Transcript.DataID atribut daripada.msdyn_interactioncontext Gunakan permintaan API Web berikut untuk menapis data mengikut ID interaksi.

    
   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0
    Atribut Nilai untuk senario kami
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
    msdyn_scenariotype Tanyakan soalan
    msdyn_interactiontypename Dijana
    msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf (kes dari mana interaksi dimulakan)
    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. Salin nilai daripada Trasncript.DataIdmsdyn_interactioncontext. Dalam contoh kami, nilai ini ialah a1584aaf-d5bd-357d-54a8-84dbdba547f9.

  4. Permintaan API Web berikut mendapatkan semula transkrip yang dikodkan dalam format base64/UTF-16LE.

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

    Dalam contoh kami, permintaan API Web adalah seperti berikut.

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

  5. Nyahkod data yang dikodkan menggunakan penyahkod base64 dengan pilihan set aksara UTF-16LE untuk mendapatkan transkrip. Anda boleh menggunakan alat penyahkod dalam talian untuk menyahkod data. Untuk contoh kami, transkrip yang dinyahkod dipaparkan seperti berikut.

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

Dapatkan maklum balas kata demi kata

Apabila wakil berinteraksi dengan Copilot, mereka boleh memberikan maklum balas tentang respons yang diberikan oleh Copilot. Maklum balas disimpan dalam msdyn_verbatim lajur dalam msdyn_copilotinteractiondata jadual dalam Dataverse.

Sebagai contoh, respons Copilot tidak tepat dan wakil memilih ikon ibu jari ke bawah untuk memberikan maklum balas. Wakil juga memberikan maklum balas kata demi kata. Aplikasi mencipta rekod dalam msdyn_copilotinteraction jadual dengan msdyn_interactiontypename set kepada ThumbsDown.

Atribut utama untuk rekod adalah seperti berikut.

Atribut Contoh data untuk contoh kami
msdyn_copilotinteractionid 817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
msdyn_scenariotype Tanyakan soalan
msdyn_interactiontype 100230302
msdyn_interactiontypename Ibu jari ke bawah
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactiondataid 807ff9e4-cbe7-ee11-904c-000d3a3bb867
partitionid 20250622-20250628-100230203

Nota

PartitionID hanya terpakai jika anda menggunakan jadual tersebut msdyn_copilotevents .

Anda boleh mendapatkan maklum balas kata demi kata yang diberikan oleh wakil seperti berikut.

  1. Dapatkan nilai ID rekod msdyn_copilotinteractiondata yang diperlukan daripada msdyn_copilotinteraction jadual.

Nota

Langkau langkah ini jika anda menggunakan jadual tersebut msdyn_copilotevents . Sudah msdyn_copilotinteractiondataid tersedia dalam msdyn_copilotevents jadual.

  1. Jalankan permintaan API Web berikut untuk mendapatkan maklum balas kata demi kata.

    Jika anda menggunakan msdyn_copilotevents jadual, gunakan yang berikut:

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

    Dalam contoh kami, permintaan Web API adalah seperti berikut:

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

  2. Lihat maklum balas kata demi kata yang tersedia dalam msdyn_verbatim lajur. Untuk contoh kami, maklum balas yang diperoleh adalah seperti berikut.

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

Muat turun data interaksi

Kecuali transkrip tanya soalan, untuk semua interaksi lain antara wakil dan Copilot, data disimpan dalam msdyn_copilotinteractiondata jadual atau msdyn_copilotevents dalam Dataverse.

Sebagai contoh, interaksi boleh menjadi wakil yang menggunakan Copilot untuk menjana e-mel atau ringkasan kes. Atribut utama untuk contoh kami adalah seperti berikut.

Atribut Nilai untuk senario kami
msdyn_copilotinteractionid 0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 42ae7f8e-736f-1cea-035b-6bf970b48e9c
msdyn_scenariotype Ringkasan kes
msdyn_interactiontype 100230305
msdyn_interactiontypename Dijana
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}
msdyn_interactiondataid f9d841e5-34e7-ee11-904c-000d3a3bb867

Anda boleh memuat turun data interaksi seperti berikut.

  1. Dapatkan nilai ID rekod msdyn_copilotinteractiondata yang diperlukan daripada msdyn_copilotinteraction jadual.

Nota

Langkau langkah ini jika anda menggunakan jadual tersebut msdyn_copilotevents . Sudah msdyn_copilotinteractiondataid tersedia dalam msdyn_copilotevents jadual.

  1. Jalankan permintaan Web API berikut untuk mendapatkan data interaksi dalam format yang dikodkan base64:

    Jika anda menggunakan jadual msdyn_copilotevents, gunakan yang berikut:

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

    Dalam contoh kami, permintaan Web API adalah seperti berikut:

    <org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')/msdyn_interactiondata/$value
  1. Nyahkod data yang dikodkan base64 untuk mendapatkan transkrip. Anda boleh menggunakan alat penyahkod base64 dalam talian untuk menyahkod data. Untuk contoh e-mel kami, data interaksi yang dinyahkod dipaparkan seperti berikut.

Nota

Tanya soalan, cadangkan respons dan draf ciri e-mel menggunakan pengekod base64 dengan set aksara UTF-16LE. Ringkasan kes dan perbualan menggunakan set aksara UTF-8. Kami mengesyorkan agar anda menggunakan set aksara yang sama yang digunakan untuk mengekod data untuk menyahkodnya.

Tangkapan skrin data interaksi yang dinyahkodkan.

Gunakan Copilot untuk menyelesaikan isu pelanggan
Lihat laporan analisis copilot

  • Last updated on