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.
Note
El seguimiento se encuentra actualmente en versión preliminar.
En este inicio rápido, verá los seguimientos de un extremo a otro para el agente hospedado que implementó en Implementación del primer agente hospedado. Invoque a su agente para generar datos de trazas y revisar las trazas en el portal de Foundry.
Las bibliotecas de hospedaje (azure-ai-agentserver-responses y azure-ai-agentserver-invocations) integran sin problemas la distribución de OpenTelemetry de Microsoft, que proporciona instrumentación integrada para Microsoft Agent Framework y LangChain, y exporta seguimientos a Application Insights. Además, Foundry Agent Service emite datos de telemetría del lado servidor para la invocación del agente automáticamente, no se requiere ningún cambio de código.
El seguimiento proporciona visibilidad sobre cómo controla el agente cada solicitud para que pueda depurar problemas, supervisar la latencia y comprender el comportamiento del agente antes de publicar cambios en los usuarios.
Prerequisites
Antes de comenzar, necesita lo siguiente:
Un agente alojado ya implementado y que se puede invocar desde Implementa tu primer agente alojado, y el directorio del proyecto
azdque creó en esta guía de inicio rápido.El rol Usuario de Foundry en el recurso Foundry.
Para usar la ruta de acceso de la interfaz de usuario, acceda al portal de Foundry. Para conocer la ruta de azd, consulte los requisitos siguientes.
Azure CLI para desarrolladores (azd) 1.27.1 o posterior con la
azd microsoft.foundryextensión :azd ext install microsoft.foundryUna sesión autenticada
azd. Compruebe el estado conazd auth statusy ejecuteazd auth loginsi no ha iniciado sesión.Importante
Recientemente se cambió el nombre de los roles RBAC de Foundry. Foundry User, Foundry Owner, Foundry Account Owner y Foundry Project Manager se llamaban anteriormente Usuario de Azure AI, Propietario de Azure AI, Propietario de la cuenta de Azure AI y Administrador de proyectos de Azure AI. Es posible que siga viendo los nombres anteriores en algunos lugares mientras se implementa el cambio de nombre. El cambio de nombre no modifica los identificadores de rol y los permisos principales.
Un recurso de Azure Monitor Application Insights conectado con tu proyecto de Foundry. Para configurarlo, consulte Configuración del seguimiento en Microsoft Foundry.
Rol lector de Log Analytics en el recurso de Application Insights conectado al proyecto. Si las tablas subyacentes de Log Analytics están protegidas, asigne también el rol Lector de datos de supervisión privilegiados.
Paso 1: Invoque a su agente
Genere datos de seguimiento mediante el envío de una solicitud al agente implementado.
Desde el azd directorio del proyecto, envíe un mensaje de prueba:
azd ai agent invoke "Summarize the benefits of distributed tracing for AI agents."
Debería ver una respuesta en unos segundos.
Cada invocación genera una traza completa. Para obtener trazas más completas, envíe prompts que desencadenen llamadas a herramientas o razonamiento en varios turnos.
Paso 2: Ver trazas en el portal de Foundry
Las trazas se pueden ver en el portal de Foundry tras la invocación.
- En el portal de Foundry, abra el proyecto.
- En el panel de navegación izquierdo, seleccione Agentes.
- En la parte superior, seleccione Trazas.
- Busque la pista en la lista. Puede buscar por id. de seguimiento, id. de respuesta o filtrar por intervalo de tiempo.
Trayectoria
Vista de usuario
Tip
Si el agente usa Microsoft Agent Framework, emite automáticamente sus propios intervalos de OpenTelemetry. Estos tramos aparecen como tramos secundarios de los tramos de la capa de alojamiento, lo que le proporciona un árbol de trazas completo desde la solicitud HTTP, pasando por la orquestación del agente, hasta las llamadas a herramientas individuales y las interacciones con el LLM.
Limpieza de recursos
Los datos de seguimiento se almacenan en Application Insights y siguen la configuración de retención de datos del área de trabajo. En este inicio rápido no se crean recursos adicionales. Para limpiar el inicio rápido anterior, ejecute azd down desde el directorio del proyecto del agente. Lo que elimina el comando depende de si la inicialización creada o reutilizada del proyecto Foundry.
Advertencia
Si el entorno actual azd creó el proyecto Foundry, azd down elimina permanentemente el grupo de recursos del proyecto y todo lo que contiene. Si seleccionó un proyecto existente durante la inicialización, deja el proyecto, azd down su grupo de recursos, el agente hospedado y otros recursos de inicio rápido. Para eliminar los recursos que ya no necesite del proyecto existente, elimínelos por separado.
Troubleshooting
| Problema | Solución |
|---|---|
| No se utilizan agentes hospedados en Foundry y no se muestran los rastros | Esta guía de inicio rápido se centra únicamente en los agentes alojados. Para los agentes de seguimiento hospedados fuera de Foundry, consulte Registro de un agente externo. |
| No aparecen trazas tras invocar al agente | Confirme que Application Insights está conectado al proyecto foundry. Si no está habilitado, consulte Configurar el seguimiento en Microsoft Foundry. Compruebe que el agente respondió correctamente con azd ai agent invoke. |
| Los rastros aparecen, pero a los tramos les faltan atributos de datos de entrada/salida | Habilite la grabación de contenido estableciendo la variable OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true de entorno en la configuración del agente. |
AuthorizationFailed al visualizar trazas |
Necesita el rol lector de Log Analytics en el recurso de Application Insights. Si las tablas están protegidas, asigne también lector de datos de supervisión con privilegios. |
| Aparecen seguimientos, pero faltan intervalos de llamadas a herramientas | Compruebe que el agente define las herramientas y el modelo los invoca durante la solicitud. Si usa Microsoft Agent Framework, confirme que las herramientas se registran con el Agent constructor a través del tools parámetro . Vea Agregar herramientas a su agente. |
AuthenticationError o DefaultAzureCredential fallo |
Actualice las credenciales con azd auth logout y, a continuación, azd auth login. |
Lo que ha aprendido
En esta guía de inicio rápido:
- Descubrió que las bibliotecas de hospedaje integran la distribución de OpenTelemetry de Microsoft para ofrecer instrumentación lista para usar.
- Invocó al agente implementado para generar datos de seguimiento.
- Se han visto trazas de extremo a extremo en el portal de Foundry.
Pasos siguientes
- Configure el seguimiento en Microsoft Foundry para una configuración de seguimiento detallada.
- Configura el trazado para frameworks de agentes de IA para instrumentar LangChain y otros frameworks.
- Supervise los agentes de inteligencia artificial con el panel de supervisión del agente para la supervisión de producción.