Deskargatu Copilot-en transkripzioak eta interakzio-datuak

Bezeroaren arretarako zerbitzuko ordezkariek (zerbitzu-ordezkariak edo ordezkariak) Copilot-en funtzioak erabiltzen dituzte, hala nola laburpenen kopia, iradokitako erantzun baten erabilera, iruzkinak eta txata. Copilot-en interakzioak Copilot Interaction (msdyn_copilotinteraction), Copilot Interaction Data (msdyn_copilotinteractiondata), Copilot Transcript (msdyn_copilottranscript) eta Copilot Transcript Data (msdyn_copilottranscriptdata) tauletan gordetzen dira Dataversen. Transkripzioak eta interakzio datuak jaitsi ditzakezu Dataverseren WEB APIaren edo SDKren bidez.NET-erako.

2025eko abuztutik aurrera, kopilotu elkarreraginak msdyn_copilotevents taulan gordetzen dira. msdyn_copilotinteraction eta msdyn_copilotinteractiondata taulek abuztuaren aurreko erregistroak dituzte.

Aurrebaldintzak

Elkarrizketaren laburpena berreskuratu

Zerbitzu-ordezkari batek Elkarrizketa-laburpen bat sortzeko Copilot erabiltzen duenean, laburpena Dataverseko msdyn_conversationinsight taulan gordetzen da. Taulan erregistro bat sortzen da, landan msdyn_ConversationId gordetako elkarrizketa bakarreko IDarekin. Laburpenaren testua eremuan gordetzen da msdyn_copilotsummary .

Adibidez, bezero batekin elkarrizketa bat amaitu ondoren, zerbitzuko ordezkari batek Copilot erabiltzen du elkarrizketaren laburpen bat sortzeko. Elkarrizketaren laburpena taulan msdyn_conversationinsight gordetzen da, honako balio hauekin.

Atributua Erakusketaren balioa
Elkarrizketaren IDa 70b76ab52-120b-49e6-9dce-53f235125a01
Elkarrizketaren laburpena "Problema: Kafe-makina prestatzeko balbularekin arazoa. Arazoak konpontzeko urratsak: bezeroak arazoaren berri eman du. Emaitza: Laguntza gehiago lortzeko arazo baten berri eman zen".

Elkarrizketaren laburpena honela berreskura dezakezu:

  1. Identifikatu elkarrizketarako IDa, hau da, taulako erregistroaren msdyn_ocliveworkitem identifikatzaile nagusia. Gure adibidean, balio hau 70b76ab52-120b-49e6-9dce-53f235125a01 da.

  2. Erabil ezazu API web-en hurrengo eskaera taularen msdyn_conversationinsight erregistroa iragazteko.

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

    Gure adibidean, API web-aren eskaera honako hau da.

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

    Gure adibiderako adibidearen erantzuna honako hau da:

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

Non gordetzen dira nire kopilotuaren interakzioak?

Copilot-ekin zerbitzu ordezkari bakoitzaren elkarreragina or taulan msdyn_copilotinteractionmsdyn_copilotevents gordetzen da, interakzio ID bakar batekin. Hurrengo taulan interakzio mota bakoitzerako dagozkion interakzio-datuak zerrendatzen dira.

Eginbidea Taula
Egin galdera bat msdyn_copilottranscriptdata
Iruzkinak, kasuaren laburpena, posta elektroniko bat idaztea, erantzun bat iradokitzea msdyn_copilotinteractiondata, msdyn_copilotevents

Oharra

Copilot elkarreragin erregistroak taulan gordetzen msdyn_copilotevents dira, 2025eko abuztutik aurrera. Abuztuaren aurreko erregistroak eta msdyn_copilotinteractiondata tauletan gordetzen msdyn_copilotinteraction dira.

Kopilotuaren interakzio-erregistroen msdyn_copilotinteractionid eta msdyn_interactiondataid lortzea

Transkripzio bat deskargatu edo hitzez hitzeko iruzkinak ikusi aurretik, dagokion msdyn_copilotinteractiondata erregistroko IDaren msdyn_copilotinteractionid balioak eta balioa berreskuratu behar ditu msdyn_copilotinteraction. Web API-era dei dezakezu, eremuan msdyn_copilotinteractionid elkarrekintzarako IDa eta interaktiondataid-a msdyn_interactiondataid_value lortzeko.

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

Lortu msdyn_copilotinteractionid kopilotu ekitaldiaren erregistroetatik

Transkripzio bat deskargatu edo iritzia hitzez hitz ikusi aurretik, taulatik balioak msdyn_copilotinteractionidmsdyn_copilotevents berreskuratu behar dituzu. Hurrengo Web API deia erabil dezakezu eremuko msdyn_copilotinteractionid interakzio IDa lortzeko.

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

Ezaugarri nagusiak

Erregistroaren funtsezko atributuak honako hauek dira:

Atributua Definizioa
msdyn_copilotinteractionid Identifikatzaile bakarra entitate-erakundeetarako
msdyn_scenariorequestid Erlazionatuta dituen Copilot-en hainbat interakzio biltzen ditu.
Adibidez: Ordezkari batek Copilot-i galdera bat egiten dio eta gero jasotako erantzuna markatzen du erpurua gorantz duela. Bi interakziotzat hartzen dira, baina eszenatoki beraren parte dira.
msdyn_scenariotype Ordezkariak erabilitako ezaugarriari buruzkoa da.
msdyn_interactiontype Copilotekiko interakzio adierazgarri espezifikoari buruzkoa da.
msdyn_interactionforid Aipatzen den erregistroko erakunde-IDa, zeinarentzat ordezkariak Copilotekin elkarreragiten zuen.
msdyn_interactionforlogicalname Aipatzen den erregistro-erakundearen izen logikoa, zeinarentzat ordezkariak Copilotekin hitz egin baitzuen.
msdyn_interactioncontext Testuinguru gehigarria, transkripzioei erreferentzia egiteko.
msdyn_interactiondataid Interakzio-datuak dituen erakunde msdyn_copilotinteractiondata erreferentzia egiten dio

Adibidearen erantzuna

Hurrengo erantzunak, ordezkari batek kopilotuari galdera bat egiten dion eszenatoki bat adierazten du eta, ondoren, erpuruaren botoia beherantz aukeratzen du iruzkinak egiteko. Bera msdyn_scenariorequestid, msdyn_scenariotype bi interakzioentzat berdina da. Interakzioen balioak msdyn_interactiontype 100230305 eta 100230302 ezartzen dira, eta Sorgailuari eta Pulgatzeari beherantz dagozkio.


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

Deskargatu txat transkripzioak

Zerbitzu-ordezkari batek Copilot-i galdera bat egiten dionean, txat-a oinarri-kodifikatutako formatuan kodetutako transkripzio gisa gordetzen da, Dataverseko msdyn_copilottranscriptdata taulan UTF-16LE karaktere-multzoa erabiliz. Copilot-ek emandako elkarrizketa eta erantzunak berrikusteko transkripzioak deskarga ditzakezu.

Adibidez, kasu batean lan egiten duen bitartean, zerbitzuko ordezkariak Kopilotuari galdetzen dio: "Nola gorde dezaket bidaia bat?". Copilot-ek ezagutza-oinarriko artikulu batean oinarritutako erantzuna sortzen du. Txataren transkripzioa deskargatu nahi baduzu, egin pauso hauek:

  1. Erabil ezazu web API-era dei bat interakziorako IDa lortzeko.

  2. Filtre taula msdyn_copilotinteraction from atributua lortzeko Transcript.DataID behar den interakzio-IDarekin msdyn_interactioncontext . Erabil ezazu API web-en hurrengo eskaera datuak interakzioko IDaren bidez iragazteko.

    
   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0
    Atributua Gure eszenatokirako balioa
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
    msdyn_scenariotype Egin galdera bat
    msdyn_interactiontypename Sorrera-data
    msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF (elkarrekintza hasi zenetik)
    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. Kopiatu jabetzaren Trasncript.DataId balioa.msdyn_interactioncontext Gure adibidean, balio hau a1584af-d5bd-357d-54a8-84dbdba547f9 da.

  4. Web API web-aren hurrengo eskaerak oinarrian kodetuta dagoen transkripzioa berreskuratuko du, oinarrian64/ UTF-16LE formatuan.

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

    Gure adibidean, API web-aren eskaera honako hau da.

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

  5. Deskodetu kodifikatutako datuak, oinarri64 deskodegailu bat erabiliz, transkripzioa lortzeko UTF-16LE karaktere multzoaren aukerarekin. Deskodetze-tresna bat erabil dezakezu datuak deskodetzeko. Gure adibidean, deskodetu den transkripzioa honela agertzen da.

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

Hitzez hitzeko iruzkinak berreskuratu

Ordezkari batek Copilotekin elkar eragiten duenean, Copilotek ematen dituen erantzunei buruzko iruzkinak egin ditzake. Iruzkinak Dataverseko taularen msdyn_verbatimmsdyn_copilotinteractiondata zutabean gordetzen dira.

Adibidez, kopilotuaren erantzuna ez da zehatza eta ordezkariak erpuruaren ikonoa aukeratzen du beherantz iruzkinak egiteko. Ordezkariak hitzez hitzeko iruzkinak ere ematen ditu. Aplikazioak erregistro bat sortzen du msdyn_copilotinteractionmsdyn_interactiontypename taulan, ThumbsDownen ezarritako balioarekin.

Erregistroaren funtsezko atributuak honako hauek dira:

Atributua Gure adibiderako lagin-datuak
msdyn_copilotinteractionid 817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
msdyn_scenariotype Egin galdera bat
msdyn_interactiontype 100230302
msdyn_interactiontypename Beherantz behatz lodiak
msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF
msdyn_interactiondataid 807ff9e4-cbe7-ee11-904c-000d3a3bb867
partizioaren IDa 20250622-20250628-100230203

Oharra

PartitionID soilik aplikagarria da taula erabiltzen msdyn_copilotevents baduzu.

Ordezkariak emandako hitzez hitzeko iruzkinak honako modu honetan lor ditzakezu:

  1. Taulan eskatutako msdyn_copilotinteractiondata erregistroko IDaren balioa lortzen badu msdyn_copilotinteraction .

Oharra

Saihestu urrats hau taula erabiltzen msdyn_copilotevents baduzu. Dagoeneko msdyn_copilotinteractiondataid taulan eskuragarri msdyn_copilotevents .

  1. Egin ezazu API web-aren hurrengo eskaera, hitzez hitzeko iruzkinak berreskuratzeko.

    Taula erabiltzen msdyn_copilotevents baduzu, honako hauek erabili:

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

    Gure adibidean, Web API eskaera honela doa:

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

  2. Ikus zutabean dauden hitzez hitzeko msdyn_verbatim iruzkinak. Gure adibiderako, berreskuratutako iruzkinak honako hauek dira.

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

Deskargatu interakzio-datuak

Galdera bidezko transkripzioak izan ezik, ordezkarien eta Copilot-en arteko beste elkarreragin guztietan, datuak edo msdyn_copilotevents taulan msdyn_copilotinteractiondata gordetzen dira Dataverse-n.

Adibidez, interakzio bat Copilot-ek posta elektroniko bat edo kasu baten laburpen bat sortzeko erabiltzen duen ordezkari bat izan daiteke. Gure adibiderako funtsezko atributuak honako hauek dira.

Atributua Gure eszenatokirako balioa
msdyn_copilotinteractionid 0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 42AE7F8E-736F-1CEA-035B-6BF970B48E9C
msdyn_scenariotype Kasuaren laburpena
msdyn_interactiontype 100230305
msdyn_interactiontypename Sorrera-data
msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF
msdyn_interactioncontext {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}
msdyn_interactiondataid f9d841e5-34e7-ee11-904c-000d3a3bb867

Interakzio-datuak honela jaitsi ditzakezu.

  1. Taulan eskatutako msdyn_copilotinteractiondata erregistroko IDaren balioa lortzen badu msdyn_copilotinteraction .

Oharra

Saihestu urrats hau taula erabiltzen msdyn_copilotevents baduzu. Dagoeneko msdyn_copilotinteractiondataid taulan eskuragarri msdyn_copilotevents .

  1. Exekutatu hurrengo Web API eskaera elkarreragin datuak base64 kodetutako formatuan berreskuratzeko:

    msdyn_copilotevents taula erabiltzen baduzu, honako hau erabili:

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

    Gure adibidean, Web API eskaera honela doa:

    <org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')/msdyn_interactiondata/$value
  1. Deskodetu oinarrian kodetutako datuak transkripzioa lortzeko. Oinarrizko tresna deskodetzaile bat erabil dezakezu, datuak deskodetzeko. Gure posta elektronikoko adibiderako, deskodetu diren interakzio-datuak honela erakusten dira:

Oharra

Egin galdera bat, erantzun bat iradoki eta idatzi posta elektroniko bat UTF-16LE karaktere jokoarekin oinarri-kodifikatzailea erabiltzen duten ezaugarriek. Kasuen eta elkarrizketen laburpenak UTF-8 karaktere-jokoa erabiltzen du. Datuak kodetzeko erabili zen karaktere-joko bera erabiltzea gomendatzen da.

Interakzio deskodetuari buruzko datuen pantaila atzitzea.

Erabili Copilot bezeroen arazoak konpontzeko
Copilot-en analisi-txostena ikusi

  • Last updated on