Lataa Copilot tallenteet ja vuorovaikutustiedot

Asiakaspalvelijat (huoltoedustajat tai edustajat) käyttävät Copilot-ominaisuuksia, kuten tiivistelmien kopioimista, ehdotettua vastausta, palautetta ja keskustelua. Copilot vuorovaikutukset tallennetaan Copilot Interaction (msdyn_copilotinteraction), Copilot Interaction Data (msdyn_copilotinteractiondata),Copilot Transcript (msdyn_copilottranscript) ja Copilot Transcript Data (msdyn_copilottranscriptdata) -taulukoihin Dataversessa. Voit ladata transkriptiot ja vuorovaikutustiedot käyttämällä Dataverse Web API:ta tai SDK:ta .NET:lle.

Elokuusta 2025 alkaen kopilottivuorovaikutukset tallennetaan msdyn_copilotevents-taulukkoon . msdyn_copilotinteraction- ja msdyn_copilotinteractiondata-taulukot sisältävät tietoja ennen elokuuta.

Edellytykset

• Varmista, että Copilot-palvelussa on valittu tukikokemuksen datanvalintaruutu kysymyksille ja sähköposteille, jotta transaktio- ja vuorovaikutustiedot tallennetaan järjestelmään Dataverseen.
• Varmista, että olet kirjautunut sisään Omnichannelin ylläpitäjän tai valvojan roolilla.

Hae keskustelun yhteenveto

Kun palvelun edustaja käyttää Copilot-ohjelmaa keskustelun yhteenvedon luomiseen, yhteenveto tallennetaan msdyn_conversationinsight Dataversen taulukkoon. Taulukkoon luodaan tietue, johon tallennetaan ainutlaatuinen keskustelutunnus msdyn_ConversationId . Yhteenvetoteksti tallennetaan kentälle msdyn_copilotsummary .

Esimerkiksi, kun asiakas on saanut keskustelun päätökseen, huoltoedustaja käyttää Copilot-ohjelmaa keskustelun yhteenvedon luomiseen. Keskustelun yhteenveto tallennetaan msdyn_conversationinsight taulukkoon seuraavilla arvoilla.

Voit hakea keskustelun yhteenvedon seuraavasti:

1. Tunnista keskustelutunnus, joka on tietueen ensisijainen tunniste taulukossa msdyn_ocliveworkitem . Esimerkissämme tämä arvo on 70b76ab52-120b-49e6-9dce-53f235125a01.

2. Käytä seuraavaa Web API -pyyntöä taulutietueen suodattamiseen msdyn_conversationinsight .

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

   Esimerkissämme Web API -pyyntö on seuraava.

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

   Esimerkkivastauksemme esimerkki on seuraava:

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

Missä kopilottivuorovaikutukset tallennetaan.

Jokainen palvelun edustajan vuorovaikutus Copilot-toiminnon kanssa tallennetaan msdyn_copilotinteraction tai-taulukkoon msdyn_copilotevents ainutlaatuisella vuorovaikutustunnisteella. Seuraava taulukko listaa, missä vastaavat vuorovaikutustiedot on tallennettu kullekin vuorovaikutustyypille.

Saat msdyn_copilotinteractionid ja msdyn_interactiondataid kopilottivuorovaikutustiedoista

Ennen kuin teet toimintoja, kuten lataat transkription tai katsot sanasta sanaan palautetta, sinun täytyy hakea arvot msdyn_copilotinteractionid ja vastaavat msdyn_copilotinteractiondata tietueen ID-arvot .msdyn_copilotinteraction Voit käyttää seuraavaa Web-API-kutsua saadaksesi interaktio-ID:n kentältä msdyn_copilotinteractionid ja interactiondataidin kentältä msdyn_interactiondataid_value .

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

Saat msdyn_copilotinteractionid copilot-tapahtumarekistereistä

Ennen kuin lataat transkription tai katsot sanasta sanaan palautetta, sinun täytyy hakea taulukosta msdyn_copilotinteractionidmsdyn_copilotevents arvot. Voit käyttää seuraavaa Web API -kutsua saadaksesi interaktio-ID:n kentältä msdyn_copilotinteractionid .

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

Avainmääritteet

Levyn keskeiset ominaisuudet ovat seuraavat.

Mallivastaus

Seuraava vastaus viittaa tilanteeseen, jossa edustaja kysyy Copilotilta kysymyksen ja valitsee sitten peukalo alas-painikkeen antaakseen palautetta. , msdyn_scenariorequestidmsdyn_scenariotype on sama molemmille vuorovaikutuksille. Vuorovaikutusten msdyn_interactiontype arvot asetetaan arvoihin 100230305 ja 100230302, jotka vastaavat Generoitua ja Peukkua alas.

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

Lataa keskustelutranskriptit

Kun palvelun edustaja esittää Copilot'lle kysymyksen, chat tallennetaan transkriptiona, joka on koodattu base64-koodatussa muodossa käyttäen UTF-16LE-merkkijoukkoa Dataversen msdyn_copilottranscriptdata taulukossa. Voit ladata transkriptit ja tarkastella Copilot'n antamia keskusteluja ja vastauksia.

Esimerkiksi työskennellessään tapauksen parissa palvelun edustaja kysyy Copilotilta: "Miten voin varata matkan?". Copilot tuottaa vastauksen tietopohjan artikkelin pohjalta. Jos haluat ladata chatin transkription, suorita seuraavat vaiheet:

1. Käytä web-API-kutsua saadaksesi vuorovaikutuksen ID:n.

2. Suodata msdyn_copilotinteraction-taulu vaaditulla vuorovaikutus-ID:llä päästäksesi Transcript.DataID from-attribuuttiin msdyn_interactioncontext . Käytä seuraavaa Web API -pyyntöä suodattaaksesi tiedot interaktio-ID:n mukaan.

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

   Määrite	Arvo skenaariolle
   msdyn_copilotinteractionid	F0970641-C1E7-EE11-904C-000D3A3BB867
   msdyn_scenariorequestid	93893746-e203-e9b6-18b9-887d68d18daf
   msdyn_scenariotype	Esitä kysymys
   msdyn_interactiontypename	Luotu
   msdyn_interactionforid	1cd6023d-d326-ee11-9966-000d3a3411cf (tapaus, josta vuorovaikutus käynnistettiin)
   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. Kopioi kohteen Trasncript.DataId arvo kohteesta msdyn_interactioncontext. Esimerkissämme tämä arvo on a1584aaf-d5bd-357d-54a8-84dbdba547f9.

4. Seuraava Web API -pyyntö hakee koodatun transkription base64/UTF-16LE-muodossa.

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

   Esimerkissämme Web API -pyyntö on seuraava.

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

5. Dekoodattu data purkaa base64-dekooderilla UTF-16LE-merkistövaihtoehdolla saadakseen transkription. Voit käyttää verkkopohjaista dekooderityökalua datan purkamiseen. Esimerkissämme purettu transkriptio esitetään seuraavasti.
   

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

Hae sanasta sanaan palautetta

Kun edustaja on vuorovaikutuksessa Copilot'n kanssa, hän voi antaa palautetta Copilot'n antamista vastauksista. Palaute tallennetaan Dataversen taulukon msdyn_verbatim sarakkeeseen msdyn_copilotinteractiondata .

Esimerkiksi Copilot'n vastaus ei ole tarkka ja edustaja valitsee peukkukuvakkeen antaakseen palautteen. Edustaja antaa myös sanasta sanaan palautetta. Sovellus luo taulukkoon msdyn_copilotinteraction tietueen, jossa on msdyn_interactiontypename asetettu ThumbsDown.

Levyn keskeiset ominaisuudet ovat seuraavat.

Voit saada edustajan antaman palautteen sanasta sanaan seuraavasti.

1. Hanki msdyn_copilotinteraction taulukosta.

2. Suorita seuraava Web API -pyyntö saadaksesi sanasta sanaan palautteen.

   • msdyn_copilotevents
   • msdyn_copilotinteractiondata

   Jos käytät taulukkoa msdyn_copilotevents , käytä seuraavia:

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

   Esimerkissämme Web API -pyyntö on seuraava:

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

3. Katso sanasta sanaan saatava palaute palstalta msdyn_verbatim . Esimerkissämme palaute on seuraava.
   

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

Lataa vuorovaikutustiedot

Lukuun ottamatta kysymyksen esittämistä koskevia transkripteja, kaikissa muissa edustajien ja Copilot välisissä vuorovaikutuksissa data tallennetaan msdyn_copilotinteractiondata Dataversen tai-taulukkoonmsdyn_copilotevents.

Esimerkiksi vuorovaikutus voi olla edustaja, joka käyttää Copilot-ohjelmaa sähköpostin tai tapausyhteenvedon luomiseen. Esimerkkimme keskeiset ominaisuudet ovat seuraavat.

Voit ladata vuorovaikutustiedot seuraavasti.

1. Hanki msdyn_copilotinteraction taulukosta.

2. Suorita seuraava Web API -pyyntö saadaksesi vuorovaikutustiedot base64-koodatussa muodossa:

   • msdyn_copilotevents
   • msdyn_copilotinteractiondata

   Jos käytät msdyn_copilotevents-taulukkoa, käytä seuraavia:

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

   Esimerkissämme Web API -pyyntö on seuraava:

   <org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')/msdyn_interactiondata/$value 
   

3. Dekoodaa base64-koodattu data saadaksesi transkription. Voit käyttää online-base64-dekooderityökalua datan purkamiseen. Sähköpostiesimerkissämme purettu vuorovaikutusdata esitetään seuraavasti.

Liittyvät tiedot

Asiakkaiden ongelmien ratkaiseminen Copilotin avulla
Katso copilot-analytiikkaraportti