Compartir a través de

Descargar transcripciones de conversaciones en Power Apps

Puede ver, exportar y descargar transcripciones de las interacciones de los clientes con su agente en Power Apps y 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

Las respuestas de los agentes que utilizan SharePoint como fuente de conocimiento no se incluyen en las transcripciones de las conversaciones.

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. Inicie sesión en Power Apps.

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

    Captura de pantalla que muestra Todo seleccionado en el nodo Tablas.

  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.

    Compilar los datos para la exportación requiere unos minutos.

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

  6. Espere un par de minutos para 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.

Entender las transcripciones de conversaciones

La transcripción de la conversación es un archivo CSV (valores separados por comas). 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 identificador de agente, el identificador de inquilino y el nombre del agente {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot"}
Name El nombre de la fila personalizada que se crea a partir de ConversationId, seguido por BotId, seguido por un batch number. El número de lote indica el orden cuando hay varias sesiones analíticas para la conversación. Los bots clásicos no incluyen el número de lote. 8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0
Bot_ConversationTranscript El ID de agente aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on Fecha y hora en que se creó 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 Descripción
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.
Por seguridad y privacidad, el id. tiene un hash antes de escribirse en la transcripción por razones de seguridad y privacidad.
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 Descripción
ConversationInfo Si la conversación es del panel de prueba de Copilot Studio (isDesignMode) y el idioma 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 de É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

Los agentes se pueden configurar para generar transcripciones mejoradas que incluyan datos a nivel de nodo. Estos datos ayudan a realizar un seguimiento del 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 de nivel de nodo permiten analizar el comportamiento del usuario en estas opciones.

Activar transcripciones mejoradas

  1. Abre tu agente.

  2. Vaya a Configuración>Avanzada.

  3. Seleccione Mejorar transcripciones y, a continuación, active Incluir detalles a nivel de nodo en las transcripciones.

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

Datos a nivel de nodo

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

Llave Descripción
nodeID El identificador del nodo
nodeType El tipo de nodo, por ejemplo, SendActivity o SearchAndSummarizeContent
startTime Marca de tiempo en la que se invocó el nodo
endTime Marca de tiempo cuando el nodo terminó de ejecutarse
topicDisplayName Tema por el que se invoca el nodo

Análisis personalizados

Algunos escenarios, como el filtrado de conversaciones en función de una variable personalizada, requieren un enfoque personalizado para el análisis. Los clientes que crean soluciones de análisis personalizadas pueden ingerir las transcripciones sin procesar en sus canalizaciones de datos o usar un complemento, como el Kit de Copilot Studio

La solución de KPI de conversación dentro del kit de Copilot Studio analiza automáticamente las transcripciones y completa los datos agregados en tablas Dataverse.

Cambiar el período de retención predeterminado

Un trabajo de eliminación masiva de Power Apps elimina automáticamente las transcripciones de agente que tengan 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.

Cancelar el trabajo de eliminación masiva existente

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

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

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

  2. Seleccione el signo de intercalación junto a Ajustes y luego, debajo de Sistema, seleccione Gestió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. Para iniciar el Asistente para eliminación en masa, seleccione Nuevo y, a continuación, 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. Elija una comparación y un valor diferentes si lo desea.
    • Seleccione SchemaType, deje igual e ingrese "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 mis transcripciones de conversación en la tabla de Power Apps ConversationTranscript?

Los administradores pueden impedir que se guarden las transcripciones en Dataverse. Para obtener más detalles sobre cómo se guardan las transcripciones y cómo administrar el acceso, consulte Controlar el acceso a las transcripciones.

Importante

Las transcripciones no se almacenan para los agentes implementados en entornos de desarrollador.

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

Las variables se pueden usar 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.