Comprender las transcripciones de la conversación descargadas desde Power Apps

Puede ver, exportar y descargar transcripciones de interacciones de los clientes con su agente tanto en Power Apps como en Copilot Studio. La información que exporta cada aplicación es ligeramente diferente.

Importante

Los creadores con el rol de Creador de entorno no tienen acceso automático a las transcripciones.

Este artículo cubre la descarga de transcripciones de conversaciones en Power Apps y su uso para crear informes en Power BI. Para descargar transcripciones directamente en Copilot Studio, consulte Descargar transcripciones de conversaciones en Copilot Studio.

De forma predeterminada, Power Apps descarga transcripciones de conversaciones de los últimos 30 días. Puede Cambiar el período de retención predeterminado.

Nota

Cuando SharePoint se utiliza como fuente de conocimientos, las transcripciones de las conversaciones incluyen la pregunta y el contenido de los documentos de origen utilizados para generar la respuesta (el campo search_results). Sin embargo, la respuesta no está incluida (marcada como REDACTED).

Las transcripciones de las conversaciones no están escritas para:

  • Entornos de Microsoft Dataverse for Teams
  • Entornos de desarrollo de Dataverse
  • Agentes de Microsoft 365 Copilot

Requisito previo

Ver y exportar transcripciones de conversaciones desde el portal de Power Apps

  1. Iniciar sesión en Power Apps.

  2. En el panel de navegación lateral, seleccione Tablas y después seleccione Todo.

    Captura de pantalla del nodo Tablas con Todos seleccionados.

  3. Introduzca "conversación" en el cuadro Búsqueda.

  4. Seleccione la tabla ConversationTranscript.

    Se abre una página para la tabla ConversationTranscript.

  5. En la barra de menú superior, seleccione Exportar>Exportar datos.

    Se tarda unos minutos en compilar los datos para la exportación.

    Captura de pantalla que muestra el menú Exportar con la opción Exportar datos.

  6. Espere un par de minutos a que Power Apps prepare los datos para la exportación y, a continuación, seleccione Descargar datos exportados.

    El archivo se guarda como un archivo ZIP en la ubicación de descarga predeterminada de su navegador.

Comprender transcripciones de conversaciones

La transcripción de la conversación existe como una tabla de Dataverse que puedes descargar como un archivo CSV (valores separados por comas). La lógica que determina cuándo y cómo el sistema registra información en las transcripciones de conversaciones es:

  • El sistema guarda una conversación en un registro de transcripción después de 30 minutos de inactividad. Si la conversación se reanuda después del tiempo de inactividad, el sistema guarda las nuevas actividades en un nuevo registro con el mismo valor Name pero con un nuevo valor ConversationStartTime.
  • Para los agentes publicados en el canal de telefonía, las conversaciones agotan el tiempo de espera de tres minutos después de un evento de finalizar la conversación.
  • Cada registro tiene un límite de 1 MB para la transcripción (en la columna Content). Cuando una transcripción es mayor que este límite, el sistema divide la transcripción en varios registros, todos con los mismos valores Name y ConversationStartTime, pero con valores Metadata.BatchId diferentes.
  • Para fusionar transcripciones, toma todos los registros con los mismos valores de Name y ConversationStartTime, y luego ordena estos registros por BatchId.

La siguiente tabla describe los campos más importantes que encontrará en las transcripciones de sus conversaciones.

Campo Descripción Ejemplo
Content La transcripción completa en formato JSON Consulte Campo de contenido
ConversationStartTime Hora de inicio de la conversación (no la hora a la que se escribió el registro de la transcripción en el almacén de datos) 2021-04-19T20:39:09Z
ConversationTranscript Identificador único de la fila en la tabla de Dataverse 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata JSON que incluye el id. de agente, el id. de inquilino, el nombre del agente y el id. del lote {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name El nombre de la fila personalizada que se crea a partir de ConversationId, seguido por BotId 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript El ID de agente aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on Fecha y hora en que se crea el registro de transcripción 2021-04-20T02:40:13Z

Campo de contenido

El campo Content es un registro sin procesar de todas las actividades que los usuarios tienen con el agente. Los tipos de actividades comunes incluyen mensaje y evento:

  • Las actividades de mensaje representan el contenido que se muestra dentro de una conversación. Las actividades de Mensaje pueden contener texto, voz, tarjetas interactivas y archivos adjuntos binarios o desconocidos.
  • Las actividades de evento comunican información programática de un cliente o canal a un agente.

Para obtener más información sobre los tipos de actividad, consulte el Esquema de actividad del Bot Framework.

La siguiente tabla describe algunos de los campos clave en el JSON de contenido:

Llave Description
ID GUID único del objeto de actividad
valueType El tipo de valor almacenado en la actividad; determina qué información proporciona la actividad (Tipos de valores de actividad comunes)
timestamp Marca de tiempo de cuando se generó la actividad, en formato Epoch (número de segundos desde la medianoche UTC del 1 de enero de 1970)
type El tipo de actividad; por ejemplo, message, event o trace
replyToId El id. de la actividad a la que responde la actividad actual
from Contiene campos id y role:
  • id: id. de la invocadora
  • role: contiene 0 o 1
    • 0: la actividad proviene del agente
    • 1: la actividad proviene del usuario que interactúa con el agente
Notas:
El id se puede utilizar para calcular la cantidad de usuarios activos que interactúan con el agente si el lienzo pasa un id. único del usuario. Si el lienzo no pasa un id., se pasa un id. único por conversación.
Para seguridad y privacidad, el sistema aplica un hash al ID antes de escribirlo en la transcripción.
channelId El Id. del canal donde proviene la actividad; por ejemplo, directline, msteams o facebook
textFormat Formato del texto; por ejemplo, plain o markdown
attachments Datos dinámicos enriquecidos asociados con la actividad; por ejemplo, AdaptiveCards, HeroCards o Carousel data
text Texto para actividades de message
value Campos específicos de la actividad según el tipo de valor; este campo es donde existe la mayor parte de la información útil
channeldata Contiene datos de canal:
  • para mensajes:
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail (contiene el valor asignado a una variable)
    • CurrentMessageDetail
  • para eventos:
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name El nombre de la actividad de evento; por ejemplo, SetPVAContext

Tipos de valores de actividad comunes

Tipo de valor de la actividad Description
ConversationInfo Si la conversación es del panel de prueba de Copilot Studio (isDesignMode) y la configuración regional de la conversación
CSATSurveyRequest Al usuario se le presenta una encuesta de satisfacción del cliente (CSAT)
CSATSurveyResponse El usuario responde a una encuesta CSAT
DialogRedirect El usuario es redirigido a otro tema
ImpliedSuccess El usuario ha llegado a un nodo de preguntas en el tema, donde una de las condiciones apunta al tema del sistema CSAT Éxito confirmado (solo bots clásicos) o llama al tema del sistema de Fin de conversación
IntentRecognition El usuario desencadenó un tema
PRRSurveyRequest Se le preguntó al usuario si el tema respondió a su pregunta del tema Fin de la conversación
PRRSurveyResponse La respuesta del usuario a si el tema respondió a su pregunta del tema Fin de la conversación
SessionInfo El tipo (unengaged o engaged), el resultado (Escalated, Resolved, Abandon), la hora de inicio y finalización de la sesión (startTimeUtc, endTimeUtc) y el recuento de turnos de la sesión
VariableAssignment Se ha asignado un valor a una variable

Transcripciones mejorada

Puedes configurar agentes para generar transcripciones mejoradas que incluyan datos en el nivel de nodo. Estos datos ayudan a rastrear el flujo de una conversación dentro de un tema. Por ejemplo, en un tema de gestión de pedidos, los usuarios pueden elegir entre enviar un nuevo pedido o recuperar uno existente. Los datos en el nivel de nodo permiten analizar el comportamiento del usuario entre estas opciones.

Activa las transcripciones mejoradas

  1. Abra su agente.

  2. Vaya a Configuración>Avanzada.

  3. Selecciona Mejorar transcripciones y luego activa Incluir detalles en el nivel de nodo en las transcripciones.

Captura de pantalla que muestra la página de configuración de Transcripciones mejoradas.

Datos de nivel de nodo

Cuando activas las transcripciones mejoradas, la transcripción incluye un tipo de actividad nodeTraceData para cada nodo que es invocado por un tema. La tabla siguiente describe los campos clave en el valor de actividad nodeTraceData.

Tecla Description
nodeID El identificador del nodo
nodeType El tipo de nodo, por ejemplo, SendActivity o SearchAndSummarizeContent
startTime La marca de tiempo en la que se invocó el nodo
endTime La marca de tiempo en la que el nodo terminó de ejecutarse
topicDisplayName Tema por el que se invoca el nodo

Análisis personalizados

Algunos escenarios, como filtrar conversaciones basándose en una variable personalizada, requieren un enfoque personalizado para la analítica. Para crear soluciones de análisis personalizado, los clientes pueden integrar las transcripciones en bruto en sus flujos de datos o usar un complemento, como el Copilot Studio Kit.

La solución Conversation KPI en Copilot Studio Kit procesa automáticamente las transcripciones y agrega los datos consolidados en las tablas de Dataverse.

Cambiar el período de retención predeterminado

Un trabajo de eliminación masiva de Power Apps quita automáticamente las transcripciones de agentes que tienen más de 30 días de antigüedad. Para mantener las transcripciones por más tiempo, cancele el trabajo existente y cree uno nuevo que se ejecute en un horario diferente.

Nota

Si cambias el periodo de retención predeterminado de Dataverse, solo se ven afectadas las soluciones de analítica personalizada. El periodo de retención de la página de análisis en Copilot Studio no se ve afectado.

Cancelar el trabajo de eliminación masiva existente

  1. En Power Apps, seleccione Configuración>Configuración avanzada.

    El portal de Dynamics 365 se abre en una nueva pestaña.

    Captura de pantalla del menú de configuración de Power Apps con Configuración avanzada resaltado.

  2. Seleccione el símbolo de intercalación junto a Configuración. En Sistema, seleccione Administración de datos.

    Captura de pantalla del menú Configuración, con Administración de datos resaltado.

  3. Seleccione Eliminación de registros en masa.

  4. En la lista Ver, seleccione Trabajos del sistema de eliminación en masa periódicos.

    Captura de pantalla de la lista de trabajos de eliminación masiva recurrentes.

  5. Seleccione el trabajo Eliminación masiva de registros de transcripción de conversación mayores de 1 mes.

    Captura de pantalla de una lista de trabajos de eliminación masiva, con el primero resaltado.

  6. En la lista Más acciones, seleccione Cancelar.

    Captura de pantalla de la lista Más acciones, con Cancelar resaltado.

Crear un nuevo trabajo de eliminación en masa

  1. Seleccione Nuevo para iniciar el Asistente para eliminación en masa. En el asistente, seleccione Siguiente.

  2. Establezca los siguientes criterios de búsqueda:

    • En la lista Buscar, seleccione ConversationTranscripts.
    • Seleccione ConversationStartTime, seleccione Anterior a X meses e introduzca "12".
      Esta configuración conserva las transcripciones durante 12 meses. Elige una comparación y un valor diferentes si lo deseas.
    • Seleccione SchemaType, mantenga Es igual a e introduzca "powervirtualagents".

    Captura de pantalla de la configuración de criterios de búsqueda de empleo de eliminación masiva.

  3. Seleccione Siguiente.

  4. Introduzca un nombre para el trabajo, seleccione Ejecutar este trabajo después de cada y escriba 1. Elija un horario diferente si no desea que el trabajo se ejecute todos los días.

    Captura de pantalla del nombre del trabajo de eliminación y configuración de ejecución.

  5. Seleccione Siguiente y luego seleccione Enviar.

¿Por qué no puedo ver las transcripciones de mis conversaciones en la tabla ConversationTranscript de Power Apps?

Los administradores pueden impedir el guardado de las transcripciones en Dataverse. Para obtener más información sobre cómo se guardan las transcripciones y cómo administrar el acceso, consulte Control transcript access.

Importante

Las transcripciones no se almacenan para los agentes desplegados en entornos de desarrollo.

Recomendaciones para aprovechar al máximo las transcripciones de sus conversaciones

Use variables para almacenar datos relevantes para el contenido de su agente o usuario de agente. Analizar la variable y su valor de la transcripción de la conversación le permite filtrar o dividir los datos según la variable

Las transcripciones de conversaciones pueden referirse al contenido solo por su id. Por ejemplo, en un nodo Redirigir, solo se hace referencia al tema de destino por su ID. Para obtener el nombre de este tema, busque su id. en el contenido del agente.

  • Last updated on