Compartir a través de


Descargue las transcripciones de Copilot y los datos de interacción

Cuando los agentes usan Copilot, las interacciones de los agentes con Copilot, como copiar resúmenes, usar una respuesta sugerida, comentarios y transcripciones de chat, se almacenan en las tablas msdyn_copilotinteraction, msdyn_copilotinteractiondata, msdyn_copilottranscript y msdyn_copilottranscriptdata en Dataverse. Puede descargar las transcripciones y los datos de interacción mediante solicitudes de API web.

Requisitos previos

  • Asegúrese de que la casilla de verificación Datos de experiencia del agente esté seleccionada en Panel de ayuda de Copilot, para que los datos de transacciones e interacciones las almacene el sistema en Dataverse.
  • Asegúrese de que ha iniciado sesión con el rol Administrador o Supervisor.
  • Obtener el ID de interacción.

Descargar las transcripciones del chat

Cuando un agente le hace una pregunta a Copilot, el chat se guarda como una transcripción codificada en el formato codificado base64 en la tabla msdyn_transcriptdata en Dataverse. Puede descargar las transcripciones para revisar la conversación y las respuestas proporcionadas por Copilot.

Por ejemplo, mientras trabaja en un caso, el agente le pregunta a Copilot "¿Cómo puedo reservar un viaje?". Copilot genera una respuesta basada en un artículo de Knowledge Base. Si desea descargar la transcripción del chat, realice los siguientes pasos:

  1. Utilice la llamada API web para obtener el ID de interacción.

  2. Filtre la tabla msdyn_copilotinteractions con el ID de interacción requerido para llegar al DataID. Utilice la siguiente solicitud de API web para filtrar los 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  
    

    Copie el valor de DataId. He aquí un ejemplo de contexto JSON.

    
        { 
         "ResponseStatusCode": 20000, 
         "Plugins": { 
          }, 
          "Transcript": { 
          "Id": "c477c6dd-d877-c6d1-9337-31e5b54e4a1b", 
          "DataId": "0a7a438f-c2a5-58d7-e03d-c932812b3095"  
          }, 
          "Filters": { 
           "AgentContextFilters": [ 
           ], 
           "DynamicFilters": { 
             "IsApplied": false 
          } 
       } 
     }
    
    
  3. La siguiente solicitud de API web recupera la transcripción en la transcripción codificada en base64.

     [Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(<Trascript:DataID>)/msdyn_transcriptdata)
     Accept: application/json  
     OData-MaxVersion: 4.0  
     OData-Version: 4.0  
    
  4. Decodifica los datos codificados en base64 para obtener la transcripción. Puede utilizar una herramienta decodificadora base64 en línea para decodificar los datos. Para nuestro ejemplo, la transcripción decodificada se muestra de la siguiente 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\": \"56d56813-04f5-ed11-8849-000d3a35dbfc\",\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 an agent 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": "56d56813-04f5-ed11-8849-000d3a35dbfc",
              "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": "56d56813-04f5-ed11-8849-000d3a35dbfc",
        "entityName": "knowledgearticle"
      }
    } 
    
    

Descargar datos de interacción

Para todas las demás interacciones entre los agentes y Copilot, los datos se almacenan en la tabla msdyn_copilotinteractiondata en Dataverse.

Por ejemplo, una interacción puede ser un agente que utiliza Copilot para generar un correo electrónico o un resumen de un caso. Puede descargar los datos de interacción de la siguiente manera:

  1. Utilice la llamada API web para obtener el ID de interacción.

  2. La siguiente solicitud de API web recupera los datos de interacciones de la tabla msdyn_copilotinteraction en el formato codificado en base64:

     [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_interactiondataid>)/msdyn_copilotinteractiondata
     Accept: application/json  
     OData-MaxVersion: 4.0  
     OData-Version: 4.0  
    
  3. Decodifica los datos codificados en base64 para obtener la transcripción. Puede utilizar una herramienta decodificadora base64 en línea para decodificar los datos. Para nuestro ejemplo de correo electrónico, los datos de interacción decodificados se muestran de la siguiente manera.

    Captura de pantalla de los datos de interacción decodificados.

Si desea descargar los comentarios proporcionados por el agente, siga los mismos pasos. Los comentarios textuales proporcionados por los agentes se almacenan en el atributo msdyn_verbatim de la tabla msdyn_copilotinteractiondata.

Obtener ID de interacción

Cada interacción del agente con Copilot se almacena en la tabla msdyn_copilotinteraction con un ID de interacción único. Puede utilizar la siguiente llamada a la API web para obtener el ID de interacción en el campo msdyn_copilotinteractionid.

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

Las interacciones se muestran en la respuesta de la siguiente manera.


{
"@odata.context": "https://copilotchatorg260224.crm10.dynamics.com/api/data/v9.1/$metadata#msdyn_copilotinteractions",
"value": [
  {
    "_createdby_value": "78866530-afd0-ee11-904d-6045bdff74d5",
    "createdon": "2024-03-06T06:30:58Z",
    "_createdonbehalfby_value": null,
    "importsequencenumber": null,
    "_modifiedby_value": "78866530-afd0-ee11-904d-6045bdff74d5",
    "modifiedon": "2024-03-06T06:30:58Z",
    "_modifiedonbehalfby_value": null,
    "msdyn_clienttimestamp": "2024-03-06T06:30:51Z",
    "msdyn_copilotinteractionid": "1be35d14-83db-ee11-904c-000d3a100664",
    "msdyn_interactioncontext": "{}",
    "_msdyn_interactiondataid_value": null,
    "msdyn_interactionforid": "78866530-afd0-ee11-904d-6045bdff74d5",
    "msdyn_interactionforlogicalname": "systemuser",
    "msdyn_interactiontype": 100230309,
    "msdyn_name": null,
    "msdyn_scenariorequestid": null,
    "msdyn_scenariotype": 100230201,
    "_organizationid_value": "ad57bad3-0bd3-ee11-9049-00224820c23e",
    "overriddencreatedon": null,
    "statecode": 0,
    "statuscode": 1,
    "timezoneruleversionnumber": 4,
    "utcconversiontimezonecode": 92,
    "versionnumber": 7002510,
    "@odata.etag": "W/\"7002510\""
  },
  {
    "_createdby_value": "f691f2d2-6fd4-ee11-904c-6045bdd8b8c9",
    "createdon": "2024-03-11T04:45:40Z",
    "_createdonbehalfby_value": null,
    "importsequencenumber": null,
    "_modifiedby_value": "f691f2d2-6fd4-ee11-904c-6045bdd8b8c9",
    "modifiedon": "2024-03-11T04:45:40Z",
    "_modifiedonbehalfby_value": null,
    "msdyn_clienttimestamp": "2024-03-11T04:45:38Z",
    "msdyn_copilotinteractionid": "d44ad235-62df-ee11-904c-000d3a100664",
    "msdyn_interactioncontext": "{}",
    "_msdyn_interactiondataid_value": null,
    "msdyn_interactionforid": "f691f2d2-6fd4-ee11-904c-6045bdd8b8c9",
    "msdyn_interactionforlogicalname": "systemuser",
    "msdyn_interactiontype": 100230309,
    "msdyn_name": null,
    "msdyn_scenariorequestid": null,
    "msdyn_scenariotype": 100230201,
    "_organizationid_value": "ad57bad3-0bd3-ee11-9049-00224820c23e",
    "overriddencreatedon": null,
    "statecode": 0,
    "statuscode": 1,
    "timezoneruleversionnumber": 4,
    "utcconversiontimezonecode": 92,
    "versionnumber": 7310986,
    "@odata.etag": "W/\"7310986\""
  },

Consulte también

Usar Copilot para resolver problemas de clientes
Ver informe de análisis de copiloto