Descargar transcricións e datos de interacción de Copilot

Os representantes do servizo ao cliente (representantes ou representantes do servizo) usan funcións de Copilot como copiar resumos, usar unha resposta suxerida, comentarios e chat. As interaccións de Copilot almacénanse nas táboas Copilot Interaction (msdyn_copilotinteraction),Copilot Interaction Data (msdyn_copilotinteractiondata),Copilot Transcript (msdyn_copilottranscript) e Copilot Transcript Data (msdyn_copilottranscriptdata) en Dataverse. Podes descargar as transcricións e os datos de interacción usando Dataverse Web API ou SDK para .NET.

A partir de agosto de 2025, as interaccións co copiloto almacénanse na táboa msdyn_copilotevents . As táboas msdyn_copilotinteraction e msdyn_copilotinteractiondata conteñen rexistros anteriores a agosto.

Requisitos previos

  • Asegúrese de que a caixa de verificación Datos da experiencia de soporte está seleccionada en Copilot para preguntas e correos electrónicos, de xeito que os datos de transacción e interacción sexan almacenados polo sistema en Dataverse.
  • Asegúrese de iniciar sesión co rol de administrador omnicanal ou supervisor omnicanal.

Recuperar o resumo da conversa

Cando un representante do servizo usa Copilot para xerar un resumo de conversa, o resumo almacénase na msdyn_conversationinsight táboa de Dataverse. Créase un rexistro na táboa cun ID de conversa único almacenado no msdyn_ConversationId campo. O texto do resumo está almacenado no msdyn_copilotsummary campo.

Por exemplo, despois de rematar unha conversa cun cliente, un representante de servizo usa Copilot para xerar un resumo de conversa. O resumo da conversa almacénase na msdyn_conversationinsight táboa cos seguintes valores.

Atributo Valor da mostra
ID da conversa 70b76ab52-120b-49e6-9dce-53f235125a01
Resumo da conversa "Problema: Problemas coa válvula de elaboración da máquina de café. Pasos de resolución de problemas: O cliente informou do problema. Resultado: Problema informado para máis asistencia. "

Podes consultar o resumo da conversa do seguinte xeito:

  1. Identifica o ID da conversa, que é o identificador principal do rexistro na msdyn_ocliveworkitem táboa. No noso exemplo, este valor é 70b76ab52-120b-49e6-9dce-53f235125a01.

  2. Use a seguinte solicitude de API web para filtrar o rexistro da msdyn_conversationinsight táboa.

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

    No noso exemplo, a solicitude de API web é a seguinte.

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

    A resposta da mostra para o noso exemplo é a seguinte:

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

Onde se almacenan as interaccións do copiloto

A interacción de cada representante de servizo con Copilot almacénase na msdyn_copilotinteraction táboa de ou msdyn_copilotevents cun ID de interacción único. Na seguinte táboa enumera onde se almacenan os datos de interacción correspondentes para cada tipo de interacción.

Funcionalidade Táboa
Facer unha pregunta msdyn_copilottranscriptdata
Comentarios, resumo de casos, escribir un correo electrónico, suxerir unha resposta msdyn_copilotinteractiondata, msdyn_copilotevents

Nota

Os rexistros de interacción de Copilot almacénanse na msdyn_copilotevents táboa, a partir de agosto de 2025. Os rexistros anteriores a agosto almacénanse nas msdyn_copilotinteraction táboas de e msdyn_copilotinteractiondata .

Obter msdyn_copilotinteractionid e msdyn_interactiondataid dos rexistros de interacción co piloto

Antes de realizar accións como descargar unha transcrición ou ver comentarios literais, debes recuperar os valores e msdyn_copilotinteractionid o correspondente valor de identificación do rexistro msdyn_copilotinteractiondata de msdyn_copilotinteraction. Pode usar a seguinte chamada á API web para obter o ID de interacción no msdyn_copilotinteractionid campo e o interactiondataid no msdyn_interactiondataid_value campo.

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

Obtén msdyn_copilotinteractionid dos rexistros do evento de copiloto

Antes de descargar unha transcrición ou ver comentarios literais, debes recuperar os valores de msdyn_copilotinteractionid da msdyn_copilotevents táboa. Podes usar a seguinte chamada á API web para obter o ID de interacción no msdyn_copilotinteractionid campo.

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

Atributos clave

Os atributos clave do rexistro son os seguintes.

Atributo Definición
msdyn_copilotinteractionid Identificador único para as instancias de entidades
msdyn_scenariorequestid Grupos de múltiples interaccións relacionadas co piloto.
Por exemplo: Un representante fai unha pregunta a Copilot e, a continuación, marca a resposta recibida co polgar cara arriba. Considéranse dúas interaccións, pero forman parte do mesmo escenario.
msdyn_scenariotype Refírese á característica utilizada polo representante.
msdyn_interactiontype Refírese á interacción representativa específica con Copilot.
msdyn_interactionforid O ID da entidade do rexistro referenciado, para o que o representante interactuou con Copilot.
msdyn_interactionforlogicalname Nome lóxico da entidade do rexistro referenciado, para o cal o representante interactuou con Copilot.
msdyn_interactioncontext Contexto adicional como referencia a transcricións.
msdyn_interactiondataid Refírese a msdyn_copilotinteractiondata entidade que contén datos de interacción

Exemplo de resposta

A seguinte resposta indica un escenario no que un representante fai unha pregunta ao Copilot e, a continuación, selecciona o botón polgar para abaixo para proporcionar comentarios. O msdyn_scenariorequestid, msdyn_scenariotype é o mesmo para ambas as interaccións. Os msdyn_interactiontype valores para as interaccións están establecidos en 100230305 e 100230302, que corresponden a Xerado e Polgar abaixo.


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

Descargar transcricións de chat

Cando un representante do servizo fai unha pregunta a Copilot, o chat gárdase como unha transcrición codificada no formato codificado base64 usando o conxunto de caracteres UTF-16LE na msdyn_copilottranscriptdata táboa de Dataverse. Podes descargar as transcricións para revisar a conversa e as respostas proporcionadas por Copilot.

Por exemplo, mentres traballaba nun caso, o representante do servizo pregunta a Copilot "Como podo reservar unha viaxe?". Copilot xera unha resposta baseada nun artigo da base de coñecemento. Se queres descargar a transcrición do chat, siga os seguintes pasos:

  1. Use a chamada API web para obter o ID de interacción.

  2. Filtra a táboa msdyn_copilotinteraction co ID de interacción requirido para chegar ao Transcript.DataID atributo from msdyn_interactioncontext . Use a seguinte solicitude de API web para filtrar os datos por ID de interacción.

    
   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0
    Atributo Valor para o noso escenario
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
    msdyn_scenariotype Facer unha pregunta
    msdyn_interactiontypename Xeración
    msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf (caso a partir do cal se iniciou a interacción)
    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. Copia o valor do Trasncript.DataIdmsdyn_interactioncontext. No noso exemplo, este valor é a1584aaf-d5bd-357d-54a8-84dbdba547f9.

  4. A seguinte solicitude de API web recupera a transcrición codificada no formato 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

    No noso exemplo, a solicitude de API web é a seguinte.

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

  5. Decodificar os datos codificados usando un descodificador base64 coa opción de conxunto de caracteres UTF-16LE para obter a transcrición. Podes usar unha ferramenta de decodificador en liña para descifrar os datos. No noso exemplo, a transcrición decodificada móstrase do seguinte xeito.

    
{
  "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 comentarios literais

Cando un representante interactúa con Copilot, pode proporcionar comentarios sobre as respostas que proporciona Copilot. Os comentarios almacénanse na columna msdyn_verbatim da msdyn_copilotinteractiondata táboa de Dataverse.

Por exemplo, a resposta do Copilot non é precisa e o representante selecciona a icona polgar cara abaixo para proporcionar comentarios. O representante tamén ofrece comentarios literais. A aplicación crea un rexistro na msdyn_copilotinteraction táboa co set msdyn_interactiontypename a ThumbsDown.

Os atributos clave para o rexistro son os seguintes.

Atributo Exemplo de datos para o noso exemplo
msdyn_copilotinteractionid 817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
msdyn_scenariotype Facer unha pregunta
msdyn_interactiontype 100230302
msdyn_interactiontypename Polgar cara abaixo
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactiondataid 807ff9e4-cbe7-ee11-904c-000d3a3bb867
Identificador de partición 20250622-20250628-100230203

Nota

PartitionID é aplicable só se estás a usar a msdyn_copilotevents táboa.

Podes obter os comentarios literais proporcionados polo representante do seguinte xeito.

  1. Obtén o valor de identificación do rexistro msdyn_copilotinteractiondata requirido da msdyn_copilotinteraction táboa.

Nota

Salta este paso se estás a usar a msdyn_copilotevents táboa. Xa msdyn_copilotinteractiondataid está dispoñible na msdyn_copilotevents táboa.

  1. Executa a seguinte solicitude de API web para recuperar os comentarios literais.

    Se estás a usar a msdyn_copilotevents táboa, usa o seguinte:

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

    No noso exemplo, a solicitude da Web API é a seguinte:

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

  2. Ver os comentarios literais dispoñibles na columna msdyn_verbatim . No noso exemplo, o feedback recuperado é o seguinte.

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

Descargar datos de interacción

Agás as transcricións de preguntas rápidas, para todas as outras interaccións entre representantes e Copilot, os datos almacénanse na msdyn_copilotinteractiondata táboa de ou msdyn_copilotevents en Dataverse.

Por exemplo, unha interacción pode ser un representante usando Copilot para xerar un correo electrónico ou un resumo do caso. Os principais atributos do noso exemplo son os seguintes.

Atributo Valor para o noso escenario
msdyn_copilotinteractionid 0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 42ae7f8e-736f-1cea-035b-6bf970b48e9c
msdyn_scenariotype Resumo do caso
msdyn_interactiontype 100230305
msdyn_interactiontypename Xeración
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}
msdyn_interactiondataid f9d841e5-34e7-ee11-904c-000d3a3bb867

Podes descargar os datos de interacción do seguinte xeito.

  1. Obtén o valor de identificación do rexistro msdyn_copilotinteractiondata requirido da msdyn_copilotinteraction táboa.

Nota

Salta este paso se estás a usar a msdyn_copilotevents táboa. Xa msdyn_copilotinteractiondataid está dispoñible na msdyn_copilotevents táboa.

  1. Executa a seguinte solicitude da API web para recuperar os datos das interaccións no formato codificado base64:

    Se estás a usar a táboa msdyn_copilotevents, usa o seguinte:

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

    No noso exemplo, a solicitude da Web API é a seguinte:

    <org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')/msdyn_interactiondata/$value
  1. Descifrar os datos codificados base64 para obter a transcrición. Podes usar unha ferramenta de decodificador base64 en liña para descifrar os datos. Para o noso exemplo de correo electrónico, os datos de interacción decodificados móstranse do seguinte xeito.

Nota

Fai unha pregunta, suxire unha resposta e borrar un correo electrónico As funcións usan o codificador base64 co conxunto de caracteres UTF-16LE. Resumo de casos e conversas usan un conxunto de caracteres UTF-8. Recoméndase usar o mesmo conxunto de caracteres que se usou para codificar os datos para descifalos.

Captura de pantalla dos datos de interacción decodificados.

Use Copilot para resolver problemas dos clientes
Ver informe de análise de Copilot

  • Última actualización o