Baixar as transcrições e os dados de interação do Copilot

Os representantes de atendimento ao cliente (representantes ou representantes de serviço) usam os recursos do Copilot, como copiar resumos, usar uma resposta sugerida, feedback e bate-papo. As interações do Copilot são armazenadas nas tabelas Interação do Copiloto (msdyn_copilotinteraction),Dados de Interação do Copiloto (msdyn_copilotinteractiondata),Transcrição do Copiloto (msdyn_copilottranscript) e Dados de Transcrição do Copiloto (msdyn_copilottranscriptdata) no Dataverse. Você pode baixar as transcrições e os dados de interação usando a API Web do Dataverse ou o SDK para .NET.

A partir de agosto de 2025, as interações com copilotos são armazenadas na tabela msdyn_copilotevents . As tabelas msdyn_copilotinteraction e msdyn_copilotinteractiondata contêm registros anteriores a agosto.

Pré-requisitos

• Certifique-se de que a caixa de seleção Dados da experiência de suporte esteja marcada no Copilot para perguntas e e-mails, para que os dados de transação e interação sejam armazenados pelo sistema no Dataverse.
• Verifique se você está conectado com a função de administrador ou supervisor do Omnicanal.

Recuperar resumo da conversa

Quando um representante de serviço usa o msdyn_conversationinsight Copilot para gerar um resumo da conversa, o resumo é armazenado na tabela no Dataverse. Um registro é criado na tabela com uma ID de conversa exclusiva armazenada no msdyn_ConversationId campo. O texto de resumo é armazenado no msdyn_copilotsummary campo.

Por exemplo, depois de encerrar uma conversa com um cliente, um representante de serviço usa o Copilot para gerar um resumo da conversa. O resumo da msdyn_conversationinsight conversa é armazenado na tabela com os valores a seguir.

Você pode recuperar o resumo da conversa da seguinte maneira:

1. Identifique a ID da conversa, que é o identificador primário do registro na msdyn_ocliveworkitem tabela. Em nosso exemplo, esse valor é 70b76ab52-120b-49e6-9dce-53f235125a01.

2. Use a solicitação de API Web a seguir para filtrar o registro da msdyn_conversationinsight tabela.

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

   Em nosso exemplo, a solicitação da 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 para nosso 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 minhas interações com o copiloto são armazenadas

Cada interação de um representante de atendimento com o Copilot é armazenada na tabela msdyn_copilotinteraction ou msdyn_copilotevents com um ID de interação exclusivo. A tabela a seguir lista onde os dados de interação correspondentes são armazenados para cada tipo de interação.

Obtenha msdyn_copilotinteractionid e msdyn_interactiondataid dos registros de interação do copiloto

Antes de executar ações como baixar uma transcrição ou exibir comentários literais, você deve recuperar os valores de msdyn_copilotinteractionid e o valor de ID do registro msdyn_copilotinteractiondata correspondente de msdyn_copilotinteraction. Você pode usar a chamada de API Web a seguir para obter a ID de interação 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  

Obtenha msdyn_copilotinteractionid dos registros de eventos do Copilot

Antes de baixar uma transcrição ou visualizar o feedback na íntegra, você deve obter os valores de msdyn_copilotinteractionid da tabela msdyn_copilotevents. Você pode usar a seguinte chamada Web API para obter o ID de interação no msdyn_copilotinteractionid campo.

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

Atributos de chave

Os principais atributos do registro são os seguintes.

Resposta de exemplo

A resposta a seguir indica um cenário em que um representante faz uma pergunta ao Copilot e, em seguida, seleciona o botão de polegar para baixo para fornecer comentários. O msdyn_scenariorequestid, msdyn_scenariotype é o mesmo para ambas as interações. Os msdyn_interactiontype valores das interações são definidos como 100230305 e 100230302, que correspondem a Gerado e Polegar para baixo.

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

Baixar transcrições de bate-papo

Quando um representante de serviço faz uma pergunta ao Copilot, o chat é salvo como uma transcrição codificada no formato codificado em base64 usando o conjunto de caracteres UTF-16LE na tabela no msdyn_copilottranscriptdata Dataverse. Você pode baixar as transcrições para revisar a conversa e as respostas fornecidas pelo Copilot.

Por exemplo, enquanto trabalha em um caso, o representante de serviço pergunta ao Copilot "Como posso reservar uma viagem?". O Copilot gera uma resposta com base em um artigo da base de conhecimento. Se você deseja baixar a transcrição do bate-papo, execute as seguintes etapas:

1. Use a chamada da API Web para obter a ID de interação.

2. Filtre a tabela msdyn_copilotinteraction com a ID de interação necessária para ter acesso ao Transcript.DataID pelo atributo msdyn_interactioncontext. Use a solicitação de API Web a seguir para filtrar os dados por ID de interação.

   
      [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 nosso cenário
   msdyn_copilotinteractionid	F0970641-C1E7-EE11-904C-000D3A3BB867
   msdyn_scenariorequestid	93893746-e203-e9b6-18b9-887d68d18daf
   msdyn_scenariotype	Faça uma pergunta
   msdyn_interactiontypename	Gerado
   msdyn_interactionforid	1CD6023D-D326-EE11-9966-000D3A3411CF (caso a partir do qual a interação foi iniciada)
   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. Copie o valor de Trasncript.DataId do msdyn_interactioncontext. Em nosso exemplo, esse valor é a1584aaf-d5bd-357d-54a8-84dbdba547f9.

4. A solicitação de API Web a seguir recupera a transcrição 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  
   

   Em nosso exemplo, a solicitação da API Web é a seguinte.

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

5. Decodifique os dados codificados usando um decodificador base64 com a opção de conjunto de caracteres UTF-16LE para obter a transcrição. Você pode usar uma ferramenta de decodificador online para decodificar os dados. Para nosso exemplo, a transcrição decodificada é exibida da seguinte maneira.
   

   
   {
     "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 comentários literais

Quando um representante interage com o Copilot, ele pode fornecer feedback sobre as respostas que o Copilot fornece. Os comentários são armazenados na msdyn_verbatim coluna da msdyn_copilotinteractiondata tabela no Dataverse.

Por exemplo, a resposta do Copilot não é precisa e o representante seleciona o ícone de polegar para baixo para fornecer feedback. O representante também fornece feedback literal. O aplicativo cria um registro na msdyn_copilotinteraction tabela com o msdyn_interactiontypename definido como ThumbsDown.

Os principais atributos para o registro são os seguintes.

Você pode obter o feedback literal fornecido pelo representante da seguinte forma.

1. Obtenha o valor de ID de registro msdyn_copilotinteractiondata necessário na msdyn_copilotinteraction tabela.

2. Execute a solicitação de API Web a seguir para recuperar os comentários literais.

   • msdyn_copilotevents
   • msdyn_copilotinteractiondata

   Se você está usando a msdyn_copilotevents tabela, use o seguinte:

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

   No nosso exemplo, a solicitação da Web API é a seguinte:

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

3. Veja os comentários literais disponíveis na msdyn_verbatim coluna. Para nosso 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
   }
   
   

Baixar dados de interação

Com exceção das transcrições de fazer uma pergunta, para todas as outras interações entre representantes e o Copilot, os dados são armazenados na tabela msdyn_copilotinteractiondata ou msdyn_copilotevents do Dataverse.

Por exemplo, uma interação pode ser um representante usando o Copilot para gerar um e-mail ou um resumo de caso. Os principais atributos do nosso exemplo são os seguintes.

Você pode baixar os dados de interação da seguinte maneira.

1. Obtenha o valor de ID de registro msdyn_copilotinteractiondata necessário na msdyn_copilotinteraction tabela.

2. Execute a seguinte solicitação da Web API para recuperar os dados de interação no formato codificado base64:

   • msdyn_copilotevents
   • msdyn_copilotinteractiondata

   Se você estiver usando a tabela msdyn_copilotevents, use o seguinte:

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

   No nosso exemplo, a solicitação 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 
   

3. Decodifique os dados codificados em base64 para obter a transcrição. Você pode usar uma ferramenta de decodificador base64 online para decodificar os dados. Para nosso exemplo de e-mail, os dados de interação decodificados são exibidos da seguinte maneira.

Informações relacionadas

Usar o Copilot para resolver problemas dos clientes
Veja o relatório de análise do copiloto