Compartilhar via

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.

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.

Atributo Valor de exemplo
ID da conversa 70b76ab52-120b-49e6-9dce-53f235125a01
Resumo da conversa "Problema: Problema com a válvula de infusão na máquina de café. Etapas de solução de problemas: o cliente relatou o problema. Resultado: Problema relatado para assistência adicional."

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 do representante de serviço com o Copilot é armazenada na tabela msdyn_copilotinteraction com um ID exclusivo de interação. A tabela a seguir lista onde os dados de interação correspondentes são armazenados para cada tipo de interação.

Característica Tabela
Faça uma pergunta msdyn_copilottranscriptdata
Feedback, resumo do caso, escrever um e-mail, sugerir uma resposta msdyn_copilotinteractiondata

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

Os principais atributos do registro são os seguintes.

Atributo Definição
msdyn_copilotinteractionid Identificador exclusivo para as instâncias da entidade
msdyn_scenariorequestid Agrupa várias interações relacionadas com o Copilot.
Por exemplo: um representante faz uma pergunta ao Copilot e, em seguida, marca a resposta recebida com o polegar para cima. Eles são considerados como duas interações, mas fazem parte do mesmo cenário.
msdyn_scenariotype Refere-se ao recurso usado pelo representante.
msdyn_interactiontype Refere-se à interação representativa específica com o Copilot.
msdyn_interactionforid A ID da entidade do registro referenciado, para a qual o representante interagiu com o Copilot.
msdyn_interactionforlogicalname O nome lógico da entidade do registro referenciado, no qual o representante interagiu com o Copilot.
msdyn_interactioncontext Contexto adicional, como referência a transcrições.
msdyn_interactiondataid Refere-se a msdyn_copilotinteractiondata entidade que contém dados de interação

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.

Atributo Dados de amostra para nosso exemplo
msdyn_copilotinteractionid 817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
msdyn_scenariotype Faça uma pergunta
msdyn_interactiontype 100230302
msdyn_interactiontypename ThumbsDown
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactiondataid 807ff9e4-cbe7-ee11-904c-000d3a3bb867

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.

    
   [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_copilotinteractiondataid>)
   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_copilotinteractiondatas(807ff9e4-cbe7-ee11-904c-000d3a3bb867)

  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

Exceto as transcrições de perguntas, para todas as outras interações entre representantes e o Copilot, dados são armazenados na tabela msdyn_copilotinteractiondata no 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.

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

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 de API Web para recuperar os dados de interações da msdyn_copilotinteractiondata tabela no formato codificado em base64:

     [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_copilotinteractiondataid>)/msdyn_interactiondata
 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_copilotinteractiondatas(f9d841e5-34e7-ee11-904c-000d3a3bb867)/msdyn_interactiondata

  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.

Observação

Faça uma pergunta, sugira uma resposta e esboce um e-mail Os recursos usam o codificador base64 com o conjunto de caracteres UTF-16LE. O resumo de ocorrências e conversas usa o conjunto de caracteres UTF-8. Recomendamos que você use o mesmo conjunto de caracteres usado para codificar dados para decodificá-los.

Captura de tela dos dados de interação decodificados.

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