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.
En este artículo se describe cómo puede capturar datos de telemetría del agente de Copilot Studio para su uso en Azure Application Insights.
Además de las características de análisis nativas 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 de administración del rendimiento de aplicaciones (APM) que permite supervisar las aplicaciones en directo. Requiere una suscripción para Microsoft Azure.
Conexión del 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.
Vaya a la página Configuración para su agente y seleccione Avanzado.
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 el connection string.
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 Logs del 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 sencilla 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 se producen 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 Microsoft Copilot Studio documentación de vista previa y está sujeto a cambios.
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 va a crear un agente listo para producción, consulte Microsoft Copilot Studio Overview.
La vista del panel de Copilot Studio utiliza señales de Azure Monitor Application Insights, consultándolas a través de Azure Workbooks y creando 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:
- Vaya a la aplicación Application Insights.
- Seleccione la pestaña Supervisión en el panel de navegación izquierdo.
- En la pestaña Monitoring, seleccione Workbooks y abra Copilot Studio Dashboard desde 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.
Seleccione Editar en la barra de comandos.
Modifique los elementos según sea necesario para su caso de uso. Selecciona los tres puntos (...) para editar, añadir, mover, redimensionar, clonar o eliminar un elemento. Por ejemplo, puedes añadir una casilla usando KQL para rastrear un atributo personalizado que estás recogiendo y que nuestra vista integrada no muestra.
Guarde los cambios más recientes y cree vistas diferentes según sea necesario seleccionando Guardar.
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.
