Copilot metinlerini ve etkileşim verilerini indirme

Müşteri hizmetleri temsilcileri (hizmet temsilcileri veya temsilcileri), özetleri kopyalama, önerilen bir yanıtı kullanma, geri bildirim ve sohbet gibi Copilot özelliklerini kullanır. Yardımcı pilot etkileşimleri, Dataverse'teki Yardımcı Pilot Etkileşimi (msdyn_copilotinteraction), Yardımcı Pilot Etkileşim Verileri (msdyn_copilotinteractiondata),Yardımcı Pilot Transkripti (msdyn_copilottranscript) ve Yardımcı Pilot Transkript Verileri (msdyn_copilottranscriptdata) tablolarında depolanır. Dataverse Web API'sini veya .NET için SDK'yı kullanarak transkriptleri ve etkileşim verilerini indirebilirsiniz.

Ağustos 2025'ten itibaren, yardımcı pilot etkileşimleri msdyn_copilotevents tablosunda saklanmaktadır. msdyn_copilotinteraction ve msdyn_copilotinteractiondata tabloları Ağustos öncesi kayıtları içermektedir.

Önkoşullar

  • Sorular ve e-postalar için Copilot bölümünde Destek deneyimi verileri onay kutusunun seçili olduğundan emin olun, böylece işlem ve etkileşim verileri sistem tarafından Dataverse'de saklanır.
  • Çok Yönlü Kanal yöneticisi veya Çok Yönlü Kanal gözetmeni rolüyle oturum açtığınızdan emin olun.

Konuşma özetini al

Bir hizmet temsilcisi bir konuşma özeti oluşturmak için Copilot'ı kullandığında, özet Dataverse'teki msdyn_conversationinsight tabloda depolanır. msdyn_ConversationId alanında saklanan benzersiz bir konuşma kimliği ile tabloda bir kayıt oluşturulur. Özet metni bu alanda msdyn_copilotsummary saklanır.

Örneğin, bir müşteriyle yapılan bir konuşmayı tamamladıktan sonra, bir servis temsilcisi bir konuşma özeti oluşturmak için Copilot'u kullanır. Konuşma özeti msdyn_conversationinsight , tabloda aşağıdaki değerlerle depolanır.

Özellik Örnek Değer
Konuşma kimliği 70b76ab52-120b-49e6-9dce-53f235125a01
Konuşma özeti "Sorun: Kahve makinesindeki demleme valfiyle ilgili sorun. Sorun giderme adımları: Müşteri sorunu bildirdi. Sonuç: Daha fazla yardım için sorun bildirildi."

Konuşma özetini aşağıdaki gibi alabilirsiniz:

  1. Tablodaki msdyn_ocliveworkitem kaydın birincil tanımlayıcısı olan konuşma kimliğini tanımlayın. Örneğimizde bu değer 70b76ab52-120b-49e6-9dce-53f235125a01'dir.

  2. Tablo kaydını filtrelemek için aşağıdaki Web API isteğini msdyn_conversationinsight kullanın.

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

    Örneğimizde, Web API isteği aşağıdaki gibidir.

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

    Örneğimiz için örnek yanıt aşağıdaki gibidir:

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

Yardımcı pilot etkileşimlerim nerede saklanıyor?

Her hizmet temsilcisi ile Copilot etkileşimi, benzersiz bir etkileşim kimliğiyle msdyn_copilotinteraction or msdyn_copilotevents tablosunda saklanır. Aşağıdaki tabloda, her bir etkileşim türü için karşılık gelen etkileşim verilerinin nerede depolandığı listelenmektedir.

Özellik Tablo
Bir soru sorun msdyn_copilottranscriptdata
Geri bildirim, vaka özeti, e-posta yazma, yanıt önerme msdyn_copilotinteractiondata, msdyn_copilotevents

Uyarı

Copilot etkileşim kayıtları, Ağustos 2025'ten itibaren tabloda msdyn_copilotevents saklanmaktadır. Ağustos ayından önceki kayıtlar msdyn_copilotinteraction ve msdyn_copilotinteractiondata tablolarında saklanır.

Copilot etkileşim kayıtlarından msdyn_copilotinteractionid ve msdyn_interactiondataid'yi alın

Bir transkripti indirme veya tam geri bildirimi görüntüleme gibi işlemleri yapmadan önce, msdyn_copilotinteractionid değerlerini ve msdyn_copilotinteraction öğesinden karşılık gelen msdyn_copilotinteractiondata kayıt kimliği değerini almalısınız. msdyn_copilotinteractionid alanına etkileşim kimliğini ve msdyn_interactiondataid_value alanına etkileşim veri kimliğini almak için aşağıdaki Web API çağrısını kullanabilirsiniz.

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

Copilot etkinlik kayıtlarından msdyn_copilotinteractionid alın

Bir transkripti indirmeden veya bire bir geri bildirimi görüntülemeden önce, msdyn_copilotevents tablosundan msdyn_copilotinteractionid değerlerini almanız gerekir. Aşağıdaki Web API çağrısını kullanarak alandaki etkileşim kimliğini msdyn_copilotinteractionid elde edebilirsiniz.

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

Temel öznitelikler

Kayıttaki temel özellikler aşağıdaki gibidir.

Özellik Tanım
msdyn_copilotinteractionid Varlık kurulumlarının benzersiz tanıtıcısı
msdyn_scenariorequestid Birden çok ilgili Yardımcı Pilot etkileşimini gruplandırır.
Örneğin: Bir temsilci Copilot'a bir soru sorar ve ardından alınan yanıtı beğenme ile işaretler. Bunlar iki etkileşim olarak kabul edilir, ancak aynı senaryonun bir parçasıdır.
msdyn_scenariotype Temsilci tarafından kullanılan özelliği ifade eder.
msdyn_interactiontype Copilot ile belirli temsili etkileşimi ifade eder.
msdyn_interactionforid Temsilcinin Copilot ile etkileşime girdiği başvurulan kaydın varlık kimliği.
msdyn_interactionforlogicalname Temsilcinin Copilot ile etkileşime girdiği başvurulan kaydın varlık mantıksal adı.
msdyn_interactioncontext Transkriptlere referans gibi ek bağlamlar.
msdyn_interactiondataid Etkileşim verilerini içeren msdyn_copilotinteractiondata varlığına atıfta bulunur

Örnek yanıt

Aşağıdaki yanıt, bir temsilcinin Yardımcı Pilota bir soru sorduğu ve ardından geri bildirim sağlamak için başparmak aşağı düğmesini seçtiği bir senaryoyu gösterir. , msdyn_scenariorequestidmsdyn_scenariotype her iki etkileşim için de aynıdır. Etkileşimler için msdyn_interactiontype değerleri, Oluşturuldu ve Başparmak Aşağı'ya karşılık gelen 100230305 ve 100230302 olarak ayarlanmıştır.


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

Sohbet transkriptlerini indirin

Bir hizmet temsilcisi Copilot'a bir soru sorduğunda sohbet, Dataverse'teki tabloda ayarlanan UTF-16LE karakter kümesi msdyn_copilottranscriptdata kullanılarak base64 ile kodlanmış bir transkript olarak kaydedilir. Copilot tarafından sağlanan konuşmayı ve yanıtları gözden geçirmek için transkriptleri indirebilirsiniz.

Örneğin, bir vaka üzerinde çalışırken, servis temsilcisi Copilot'a "Nasıl seyahat rezervasyonu yapabilirim?" diye sorar. Copilot, bir bilgi bankası makalesine dayalı olarak bir yanıt oluşturur. Sohbet dökümünü indirmek istiyorsanız aşağıdaki adımları gerçekleştirin:

  1. Etkileşim kimliğini almak için web API'si çağrısını kullanın.

  2. İstenilen etkileşim kimliğiyle msdyn_copilotinteraction tablosunu filtreleyin ve Transcript.DataID özniteliğinden msdyn_interactioncontext'ye ulaşın. Verileri etkileşim kimliğine göre filtrelemek için aşağıdaki Web API isteğini kullanın.

    
   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0
    Özellik Senaryomuz için değer
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid 93893746-E203-E9B6-18B9-887D68D18DAF
    msdyn_scenariotype Bir soru sorun
    msdyn_interactiontypename Oluşturuldu
    msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf (etkileşimin başlatıldığı durum)
    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. Trasncript.DataId değerini msdyn_interactioncontext öğesinden kopyalayın. Örneğimizde bu değer a1584aaf-d5bd-357d-54a8-84dbdba547f9'dur.

  4. Aşağıdaki Web API isteği, kodlanmış transkripti base64/UTF-16LE biçiminde alır.

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

    Örneğimizde, Web API isteği aşağıdaki gibidir.

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

  5. Transkripti almak için UTF-16LE karakter seti seçeneğine sahip bir base64 kod çözücü kullanarak kodlanmış verilerin kodunu çözün. Verilerin kodunu çözmek için çevrimiçi bir kod çözücü aracı kullanabilirsiniz. Örneğimiz için, kodu çözülmüş transkript aşağıdaki gibi görüntülenir.

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

Anlık geri bildirim al

Bir temsilci Copilot ile etkileşime girdiğinde, Copilot'un sağladığı yanıtlar hakkında geri bildirim sağlayabilir. Geri bildirim, Dataverse'teki msdyn_verbatim tabloda yer alan msdyn_copilotinteractiondata sütunda depolanır.

Örneğin, Yardımcı Pilotun yanıtı doğru değildir ve temsilci geri bildirim sağlamak için başparmak aşağı simgesini seçer. Temsilci ayrıca kelimesi kelimesine geri bildirim sağlar. Uygulama, msdyn_copilotinteraction tablosunda msdyn_interactiontypename değeri ThumbsDown olarak ayarlanmış bir kayıt oluşturur.

Kaydın temel öznitelikleri aşağıdaki gibidir.

Özellik Örneğimiz için örnek veriler
msdyn_copilotinteractionid 817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-E203-E9B6-18B9-887D68D18DAF
msdyn_scenariotype Bir soru sorun
msdyn_interactiontype 100230302
msdyn_interactiontypename ThumbsDown
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactiondataid 807ff9e4-cbe7-ee11-904c-000d3a3bb867
partitionid 20250622-20250628-100230203

Uyarı

PartitionID yalnızca msdyn_copilotevents tablosunu kullanıyorsanız geçerlidir.

Temsilci tarafından sağlanan kelimesi kelimesine geri bildirimi aşağıdaki şekilde alabilirsiniz.

  1. Gerekli msdyn_copilotinteractiondata kayıt kimliği değerinimsdyn_copilotinteraction tablosundan alın.

Uyarı

Tabloyu msdyn_copilotevents kullanıyorsanız bu adımı atlayın. msdyn_copilotinteractiondataid, msdyn_copilotevents tablosunda zaten mevcut.

  1. Kelimesi kelimesine geri bildirim almak için aşağıdaki Web API isteğini çalıştırın.

    msdyn_copilotevents tabloyu kullanıyorsanız, aşağıdakileri kullanın:

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

    Örneğimizde, Web API isteği şu şekildedir:

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

  2. msdyn_verbatim sütununda bulunan birebir geri bildirimi görün. Örneğimiz için alınan geri bildirim aşağıdaki gibidir.

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

Etkileşim verilerini indirme

Soru sorma transkriptleri hariç, temsilciler ile Copilot arasındaki diğer tüm etkileşimler için veriler Dataverse'teki or msdyn_copilotinteractiondata tablosunda saklanırmsdyn_copilotevents.

Örneğin, bir etkileşim, bir e-posta veya servis talebi özeti oluşturmak için Copilot'u kullanan bir temsilci olabilir. Örneğimiz için temel özellikler aşağıdaki gibidir.

Özellik Senaryomuz için değer
msdyn_copilotinteractionid 0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 42ae7f8e-736f-1cea-035b-6bf970b48e9c
msdyn_scenariotype Vaka özeti
msdyn_interactiontype 100230305
msdyn_interactiontypename Oluşturuldu
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}
msdyn_interactiondataid f9d841e5-34e7-ee11-904c-000d3a3bb867

Etkileşim verilerini aşağıdaki gibi indirebilirsiniz.

  1. Gerekli msdyn_copilotinteractiondata kayıt kimliği değerinimsdyn_copilotinteraction tablosundan alın.

Uyarı

Tabloyu msdyn_copilotevents kullanıyorsanız bu adımı atlayın. msdyn_copilotinteractiondataid, msdyn_copilotevents tablosunda zaten mevcut.

  1. Etkileşim verilerini base64 kodlu formatta almak için aşağıdaki Web API isteği çalıştırın:

    msdyn_copilotevents tablosunu kullanıyorsanız, aşağıdakileri kullanın:

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

    Örneğimizde, Web API isteği şu şekildedir:

    <org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')/msdyn_interactiondata/$value
  1. Transkripti almak için base64 kodlu verilerin kodunu çözün. Verilerin kodunu çözmek için çevrimiçi bir base64 kod çözücü aracı kullanabilirsiniz. E-posta örneğimiz için, kodu çözülen etkileşim verileri aşağıdaki gibi görüntülenir.

Uyarı

Bir soru sorun, bir yanıt önerin ve bir e-posta taslağı hazırlayın Özellikler UTF-16LE karakter kümesiyle base64 kodlayıcıyı kullanır. Vaka ve konuşma özeti UTF-8 karakter kümesini kullanır. Kodunu çözmek için verileri kodlamak için kullanılan karakter kümesinin aynısını kullanmanızı öneririz.

Kodu çözülen etkileşim verilerinin ekran görüntüsü.

Müşteri sorunlarını çözmek için Copilot kullanma
Yardımcı pilot analiz raporunu görüntüleyin

  • Son güncelleştirme: