Baixar les transcripcions i les dades d'interacció del Copilot

Els representants del servei d'atenció al client (representants o representants del servei) utilitzen les funcions del Copilot, com ara copiar resums, utilitzar una resposta suggerida, comentaris i xat. Les interaccions del copilot s'emmagatzemen a les taules Copilot Interaction (msdyn_copilotinteraction),Copilot Interaction Data (msdyn_copilotinteractiondata),Copilot Transcript (msdyn_copilottranscript) i Copilot Transcript Data (msdyn_copilottranscriptdata) del Dataverse. Podeu baixar les transcripcions i les dades d'interacció mitjançant l'API web del Dataverse o l'SDK per a .NET.

A partir d'agost de 2025, les interaccions amb copilot s'emmagatzemen a la taula msdyn_copilotevents . Les taules msdyn_copilotinteraction i msdyn_copilotinteractiondata contenen registres anteriors a l'agost.

Requisits previs

  • Assegureu-vos que la casella de selecció Dades de l'experiència de suport estigui activada al Copilot per a preguntes i correus electrònics, de manera que el sistema emmagatzemi les dades de transacció i interacció al Dataverse.
  • Assegureu-vos que heu iniciat la sessió amb la funció d'administrador o supervisor de l'Omnicanal.

Recuperar el resum de la conversa

Quan un representant del servei utilitza el Copilot per generar un resum de conversa, el resum s'emmagatzema a la msdyn_conversationinsight taula del Dataverse. Es crea un registre a la taula amb un identificador de conversa únic emmagatzemat al msdyn_ConversationId camp. El text del resum s'emmagatzema al msdyn_copilotsummary camp.

Per exemple, després d'acabar una conversa amb un client, un representant de servei utilitza Copilot per generar un resum de conversa. El resum de la conversa s'emmagatzema a la msdyn_conversationinsight taula amb els valors següents.

Atribut Valor d'exemple
Identificador de la conversa 70b76ab52-120b-49e6-9dce-53f235125a01
Resum de la conversa "Problema: Problemes amb la vàlvula de preparació de la màquina de cafè. Passos de resolució de problemes: el client ha informat del problema. Resultat: Problema informat per a més assistència".

Podeu recuperar el resum de la conversa de la següent manera:

  1. Identifiqueu l'identificador de conversa, que és l'identificador principal del registre de la msdyn_ocliveworkitem taula. En el nostre exemple, aquest valor és 70b76ab52-120b-49e6-9dce-53f235125a01.

  2. Utilitzeu la sol·licitud d'API web següent per filtrar el registre de taula msdyn_conversationinsight .

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

    En el nostre exemple, la sol·licitud de l'API web és la següent.

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

    La resposta d'exemple per al nostre exemple és la següent:

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

On s'emmagatzemen les meves interaccions de copilot

La interacció de cada representant de servei amb Copilot s'emmagatzema a la taula d'operacions msdyn_copilotinteractionmsdyn_copilotevents amb un ID d'interacció únic. La taula següent mostra on s'emmagatzemen les dades d'interacció corresponents per a cada tipus d'interacció.

Característica Taula
Fes una pregunta msdyn_copilottranscriptdata
Comentaris, resum del cas, escriure un correu electrònic, suggerir una resposta msdyn_copilotinteractiondata, msdyn_copilotevents

Nota

Els registres d'interacció de Copilot s'emmagatzemen a la msdyn_copilotevents taula, a partir d'agost de 2025. Els registres anteriors a l'agost s'emmagatzemen a les msdyn_copilotinteraction taules de i msdyn_copilotinteractiondata .

Obteniu msdyn_copilotinteractionid i msdyn_interactiondataid dels registres d'interacció del copilot

Abans de fer accions com ara baixar una transcripció o visualitzar comentaris literals, heu de recuperar els valors de i el valor corresponent de l'identificador de msdyn_copilotinteractionid registre msdyn_copilotinteractiondata del msdyn_copilotinteraction. Podeu utilitzar la següent crida a l'API web per obtenir l'identificador d'interacció al msdyn_copilotinteractionid camp i l'interactiondataid al msdyn_interactiondataid_value camp.

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

Obteniu msdyn_copilotinteractionid dels registres de l'esdeveniment de copilot

Abans de descarregar una transcripció o veure comentaris literals, has de recuperar els valors de msdyn_copilotinteractionid de la msdyn_copilotevents taula. Pots utilitzar la següent crida a l'API web per obtenir l'ID d'interacció al msdyn_copilotinteractionid camp.

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

Atributs clau

Els atributs clau del registre són els següents.

Atribut Definició
msdyn_copilotinteractionid Identificador únic per a instàncies d'entitat
msdyn_scenariorequestid Agrupa múltiples interaccions relacionades amb el copilot.
Per exemple: un representant fa una pregunta a Copilot i després marca la resposta rebuda amb el polze cap amunt. Es consideren dues interaccions, però formen part del mateix escenari.
msdyn_scenariotype Es refereix a la característica utilitzada pel representant.
msdyn_interactiontype Es refereix a la interacció representativa específica amb Copilot.
msdyn_interactionforid L'identificador d'entitat del registre referenciat, per al qual el representant va interactuar amb Copilot.
msdyn_interactionforlogicalname El nom lògic de l'entitat del registre referenciat, per al qual el representant va interactuar amb Copilot.
msdyn_interactioncontext Context addicional com ara referència a transcripcions.
msdyn_interactiondataid Fa referència a msdyn_copilotinteractiondata entitat que conté dades d'interacció

Exemple de resposta

La resposta següent indica un escenari en què un representant fa una pregunta al copilot i, a continuació, selecciona el botó de polze cap avall per proporcionar comentaris. El msdyn_scenariorequestid, msdyn_scenariotype és el mateix per a les dues interaccions. Els msdyn_interactiontype valors de les interaccions s'estableixen en 100230305 i 100230302, que corresponen a Generat i Polze avall.


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

Descarregar transcripcions de xat

Quan un representant del servei fa una pregunta al Copilot, el xat es desa com a transcripció codificada en el format codificat en base64 mitjançant el conjunt de caràcters UTF-16LE a la msdyn_copilottranscriptdata taula del Dataverse. Podeu descarregar les transcripcions per revisar la conversa i les respostes proporcionades per Copilot.

Per exemple, mentre treballa en un cas, el representant del servei pregunta a Copilot "Com puc reservar un viatge?". Copilot genera una resposta basada en un article de la base de coneixement. Si voleu descarregar la transcripció del xat, seguiu els passos següents:

  1. Utilitzeu la trucada a l'API web per obtenir l'identificador d'interacció.

  2. Filtreu la taula msdyn_copilotinteraction amb l'identificador d'interacció necessari per arribar a l'atribut Transcript.DataID from msdyn_interactioncontext . Utilitzeu la sol·licitud d'API web següent per filtrar les dades per identificador d'interacció.

    
   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0
    Atribut Valor per al nostre escenari
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
    msdyn_scenariotype Fes una pregunta
    msdyn_interactiontypename S'ha generat
    msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF (cas a partir del qual es va iniciar la interacció)
    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. Copieu el valor de the Trasncript.DataId de la .msdyn_interactioncontext En el nostre exemple, aquest valor és a1584aaf-d5bd-357d-54a8-84dbdba547f9.

  4. La següent sol·licitud d'API web recupera la transcripció codificada en 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

    En el nostre exemple, la sol·licitud de l'API web és la següent.

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

  5. Descodificar les dades codificades mitjançant un descodificador base64 amb l'opció de joc de caràcters UTF-16LE per obtenir la transcripció. Podeu utilitzar una eina de descodificació en línia per descodificar les dades. Per al nostre exemple, la transcripció descodificada es mostra de la següent manera.

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

Recuperar comentaris literals

Quan un representant interactua amb Copilot, pot proporcionar comentaris sobre les respostes que proporciona Copilot. Els comentaris s'emmagatzemen a la columna msdyn_verbatim de la msdyn_copilotinteractiondata taula del Dataverse.

Per exemple, la resposta del copilot no és precisa i el representant selecciona la icona del polze cap avall per proporcionar comentaris. El representant també proporciona comentaris literals. L'aplicació crea un registre a la msdyn_copilotinteraction taula amb el msdyn_interactiontypename definit a Polze avall.

Els atributs clau del registre són els següents.

Atribut Dades d'exemple per al nostre exemple
msdyn_copilotinteractionid 817ff9e4-cbe7-ee1-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
msdyn_scenariotype Fes una pregunta
msdyn_interactiontype 100230302
msdyn_interactiontypename Polze cap avall
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactiondataid 807ff9e4-cbe7-ee11-904c-000d3a3bb867
Identificador de partició 20250622-20250628-100230203

Nota

PartitionID només és aplicable si utilitzes la msdyn_copilotevents taula.

Podeu obtenir els comentaris literals proporcionats pel representant de la següent manera.

  1. Obteniu el valor d'identificador de registre de msdyn_copilotinteractiondata necessari de la msdyn_copilotinteraction taula.

Nota

Salta aquest pas si estàs utilitzant la msdyn_copilotevents taula. El msdyn_copilotinteractiondataid que ja està disponible a la msdyn_copilotevents taula.

  1. Executeu la següent sol·licitud d'API web per recuperar els comentaris literals.

    Si utilitzeu la msdyn_copilotevents taula, utilitzeu el següent:

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

    En el nostre exemple, la sol·licitud de Web API és la següent:

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

  2. Consulteu els comentaris literals disponibles a la columna msdyn_verbatim . Per al nostre exemple, els comentaris recuperats són els següents.

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

Descarregar dades d'interacció

Excepte les transcripcions de preguntes, per a totes les altres interaccions entre representants i Copilot, les dades s'emmagatzemen a la msdyn_copilotinteractiondata taula o msdyn_copilotevents de Dataverse.

Per exemple, una interacció pot ser un representant que utilitza Copilot per generar un correu electrònic o un resum del cas. Els atributs clau per al nostre exemple són els següents.

Atribut Valor per al nostre escenari
msdyn_copilotinteractionid 0DD941E5-34E7-EE11-904C-000D3A3BB867
msdyn_scenariorequestid 42AE7F8E-736F-1CEA-035B-6BF970B48E9C
msdyn_scenariotype Resum del cas
msdyn_interactiontype 100230305
msdyn_interactiontypename S'ha generat
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}
msdyn_interactiondataid F9D841E5-34E7-EE11-904C-000D3A3BB867

Podeu descarregar les dades d'interacció de la següent manera.

  1. Obteniu el valor d'identificador de registre de msdyn_copilotinteractiondata necessari de la msdyn_copilotinteraction taula.

Nota

Salta aquest pas si estàs utilitzant la msdyn_copilotevents taula. El msdyn_copilotinteractiondataid que ja està disponible a la msdyn_copilotevents taula.

  1. Executeu la següent petició de l'API web per recuperar les dades d'interaccions en el format codificat base64:

    Si utilitzes la taula msdyn_copilotevents, utilitza el següent:

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

    En el nostre exemple, la sol·licitud de Web API és la següent:

    <org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')/msdyn_interactiondata/$value
  1. Descodificar les dades codificades en base64 per obtenir la transcripció. Podeu utilitzar una eina de descodificació base64 en línia per descodificar les dades. Per al nostre exemple de correu electrònic, les dades d'interacció descodificades es mostren de la següent manera.

Nota

Feu una pregunta, suggeriu una resposta i redacteu un correu electrònic amb el codificador base64 amb el joc de caràcters UTF-16LE. El cas i el resum de la conversa utilitzen el joc de caràcters UTF-8. Us recomanem que utilitzeu el mateix joc de caràcters que es va utilitzar per codificar les dades per descodificar-les.

Captura de pantalla de les dades d'interacció descodificades.

Utilitzeu Copilot per resoldre els problemes dels clients
Veure l'informe d'anàlisi de copilot

  • Darrera actualització el