Compartir a través de

Seguimiento y observabilidad

DevUI proporciona compatibilidad integrada para capturar y mostrar seguimientos de OpenTelemetry (OTel) emitidos por Agent Framework. DevUI no crea sus propios intervalos: recopila los intervalos que emite Agent Framework durante la ejecución del agente y del flujo de trabajo y, a continuación, los muestra en el panel de depuración. Esto le ayuda a depurar el comportamiento del agente, comprender el flujo de ejecución e identificar problemas de rendimiento.

Próximamente.

La documentación de DevUI para C# estará disponible próximamente. Por favor, vuelva a comprobar más tarde o consulte la documentación de Python para obtener instrucciones conceptuales.

Habilitación del seguimiento

Habilite el seguimiento al iniciar DevUI con la --tracing marca :

devui ./agents --tracing

Esto habilita el seguimiento de OpenTelemetry para las operaciones de Agent Framework.

Visualizando los rastros en DevUI

Cuando se habilita el seguimiento, la interfaz web de DevUI muestra información de seguimiento:

  1. Ejecución de un agente o flujo de trabajo a través de la interfaz de usuario
  2. Abra el panel de depuración (disponible en modo de desarrollador)
  3. Vea la escala de tiempo de seguimiento que muestra:
    • Jerarquía de intervalos
    • Información de tiempo
    • Eventos de agentes y flujos de trabajo
    • Llamadas de herramientas y resultados

Estructura de seguimiento

Agent Framework emite rastros siguiendo las convenciones semánticas de OpenTelemetry para GenAI. Un seguimiento típico incluye:

Agent Execution
    LLM Call
        Prompt
        Response
    Tool Call
        Tool Execution
        Tool Result
    LLM Call
        Prompt
        Response

En los flujos de trabajo, los seguimientos muestran la ruta de ejecución a través de los ejecutores.

Workflow Execution
    Executor A
        Agent Execution
            ...
    Executor B
        Agent Execution
            ...

Seguimiento mediante programación

Cuando se usa DevUI mediante programación con serve(), se puede habilitar el seguimiento:

from agent_framework.devui import serve

serve(
    entities=[agent],
    tracing_enabled=True
)

Integración con herramientas externas

DevUI captura y muestra trazas emitidas por el Framework del Agente, no crea sus propios tramos. Estos son seguimientos de OpenTelemetry estándar que también se pueden exportar a herramientas de observabilidad externa como:

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog

Para exportar seguimientos a un recopilador externo, establezca la OTLP_ENDPOINT variable de entorno:

export OTLP_ENDPOINT="http://localhost:4317"
devui ./agents --tracing

Sin un punto de conexión OTLP, las trazas se capturan localmente y se muestran solo en el panel de depuración de DevUI.

Para obtener más información sobre la observabilidad de Agent Framework:

Pasos siguientes

  • Last updated on