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

Artikulua
08/28/2024

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:

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

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

Los atributos clave del registro son los siguientes.

Attribute	Definición	Valor para nuestro escenario
msdyn_copilotinteractionid		F0970641-C1E7-EE11-904C-000D3A3BB867
msdyn_scenariorequestid	Agrupa múltiples interacciones de Copilot relacionadas. Por ejemplo: un agente le hace una pregunta a Copilot y luego marca el respuesta recibido con un pulgar hacia arriba. Éstas se consideran dos interacciones, pero son parte del mismo escenario.	93893746-e203-e9b6-18b9-887d68d18daf
Tipo de escenario msdyn	Se refiere a la función utilizada por el agente.	Formular una pregunta
nombre_tipo_interacción_msdyn	Se refiere a la interacción específica del agente con Copilot.	Generado
Interacción msdyn_forid	El caso o conversación desde el cual el agente interactuó con Copilot	1cd6023d-d326-ee11-9966-000d3a3411cf (caso a partir del cual se inició la interacción)
msdyn_interactioncontext	Contexto adicional como referencia a transcripciones.
msdyn_id_datos_de_interacción	Se refiere a la entidad msdyn_copilotinteractiondata que contiene datos de interacción

Copia el valor de DataId de msdyn_interactioncontext. 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 
       } 
    } 
  }

En nuestro ejemplo, este valor es 0a7a438f-c2a5-58d7-e03d-c932812b3095.

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

En nuestro ejemplo, la solicitud de API web es la siguiente.

 [Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(0a7a438f-c2a5-58d7-e03d-c932812b3095)/msdyn_transcriptdata

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

Recuperar comentarios textuales

Cuando un agente interactúa con Copilot, puede proporcionar comentarios sobre las respuestas que proporciona Copilot. La retroalimentación se almacena en la tabla msdyn_copilotinteraction Dataverse.

Por ejemplo, el respuesta del copiloto no es preciso y el agente selecciona el ícono del pulgar hacia abajo para brindar comentarios. El agente también proporciona retroalimentación textual. La aplicación crea un registro en la tabla con el msdyn_copilotinteraction establecido en ThumbsDown. msdyn_interactiontypename

Los atributos clave para el registro son los siguientes.

Attribute	Datos de muestra para nuestro ejemplo
msdyn_copilotinteractionid	817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid	93893746-e203-e9b6-18b9-887d68d18daf
Tipo de escenario msdyn	Formular una pregunta
nombre_tipo_interacción_msdyn	ThumbsDown
Interacción msdyn_forid	1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext
msdyn_id_datos_de_interacción	807ff9e4-cbe7-ee11-904c-000d3a3bb867

Puede obtener la retroalimentación textual proporcionada por el agente de la siguiente manera.

Obtenga el valormsdyn_interactiondataidrequerido de la tabla msdyn_copilotinteraction .

Ejecute la siguiente solicitud de API web para recuperar los comentarios textuales en el formato codificado en base64.


   [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_copilotinteractiondataid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0

En nuestro ejemplo, la solicitud de API web es la siguiente.

[Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(807ff9e4-cbe7-ee11-904c-000d3a3bb867)

Descodifique los datos codificados en base64 para obtener información textual. Puede utilizar una herramienta decodificadora base64 en línea para decodificar los datos. Para nuestro ejemplo, la retroalimentación textual está disponible en la columna msdyn_verbatim .


  {
  "@odata.context": "https://ocrealtimeperftest001.crm.dynamics.com/api/data/v9.1/$metadata#msdyn_copilotinteractiondatas/$entity",
  "@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

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 y un resumen del caso. Los atributos clave para nuestro ejemplo son los siguientes.

Attribute	Valor para nuestro escenario
msdyn_copilotinteractionid	0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid	42ae7f8e-736f-1cea-035b-6bf970b48e9c
Tipo de escenario msdyn	Resumen de casos
nombre_tipo_interacción_msdyn	Generado
Interacción msdyn_forid	1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext	`{"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}`
msdyn_id_datos_de_interacción	f9d841e5-34e7-ee11-904c-000d3a3bb867

Puede descargar los datos de interacción de la siguiente manera.

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

Ejecute la siguiente solicitud de API web para recuperar los datos de interacciones de la tabla msdyn_copilotinteraction en el formato codificado base64:

 [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_interactiondataid>)/msdyn_copilotinteractiondata
 Accept: application/json  
 OData-MaxVersion: 4.0  
 OData-Version: 4.0

En nuestro ejemplo, la solicitud de API web es la siguiente.

  [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatasf9d841e5-34e7-ee11-904c-000d3a3bb867)/msdyn_interactiondata

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.

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\""
  },

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

Partekatu honen bidez:

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

Requisitos previos

Descargar las transcripciones del chat

Recuperar comentarios textuales

Descargar datos de interacción

Obtener ID de interacción

Oharrak

Baliabide gehigarriak

Partekatu honen bidez:

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

Requisitos previos

Descargar las transcripciones del chat

Recuperar comentarios textuales

Descargar datos de interacción

Obtener ID de interacción

Información relacionada

Oharrak

Baliabide gehigarriak