Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Los representantes de servicio al cliente (representantes de servicio o representantes) usan características de Copilot como copiar resúmenes, usar una respuesta sugerida, comentarios y chat. Las interacciones del copiloto se almacenan en las tablas Interacción con Copilot (msdyn_copilotinteraction), Datos de interacción con Copilot (msdyn_copilotinteractiondata), Transcripción de Copilot (msdyn_copilottranscript) y Datos de transcripción de Copilot (msdyn_copilottranscriptdata) en Dataverse. Puede descargar las transcripciones y los datos de interacción mediante Dataverse API web o SDK para .NET.
Requisitos previos
- Asegúrese de que la casilla de verificación Datos de experiencia de soporte esté seleccionada en Copilot para preguntas y correos electrónicos, de modo que el sistema almacene los datos de transacciones e interacciones en Dataverse.
- Asegúrese de haber iniciado sesión con el rol Administrador omnicanal o Supervisor omnicanal.
Recuperar resumen de conversación
Cuando un representante de servicio usa Copilot para generar un resumen de conversación, el resumen se almacena en la tabla msdyn_conversationinsight
en Dataverse. Se crea un registro en la tabla con un identificador de conversación único que se almacena en el campo msdyn_ConversationId
. El texto de resumen se almacena en el campo msdyn_copilotsummary
.
Por ejemplo, después de concluir una conversación con un cliente, un representante de servicio usa Copilot para generar un resumen de la conversación. El resumen de la conversación se almacena en la tabla msdyn_conversationinsight
con los siguientes valores.
Atributo | Valor de ejemplo |
---|---|
Id. de la conversación | 70b76ab52-120b-49e6-9dce-53f235125a01 |
Resumen de conversación | "Incidencia: problema con la válvula de infusión de la cafetera. Pasos para la solución de problemas: el cliente ha informado del problema. Resultado: Se informó del problema para que se recibiera más asistencia." |
Puede recuperar el resumen de la conversación de la siguiente manera:
Identifique la conversación, que es el identificador principal del registro en la tabla
msdyn_ocliveworkitem
. En nuestro ejemplo, el valor es 70b76ab52-120b-49e6-9dce-53f235125a01.Use la siguiente solicitud de API web para filtrar el registro de la tabla
msdyn_conversationinsight
.[Organization URI]/api/data/v9.2/msdyn_conversationinsights?$filter=_msdyn_conversationid_value eq '<conversation-ID>'
En nuestro ejemplo, la solicitud de la API web es la siguiente.
https://<yourorg>.crm.dynamics.com/api/data/v9.2/msdyn_conversationinsights?$filter=_msdyn_conversationid_value eq '70b76ab52-120b-496e-9dce-53f235125a01'
La respuesta para nuestro ejemplo es la siguiente:
{ "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." }
¿Dónde se almacenan mis interacciones copiloto?
Cada interacción de representante de servicio con Copilot se almacena en la tabla msdyn_copilotinteraction
con un ID de interacción único. En la siguiente tabla se muestra dónde se almacenan los datos de interacción correspondientes para cada tipo de interacción.
Característica | Tabla |
---|---|
Formular una pregunta | msdyn_copilottranscriptdata |
Comentarios, resumen del caso, escribir un correo electrónico, sugerir una respuesta | msdyn_copilotinteractiondata |
Obtener msdyn_copilotinteractionid y msdyn_interactiondataid de registros de interacción copiloto
Antes de realizar acciones como descargar una transcripción o ver comentarios literales, debe recuperar los valores de msdyn_copilotinteractionid
y el valor correspondiente del id. de registro de msdyn_copilotinteractiondata de msdyn_copilotinteraction
. Puede usar la siguiente llamada a la API web para obtener el id. de interacción en el campo msdyn_copilotinteractionid
y el interactiondataid en el campo msdyn_interactiondataid_value
.
[Organization URI]/api/data/v9.1/msdyn_copilotinteractions
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
Los atributos clave del registro son los siguientes.
Atributo | Definición |
---|---|
msdyn_copilotinteractionid | Identificador único de instancias de entidad. |
msdyn_scenariorequestid | Agrupa varias interacciones Copilot relacionadas. Por ejemplo: un representante pregunta a Copilot y luego marca la respuesta recibida con el pulgar hacia arriba. Se consideran como dos interacciones, pero forman parte del mismo escenario. |
msdyn_scenariotype | Se refiere a la característica utilizada por el representante. |
msdyn_interactiontype | Se refiere a la interacción específica del representante con Copilot. |
msdyn_interactionforid | Id. de entidad del registro al que se hace referencia, para el que el representante interactuó con el Copilot. |
msdyn_interactionforlogicalname | El nombre lógico de la entidad del registro al que se hace referencia, para el que el representante interactuó con Copilot. |
msdyn_interactioncontext | Contexto adicional, como referencia a transcripciones. |
msdyn_interactiondataid | Hace referencia a la entidad msdyn_copilotinteractiondata que contiene datos de interacción |
Respuesta de muestra
La siguiente respuesta indica un escenario en el que un representante hace una pregunta al Copilot y, a continuación, selecciona el botón del pulgar hacia abajo para proporcionar comentarios. El msdyn_scenariorequestid
, msdyn_scenariotype
es el mismo para ambas interacciones. Los valores msdyn_interactiontype
de las interacciones se establecen en 100230305 y 100230302, que corresponden a Generado y Pulgar hacia abajo.
{
"@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 las transcripciones del chat
Cuando un representante de servicio hace una pregunta al Copilot, el chat se guarda como una transcripción codificada en el formato codificado en base64 utilizando el conjunto de caracteres UTF-16LE en la tabla msdyn_copilottranscriptdata
en Dataverse. Puede descargar las transcripciones para revisar la conversación y las respuestas proporcionadas por Copilot.
Por ejemplo, mientras se trabaja en un caso, el representante de servicio pregunta 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_copilotinteraction con el ID de interacción requerido para llegar al
Transcript.DataID
del atributomsdyn_interactioncontext
. 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
Atributo Valor para nuestro escenario msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867 msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf msdyn_scenariotype Formular una pregunta msdyn_interactiontypename Generado msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf (caso desde el que se inició la 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}
Copie el valor de
Trasncript.DataId
de lamsdyn_interactioncontext
. En nuestro ejemplo, el valor es a1584aaf-d5bd-357d-54a8-84dbdba547f9.La siguiente solicitud de API web recupera la transcripción codificada en el 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
En nuestro ejemplo, la solicitud de la API web es la siguiente.
[Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(a1584aaf-d5bd-357d-54a8-84dbdba547f9)/msdyn_transcriptdata
Decodifique los datos codificados utilizando un decodificador base64 con la opción de conjunto de caracteres UTF-16LE para obtener la transcripción. Puede utilizar una herramienta de decodificación 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\": \"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 texto de comentarios
Cuando un representante interactúa con Copilot, puede proporcionar comentarios sobre las respuestas que da Copilot. La información se almacena en la columna msdyn_verbatim
de la tabla msdyn_copilotinteractiondata
de Dataverse.
Por ejemplo, la respuesta del Copilot no es precisa y el representante selecciona el icono del pulgar hacia abajo para proporcionar comentarios. El representante también proporciona comentarios textuales. La aplicación crea un registro en la tabla msdyn_copilotinteraction
con el msdyn_interactiontypename
establecido en ThumbsDown.
Los atributos clave para el registro son los siguientes.
Atributo | Datos de ejemplo de nuestro ejemplo |
---|---|
msdyn_copilotinteractionid | 817ff9e4-cbe7-ee11-904c-000d3a3bb867 |
msdyn_scenariorequestid | 93893746-e203-e9b6-18b9-887d68d18daf |
msdyn_scenariotype | Formular una pregunta |
msdyn_interactiontype | 100230302 |
msdyn_interactiontypename (Nombre de tipo de interacción) | ThumbsDown |
msdyn_interactionforid | 1cd6023d-d326-ee11-9966-000d3a3411cf |
msdyn_interactiondataid | 807ff9e4-cbe7-ee11-904c-000d3a3bb867 |
Puede obtener los comentarios literales proporcionados por el representante de la siguiente manera.
Obtenga el valor de id. de registro de msdyn_copilotinteractiondata requerido de la tabla
msdyn_copilotinteraction
.Ejecute la siguiente solicitud de API web para recuperar los comentarios literales.
[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 la API web es la siguiente.
[Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(807ff9e4-cbe7-ee11-904c-000d3a3bb867)
Para nuestro ejemplo, los comentarios literales están disponibles en la columna
msdyn_verbatim
. En nuestro ejemplo, los comentarios recuperados son los siguientes.{ "@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
A excepción de las transcripciones de hacer una pregunta, para todas las demás interacciones entre representantes y Copilot, los datos se almacenan en la tabla msdyn_copilotinteractiondata
en Dataverse.
Por ejemplo, una interacción puede ser un representante usando Copilot para generar un correo electrónico o un resumen de caso. Los atributos clave de nuestro ejemplo son los siguientes.
Atributo | Valor para nuestro escenario |
---|---|
msdyn_copilotinteractionid | 0dd941e5-34e7-ee11-904c-000d3a3bb867 |
msdyn_scenariorequestid | 42AE7F8E-736F-1CEA-035B-6BF970B48E9C |
msdyn_scenariotype | Resumen de casos |
msdyn_interactiontype | 100230305 |
msdyn_interactiontypename | Generado |
msdyn_interactionforid | 1cd6023d-d326-ee11-9966-000d3a3411cf |
msdyn_interactioncontext | {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}} |
msdyn_interactiondataid | f9d841e5-34e7-ee11-904c-000d3a3bb867 |
Puede descargar los datos de interacción de la siguiente manera.
Obtenga el valor de id. de registro de msdyn_copilotinteractiondata requerido de la tabla
msdyn_copilotinteraction
.Ejecute la siguiente solicitud de API web para recuperar los datos de interacciones de la tabla
msdyn_copilotinteractiondata
en el formato codificado en base64:[Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_copilotinteractiondataid>)/msdyn_interactiondata Accept: application/json OData-MaxVersion: 4.0 OData-Version: 4.0
En nuestro ejemplo, la solicitud de la API web es la siguiente.
[Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(f9d841e5-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.
Nota
Las características de formular una pregunta, sugerir una respuesta y redactar un correo electrónico utilizan el codificador Base64 con el juego de caracteres UTF-16LE. El resumen del caso y la conversación usa el juego de caracteres UTF-8. Se recomienda utilizar el mismo juego de caracteres que se utilizó para codificar los datos a fin de descodificarlos.
Información relacionada
Usar Copilot para resolver problemas de clientes
Ver informe de análisis de Copilot