Capturar telemetría con Application Insights

En este artículo se analiza cómo puede capturar datos de telemetría de su agente de Copilot Studio para su uso en Azure Application Insights.

Además de las característica de análisis nativas dentro de Copilot Studio, puede enviar datos de telemetría a Application Insights. La telemetría ofrece información sobre su agente mediante el seguimiento:

• Mensajes y eventos registrados enviados desde y hacia su agente
• Temas que se desencadenarán durante las conversaciones de los usuarios
• Eventos de telemetría personalizados que se pueden enviar desde sus temas

Importante

Application Insights es una característica de Azure Monitor, una herramienta extensible Application Performance Management (APM) que le permite monitorear sus aplicaciones en vivo. Requiere una suscripción a Microsoft Azure.

Conectar el agente de Copilot Studio a Application Insights

Para conectar el agente a Application Insights, primero debe agregar su clave de instrumentación a la configuración de su agente.

1. Vaya a la página Configuración para su agente y seleccione Avanzado.

2. En la sección Application Insights, rellene la configuración Cadena de conexión. Consulte la Documentación de Azure Monitor para averiguar cómo localizar su cadena de conexión.

3. De manera opcional, puede optar por habilitar una de las opciones siguientes:

   • Registrar actividades: si está habilitada, se registran los detalles de los mensajes y eventos entrantes y salientes.

   • Registrar propiedades de actividad confidenciales: si está habilitada, los valores de determinadas propiedades que podrían considerarse confidenciales en los mensajes y eventos entrantes/salientes se incluyen en los registros. Las propiedades que se consideran potencialmente confidenciales son userid, name, text y speak (las propiedades text y speak solo se aplican a los mensajes).

Analizar la telemetría del bot mediante Application Insights

Después de conectar el bot a Application Insights, los datos de telemetría se registran cuando los usuarios interactúan con el bot, incluido durante las pruebas en Copilot Studio. Para ver los datos de telemetría registrados, vaya a la sección Registros de su recurso de Application Insights en Azure.

Desde aquí, puede usar Consultas de Kusto para consultar y analizar sus datos. Vea las consultas de ejemplo.

Consultas de ejemplo

Una consulta puede ser tan simple como especificar una sola tabla, como customEvents, que muestra todos los eventos de telemetría personalizados registrados desde Copilot Studio. Pero también puede usar Consultas de Kusto para reducir aún más los resultados, incluidos;

• Agregar un intervalo de tiempo
• Extender sus resultados mediante dimensiones personalizadas. Las dimensiones personalizadas son propiedades personalizadas que se registran, junto con los campos prediseñados, como la marca de tiempo o el nombre del evento.
• Una cláusula where para limitar los datos devueltos en función de una condición
• Usar más funciones integradas de Kusto para determinar qué y cómo se muestra la información

La siguiente consulta de ejemplo da como resultado un gráfico de líneas que muestra cuántos usuarios distintos se comunicaron con su bot por día durante los últimos 14 días.

let queryStartDate = ago(14d);
let queryEndDate = now();
let groupByInterval = 1d;
customEvents
| where timestamp > queryStartDate
| where timestamp < queryEndDate
| summarize uc=dcount(user_Id) by bin(timestamp, groupByInterval)
| render timechart

Importante

Los datos dentro de algunos campos varían y son más o menos aplicables, según el canal que se esté utilizando. Por ejemplo, solo se obtiene un recuento correcto de usuarios únicos en la consulta si los usuarios se autentican y sus identificadores de usuario son coherentes entre las conversaciones. En escenarios anónimos en los que se genera un identificador de usuario aleatorio en cada conversación, el campo id. de usuario es menos útil.

Exclusión de telemetría de las conversaciones de prueba de sus consultas

El bot registra la telemetría de todas las conversaciones, incluidas las que tienen lugar en Copilot Studio durante las pruebas. Si desea excluir la telemetría recopilada durante la prueba, puede ampliar su consulta con la dimensión personalizada de designMode que se captura en todos los eventos y usar la cláusula where en su consulta.

En el siguiente ejemplo se muestran todos los eventos personalizados, excepto los capturados a través del lienzo de prueba.

customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"

Dimensiones personalizadas

Gran parte de los datos de actividad específicos recibidos de Copilot Studio se almacenan en el campo customDimensions. Puede ver cómo se usa un campo de dimensión personalizado en una consulta para excluir la telemetría de las conversaciones de prueba.

Campo	Descripción	Valores de ejemplo
tipo	Tipo de actividad	message, conversationUpdate, , event, invoke
channelId	Identificador del canal	emulator, directline, , msteams, webchat
fromId	Identificador de origen	<id>
fromName	Nombre de usuario del cliente	John Bonham, Keith Moon, , Steve Smith, Steve Gadd
locale	Configuración regional de origen del cliente	en-us, zh-cn, en-GB, , de-de, zh-CN
recipientId	Identificador del destinatario	<id>
recipientName	Nombre del destinatario	John Bonham, Keith Moon, , Steve Smith, Steve Gadd
texto	Texto del mensaje	find a coffee shop
designMode	La conversación tuvo lugar dentro del lienzo de prueba	True / False

Visualización de los resultados de la supervisión (versión preliminar)

Importante

Este artículo contiene la documentación de la versión preliminar de Microsoft Copilot Studio y está sujeto a modificaciones.

Las características en versión preliminar no están pensadas para su uso en producción y pueden tener funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que pueda tener acceso anticipado y proporcionar comentarios.

Si está creando un agente listo para producción, consulte Información general sobre Microsoft Copilot Studio.

La vista del panel de Copilot Studio utiliza señales de Application Insights de Azure Monitor, las consulta mediante Azure Workbooks y crea visualizaciones.

Estas vistas están diseñadas para incorporar métricas clave, como conversaciones totales, latencia, excepciones, uso de herramientas y análisis de temas en una sola vista. La vista única proporciona a los equipos transparencia para que puedan realizar un seguimiento del estado operativo y la calidad, comprender las tendencias y evaluar continuamente para mejorar su aplicación.

Siga estos pasos para acceder y usar la vista de supervisión integrada en Application Insights:

1. Vaya a la aplicación Application Insights.
2. Seleccione la pestaña Supervisión en el panel de navegación izquierdo.
3. En la pestaña Supervisión, seleccione Libros de trabajo y abra el Panel de Copilot Studio en la galería de libros.

Personalización y uso compartido del panel

Application Insights es una herramienta eficaz para la supervisión del rendimiento de las aplicaciones (APM) que proporciona información sobre el estado y el rendimiento de las aplicaciones.

El tablero de control se abre como un libro de trabajo editable donde puede personalizar el libro de trabajo y guardar según sus necesidades.

1. Seleccione Editar en la barra de comandos.

1. Modifique los elementos según sea necesario para su caso de uso. Seleccione ... en un elemento para editar, agregar, mover o cambiar el tamaño, clonar o quitar. Por ejemplo, puede agregar un icono mediante KQL para realizar un seguimiento de un atributo personalizado que está recopilando que no se muestra en nuestra vista integrada.

1. Guarde los cambios más recientes y cree vistas diferentes según sea necesario seleccionando Guardar.

1. Para compartir con el equipo, seleccione el icono Compartir de la barra de comandos.

Nota:

Al compartir este libro de trabajo con los miembros del equipo, deben tener al menos el rol Lector para el recurso de Application Insights conectado para ver la información mostrada.