Telemetría a nivel de agente con Application Insights

Este artículo explica cómo capturar datos de telemetría a nivel de agente de tu agente de Copilot Studio para usarlos en Aplicación de Azure Insights.

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.

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

2. 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.

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

   • Habilitar el registro: si está activado, el sistema registra los detalles de los eventos y mensajes entrantes y salientes.

   • Detalles de la conversación de registro: incluye el identificador de usuario, el nombre de usuario y el texto del mensaje (para las actividades de mensaje). Cuando se habilita el seguimiento de OpenTelemetry, esta configuración también controla los argumentos de entrada de la herramienta y los resultados de salida de la herramienta capturados en intervalos.

   • Registrar propiedades confidenciales de Activity: Si se activa, los registros incluyen los valores de determinadas propiedades que podrían considerarse confidenciales en los mensajes y eventos entrantes y salientes.

   • Eventos de ejecución de nodos: registre un evento cada vez que se ejecuta un nodo dentro de un tema.

Analizar la telemetría del bot mediante Application Insights

Después de conectar tu agente a Application Insights, este registra los datos de telemetría cuando los usuarios interactúan con el agente, incluso durante las pruebas dentro de Copilot Studio. Para ver los datos de telemetría registrados, ve a la sección de Logs de tu recurso Application Insights en Azure. Aquí, puedes usar consultas Kusto para consultar y analizar tus datos. Aprende más en 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

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.

Ver resultados de monitorización (vista previa)

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:

1. Vaya al recurso de Application Insights.
2. Seleccione la pestaña Supervisión en el panel de navegación izquierdo.
3. 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.

1. Seleccione Editar en la barra de comandos.

   

2. 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.

   

3. Seleccione Guardar para guardar los cambios más recientes y crear vistas diferentes según sea necesario.

   

4. Seleccione el icono Compartir de la barra de comandos para compartir con el equipo.

   Note

   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.

   

Desactivar la telemetría Application Insights a nivel de agente

Para evitar que los creadores habiliten la telemetría de Application Insights a nivel de agente, bloquea el Application Insights en el conector de Copilot Studio mediante una política de datos en el centro de administración de Power Platform.

Antes de empezar, asegúrese de que tiene lo siguiente:

• Administrador de Power Platform o administrador de Dynamics 365 a nivel de inquilino en Microsoft Entra ID.
• Acceso al entorno objetivo donde se despliegan los agentes de Copilot Studio.

Para desactivar la telemetría a nivel de agente de Application Insights, sigue estos pasos:

1. En el centro de administración de Power Platform, selecciona Seguridad en el panel izquierdo, selecciona Datos y privacidad, y luego política de Datos.
2. Crea una nueva política de datos o edita una política existente.
3. Selecciona los entornos a los que debe aplicarse la política y selecciona Añadir a la política.
4. En el paso de Conectores (nueva política) o Conectores Preconstruidos (política existente), busca Application Insights en Copilot Studio y seleccionarlo.
5. Selecciona Bloque para mover Application Insights en Copilot Studio al grupo de conectores bloqueados.
6. Completar los pasos restantes de configuración de la política y publicar la política.

Cuando se aplica la política de datos, el conector Application Insights en Copilot Studio queda bloqueado para los entornos objetivo. Los usuarios y creadores no pueden usar este conector en entornos regulados por la política.

Información relacionada

• Visión general de Telemetría con Application Insights
• Telemetría a nivel de entorno con Application Insights (vista previa)
• Exportar datos a Application Insights