Бөлісу құралы:

Copilot жазбалары мен өзара әрекеттестік деректерін жүктеп алу

Клиенттерге қызмет көрсету өкілдері (қызмет өкілдері немесе өкілдер) ұсынылған жауабын, кері байланысты және сөйлесуді пайдалана отырып, жиынтықтарды көшіру сияқты Copilot мүмкіндіктерін пайдаланады. Copilot өзара әрекеттесулері Copilot өзара әрекеттесу (msdyn_copilotinteraction)), Copilot өзара әрекеттесу деректері (msdyn_copilotinteractiondata), Copilot транскрипциясы (msdyn_copilottranscript)және Copilot транскрипциясының деректері (msdyn_copilottranscriptdata) кестелерінде Dataverse-де сақталады. Стенограммалар мен өзара әрекеттесу деректерін .NET үшін Dataverse Web API немесе SDK арқылы жүктеуге болады.

Алғышарттар

  • Транзакция және өзара әрекеттесу деректері жүйеде Dataverse бағдарламасында сақталатындай сұрақтар мен электрондық хаттар үшін Copilot бағдарламасында қолдау көрсету тәжірибесі деректерінің құсбелгісі таңдалғанына көз жеткізіңіз.
  • Омниханнель әкімшісімен немесе Омниханнель супервайзерінің рөлімен кіргеніңізге көз жеткізіңіз.

Сөйлесу түйіндемесін алу

Қызмет өкілі сөйлесу түйіндемесін жасау үшін Copilot-ты пайдаланған кезде, жиынтық Деректер версінде кестеде сақталады msdyn_conversationinsight . Кестеде өрісте сақталған бірегей сөйлесу идентификаттары msdyn_ConversationId бар жазба жасалады. Жиынтық мәтін өрісте msdyn_copilotsummary сақталады.

Мысалы, тұтынушымен сөйлесуді орап болғаннан кейін қызмет өкілі Copilot-ты сөйлесу түйіндемесін жасау үшін пайдаланады. Сөйлесу түйіндемесі кестеде msdyn_conversationinsight келесі мәндермен бірге сақталады.

Төлсипат Үлгі мәні
Сөйлесу идентификаторы 70b76ab52-120b-49e6-9dce-53f235125a01
Сұхбат қорытындысы «Мәселе: Кофе машинасындағы сыра қайнату клапанына қатысты қиындық. Ақауларды жою қадамдары: Тұтынушы бұл мәселе туралы хабарлаған. Нәтижесі: одан әрі көмек көрсету үшін хабарланған мәселе».

Сөйлесу түйіндемесін келесідей шығарып алуға болады:

  1. Кестедегі жазбаның бастапқы идентификаторы болып табылатын сөйлесу идентификаторын msdyn_ocliveworkitem анықтау. Біздің мысалда бұл мән 70b76ab52-120b-49e6-9dce-53f235125a01 құрайды.

  2. Кесте жазбасын сүзу msdyn_conversationinsight үшін келесі Web API сұрауын пайдаланыңыз.

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

    Біздің мысалда Web API сұрауы былайша берілген.

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

    Біздің мысал үшін үлгі жауабы былайша берілген:

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

Менің копилот өзара әрекеттесулерім қайда сақталған

Copilot-пен әрбір қызмет өкілінің өзара іс-қимылы бірегей өзара әрекеттесу идентификаторы бар кестеде msdyn_copilotinteraction сақталады. Келесі кестеде өзара іс-қимылдың әрбір түрі бойынша өзара іс-қимылдың тиісті деректері сақталатын тізімдер берілген.

Мүмкіндік Кесте
Сұрақ қою msdyn_copilottranscriptdata
Пікір, істің түйіндемесі, электрондық пошта жазу, жауап ұсыну msdyn_copilotinteractiondata

Copilot өзара әрекеттесу жазбаларынан msdyn_copilotinteractionid және msdyn_interactiondataid алу

Транскрипцияны жүктеу немесе сөзбе-сөз пікірді көру сияқты әрекеттерді орындамас бұрын, мәндерді msdyn_copilotinteractionid және сәйкес msdyn_copilotinteractiondata жазба идентификациясының мәнін msdyn_copilotinteractionшығарып алуыңыз қажет. Өрістегі өзара әрекеттесу идентификаторын және өрістегі msdyn_copilotinteractionidmsdyn_interactiondataid_value өзара әрекеттесу идентификаторын алу үшін келесі Web API қоңырауын пайдалануға болады.

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

Жазбадан негізгі атрибуттар былайша берілген.

Төлсипат Анықтама
msdyn_copilotinteractionid Субъект даналары үшін бірегей идентификатор
msdyn_scenariorequestid Топтар бірнеше байланысты Copilot өзара әрекеттесулері.
Мысалы: Өкіл Копилотқа сұрақ қойып, содан кейін алынған жауабын бас бармақпен жоғары белгілеп қояды. Олар екі өзара әрекеттесу ретінде қарастырылады, бірақ бір сценарийдің бір бөлігі болып табылады.
msdyn_scenariotype Өкіл қолданатын ерекшелікке жатады.
msdyn_interactiontype Copilot-пен нақты репетициялық өзара әрекеттесуге жатады.
msdyn_interactionforid Өкіл Копилотпен өзара әрекеттесетін сілтеме жасалған жазбаның субъектілік идентификаторы.
msdyn_interactionforlogicalname Өкіл Копилотпен өзара әрекеттесетін сілтеме жасалған жазбаның субъектінің логикалық атауы.
msdyn_interactioncontext Транскрипцияларға сілтеме сияқты қосымша контекст.
msdyn_interactiondataid Өзара іс-қимыл деректері бар msdyn_copilotinteractiondata субъектіге жатады

Жауап үлгісі

Келесі жауапта өкіл Copilot-қа сұрақ қоятын сценарий көрсетіледі, содан кейін кері байланысты қамтамасыз ету үшін бас бармақтарды төмен қарай таңдайды. - msdyn_scenariorequestidmsdyn_scenariotype екі өзара әрекеттесу үшін де бірдей. msdyn_interactiontype Өзара әрекеттесу мәндері 100230305 және 100230302 үшін белгіленеді, олар «Пайда болған» және «Бас бармақтарға» төмен сәйкес келеді.


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

Чат транскрипцияларын жүктеу

Қызмет өкілі Copilot-қа сұрақ қойғанда, чат Dataverse кестесінде орнатылған UTF-16LE таңбасын пайдалана отырып, базалық 64 кодталған пішімде msdyn_copilottranscriptdata кодталған транскрипция ретінде сақталады. Copilot ұсынған сөйлесулер мен жауаптарды қарап шығу үшін транскрипцияларды жүктеп алуға болады.

Мысалы, іспен жұмыс істеу кезінде қызмет өкілі Копилоттан «Сапарды қалай брондауға болады?» деп сұрайды. Копилот білім базасы мақаласының негізінде жауап туғызады. Чат транскрипциясын жүктегіңіз келсе, келесі қадамдарды орындаңыз:

  1. Өзара әрекеттесу идентификациясын алу үшін веб-API қоңырауын пайдаланыңыз.

  2. Атрибуттан өту Transcript.DataID үшін msdyn_copilotinteraction кестесін қажетті өзара әрекеттесу идентификациясымен msdyn_interactioncontext сүзіп алыңыз. Деректерді өзара әрекеттесу идентификациясы арқылы сүзу үшін келесі Web API сұрауын пайдаланыңыз.

    
   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0
    Төлсипат Біздің сценарийіміз үшін мән
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid 93893746-е203-е9б6-18б9-887д68d18daf
    msdyn_scenariotype Сұрақ қою
    msdyn_interactiontypename Жасалды
    msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf (өзара әрекеттесу басталған жағдай)
    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.DataIdmsdyn_interactioncontext.) Біздің мысалда бұл мән a1584aaaf-d5bd-357d-54a8-84dbdba547f9.

  4. Келесі Web API сұрауы 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

    Біздің мысалда Web API сұрауы былайша берілген.

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

  5. Транскрипцияны алу үшін UTF-16LE таңбасын орнату параметрі бар base64 декодер арқылы кодталған деректерді декодтаңыз. Деректерді декодтау үшін онлайн декодер құралын пайдалануға болады. Мысалы, декодталған транскрипция былайша көрсетіледі.

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

Етістік пікірін алу

Өкіл Копилотпен өзара әрекеттескенде, олар Копилот ұсынатын жауаптар бойынша кері байланысты қамтамасыз ете алады. Пікір деректер версіндегі кестедегі msdyn_copilotinteractiondata бағанда сақталадыmsdyn_verbatim.

Мысалы, Copilot жауабы дәл емес және өкіл кері байланысты қамтамасыз ету үшін бармақ-төмен белгішесін таңдайды. Сондай-ақ, өкіл ауызша пікірлер ұсынады. Бағдарлама кестеде msdyn_copilotinteraction ThumbsDown жиыны бар msdyn_interactiontypename жазба жасайды.

Жазбаға арналған негізгі атрибуттар былайша берілген.

Төлсипат Мысал үшін деректер үлгісі
msdyn_copilotinteractionid 817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-е203-е9б6-18б9-887д68d18daf
msdyn_scenariotype Сұрақ қою
msdyn_interactiontype 100230302
msdyn_interactiontypename Бас бармақ
msdyn_interactionforid 1сd6023d-d326-ee11-9966-000d3a341cf
msdyn_interactiondataid 807ff9e4-cbe7-ee1-904c-000d3a3bb867

Өкіл ұсынған ауызша пікірді былайша алуға болады.

  1. Кестеден қажетті msdyn_copilotinteractiondata жазба идентификадоры мәнінmsdyn_copilotinteraction алыңыз.

  2. Етістік пікірін алу үшін келесі Web API сұрауын орындаңыз.

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

    Біздің мысалда Web API сұрауы былайша берілген.

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

  3. Бағандағы қол жетімді етістік пікірін msdyn_verbatim көріңіз. Мысалы, алынған пікір былайша берілген.

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

Өзара әрекеттесу деректерін жүктеу

Сұрақ-сұрақ транскрипцияларынан басқа, өкілдер мен Copilot арасындағы барлық басқа өзара әрекеттесулер үшін деректер Dataverse кестесінде сақталады msdyn_copilotinteractiondata .

Мысалы, электрондық поштаны немесе кейс түйіндемесін жасау үшін Copilot көмегімен өзара әрекеттесу өкіл бола алады. Біздің мысал үшін негізгі атрибуттар былайша берілген.

Төлсипат Біздің сценарийіміз үшін мән
msdyn_copilotinteractionid 0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 42ае7f8e-736f-1cea-035b-6bf970b48e9c
msdyn_scenariotype Істің түйіндемесі
msdyn_interactiontype 100230305
msdyn_interactiontypename Жасалды
msdyn_interactionforid 1сd6023d-d326-ee11-9966-000d3a341cf
msdyn_interactioncontext {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}
msdyn_interactiondataid f9d841e5-34e7-ee11-904c-000d3a3bb867

Өзара әрекеттесу деректерін төмендегідей жүктеуге болады.

  1. Кестеден қажетті msdyn_copilotinteractiondata жазба идентификадоры мәнінmsdyn_copilotinteraction алыңыз.

  2. Негізгі 64 кодталған пішімдегі кестеден msdyn_copilotinteractiondata өзара әрекеттесу деректерін шығарып алу үшін келесі Web API сұрауын іске қосыңыз:

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

    Біздің мысалда Web API сұрауы былайша берілген.

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

  3. Транскрипцияны алу үшін base64 кодталған деректерін декодтаңыз. Деректерді декодтау үшін онлайн base64 decoder құралын пайдалануға болады. Электрондық пошта мысалы үшін декодталған өзара әрекеттесу деректері келесі түрде көрсетіледі.

Ескертпе

Сұрақ қойыңыз, жауап ұсыныңыз және электрондық пошта мүмкіндіктерінің жобасында UTF-16LE таңбалар жиыны бар base64 кодтауышын пайдаланыңыз. Кейс пен сөйлесу жиынтығында UTF-8 таңбалар жиыны қолданылсын. Деректерді кодтау үшін пайдаланылған таңбалар жиынтығын оны декодтау үшін пайдалануды ұсынамыз.

Декодталған өзара әрекеттесу деректерінің скриншоты.

Тұтынушы мәселелерін шешу үшін Copilot пайдаланыңыз
Copilot талдау есебін көру