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 explica cómo capturar datos de telemetría del agente de Copilot Studio para su uso en Aplicación de Azure 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 desencadenan durante las conversaciones del usuario
- Eventos de telemetría personalizados que puede 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 puede usar para 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, agregue primero la clave de instrumentación a la configuración del agente.
Vaya a la página Configuración para su agente y seleccione Avanzado.
En la sección Application Insights , escriba la cadena de conexión. Para obtener información sobre cómo localizar el cadena de conexión, consulte la documentación de Azure Monitor.
De manera opcional, puede optar por habilitar una de las opciones siguientes:
Actividades de registro: si está habilitada, el sistema registra los detalles de los mensajes y eventos entrantes y salientes.
Propiedades de actividad confidenciales del registro: si está habilitada, los registros incluyen los valores de determinadas propiedades que podrían considerarse confidenciales en los mensajes y eventos entrantes y salientes. Las propiedades que se consideran potencialmente confidenciales son
userid,name,textyspeak(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, registra los datos de telemetría cuando los usuarios interactúan con el bot, incluido durante las pruebas dentro de 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 restringir aún más los resultados, entre los que se incluyen:
- Agregar un intervalo de tiempo
- Extensión de los resultados mediante dimensiones personalizadas. Las dimensiones personalizadas son propiedades personalizadas que se registran junto con los campos creados previamente, como la marca de tiempo o el nombre del evento.
- Adición de 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 consulta de ejemplo siguiente da como resultado un gráfico de líneas que muestra cuántos usuarios distintos se comunicaron con el bot al 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 en todas 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.
Excluir la telemetría de las conversaciones de prueba en tus 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 las pruebas, extienda la consulta mediante la designMode dimensión personalizada que capturan todos los eventos y use una cláusula where en la 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 | Description | Valores de ejemplo |
|---|---|---|
| type | 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 |
| configuración regional | 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 |
| text | 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 funciones de vista previa no están diseñadas para un 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 provenientes de Azure Monitor Application Insights. Consulta Application Insights a través de Azure Workbooks y crea visualizaciones.
Estas vistas proporcionan 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.
Para acceder y usar la vista de supervisión integrada en Application Insights, siga estos pasos:
- Vaya al recurso de Application Insights.
- Seleccione la pestaña Supervisión en el panel de navegación izquierdo.
- En la pestaña Supervisión, seleccione Cuadernos. Abra Copilot Studio Dashboard desde la galería de libros de trabajo.
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 se abre como un libro de trabajo editable donde puede personalizar el libro de trabajo y guardarlo de acuerdo a 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, puede agregar un mosaico que use KQL para realizar un seguimiento de un atributo personalizado que está recopilando que no se muestra en la vista integrada.
Seleccione Guardar para guardar los cambios más recientes y crear vistas diferentes según sea necesario.
Seleccione el icono Compartir de la barra de comandos para compartir con el equipo.
Nota
Al compartir este libro con los miembros del equipo, estos deben tener al menos el rol de lector en el recurso de Application Insights conectado para poder ver la información mostrada.
