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.
Importante
Los elementos marcados (versión preliminar) de este artículo se encuentran actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin acuerdo de nivel de servicio y no se recomienda para las cargas de trabajo de producción. Es posible que algunas características no se admitan o que tengan funcionalidades restringidas. Para más información, consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure.
Reproducción de seguimiento en Microsoft Foundry permite inspeccionar, navegar y analizar seguimientos de conversación de las ejecuciones del agente. Se puede acceder a ella desde cualquier página que haga referencia a un identificador de conversación o a un identificador de seguimiento. Las trazas se pueden visualizar como una vista Usuario para revisar la perspectiva del usuario sobre las interacciones del agente, o como una vista Trayectorias para comprender la jerarquía de tramos y la temporización. Estas vistas, combinadas con controles interactivos de reproducción y filtrado, le ayudan a comprender el flujo de ejecución, identificar cuellos de botella y solucionar problemas.
Prerrequisitos
- Un proyecto Foundry con al menos un agente.
- Datos de rastreo recopilados para el agente de destino. Si aún no ha configurado el seguimiento, consulte Configurar el seguimiento en Microsoft Foundry.
- Acceso al recurso de Application Insights conectado al proyecto. Para obtener información general, consulte Azure Monitor Application Insights.
- Un rol de lector de Log Analytics para ver seguimientos, conclusiones y visualizaciones en Foundry.
Casos de uso
| Escenario | Cómo ayuda Trace Replay |
|---|---|
| Análisis de la causa raíz | Identifique rápidamente errores o cuellos de botella en las conversaciones del agente. |
| Optimización del uso de tokens | Detecte intervalos con un alto consumo de tokens para optimizar las indicaciones del agente y reducir costes. |
| Depuración | Reproducir la ejecución paso a paso para comprender los errores o comportamientos inesperados. |
| Reconstrucción de la conversación | Visualice todo el flujo de conversación para auditorías o revisiones. |
Abrir el panel de reproducción
- Inicie sesión en Microsoft Foundry.
- Vaya a la página Seguimientos de su agente.
- Seleccione un identificador de conversación o un identificador de seguimiento para abrir el panel de reproducción.
Se abre el Panel de reproducción, en el que se muestra la vista Trayectorias de forma predeterminada.
Explora las vistas del panel de reproducción
El panel de repetición proporciona dos vistas complementarias de una traza. Para cambiar entre ellos, seleccione la pestaña Trayectorias o Usuario en la parte superior del Panel de reproducción.
En ambas vistas, puede seleccionar cualquier intervalo para inspeccionar el paso en el bucle del agente, incluidas las invocaciones de LLM, la ejecución de herramientas, las solicitudes del usuario, las orquestaciones y respuestas del subagente. También puede ver metadatos sin procesar como JSON y ver los resultados de las evaluaciones que se ejecutaron como parte de esta conversación.
Vista de trayectorias
La vista Trayectorias representa el seguimiento como un árbol jerárquico, en el que se muestran todos los pasos de la interacción del usuario y del agente, incluido el razonamiento del agente, las llamadas a herramientas y los turnos de conversación. Cada tramo muestra una barra en cascada que puede medirse por duración o por coste por token, lo que facilita comparar el coste relativo de cada paso.
Esta vista es más útil para identificar posibles errores agenteicos, como errores, alucinaciones y interacciones anómalamente largas o costosas.
Vista de usuario
La vista Usuario presenta el seguimiento como una visualización basada en chat de las interacciones entre el usuario y el agente, lo que refleja lo que habría experimentado el usuario final. Un panel de árbol de intervalos contraíble permanece accesible junto con el chat, por lo que puede hacer referencia cruzada a la jerarquía de intervalos subyacente sin salir de esta vista.
Filtrar seguimientos
- En el Panel de reproducción, seleccione el control Filtro .
- Elija uno o varios tipos de intervalos de la lista para acotar el seguimiento.
El árbol de intervalos se actualiza para mostrar solo los intervalos que coinciden con los tipos seleccionados.
| Filter | Espectáculos / Programas |
|---|---|
| Chat | Intervalos específicos del chat en el seguimiento |
| Agent | Invocación del agente |
| Tool | Todas las ejecuciones de herramientas que se produjeron durante el seguimiento |
| Conversación | Intervalos específicos de la conversación en el seguimiento |
Para buscar por nombre de tramo, introduzca texto en el campo Buscar en la traza.
Filtrado por consumo de tokens
Filtre los intervalos por nivel de uso de tokens para identificar puntos conflictivos o valores atípicos.
| Level | Description |
|---|---|
| Bajo | Menos de 500 tokens |
| Medio | Entre 500 y 2 mil tokens |
| High | Más de 2 000 tokens, útiles para identificar valores atípicos en el bucle de seguimiento |
Reproducir una conversación
El control Playthrough vuelve a reproducir toda la conversación de forma secuencial, manteniendo sincronizadas la vista de trayectorias, la vista de usuario y el panel de detalles del segmento a medida que se resalta cada paso.
Seleccione Reproducir en el control Playthrough situado en la parte inferior del Panel de reproducción.
Use los controles de reproducción según sea necesario:
- Omita los intervalos en cualquier momento para avanzar en la interacción.
- Ajustar la velocidad de reproducción (por ejemplo, 1x, 2x o 4x) para recorrer trazas largas más rápidamente.
- Desplácese hasta cualquier punto del seguimiento utilizando la limpieza de línea de tiempo para ir directamente a un momento específico sin reproducirlo desde el principio.
El Panel de reproducción resalta cada intervalo en secuencia en la vista Trayectorias y en el panel de detalles del intervalo.
Troubleshoot
| Síntoma | Resolution |
|---|---|
| El identificador de conversación o el identificador de seguimiento no están visibles | El seguimiento no está configurado para este agente. Consulte Configurar el seguimiento en Microsoft Foundry. |
| Se carga el Panel de reproducción, pero no muestra intervalos | Es posible que el seguimiento todavía se esté procesando. Espere unos minutos y actualice la página. |
| El control Playthrough no está disponible | Playthrough requiere dos o más intervalos. Los seguimientos de un solo intervalo no se pueden reproducir secuencialmente. |
| Filtro aplicado, pero no hay intervalos visibles | El tipo de filtro seleccionado no aparece en esta traza. Borre el filtro e intente un tipo de intervalo más amplio o compruebe que el agente usa la funcionalidad filtrada. |