Condividi tramite

Traccia e osservabilità

DevUI offre il supporto predefinito per l'acquisizione e la visualizzazione di tracce OpenTelemetry (OTel) generate da Agent Framework. DevUI non crea intervalli specifici: raccoglie gli intervalli generati da Agent Framework durante l'esecuzione dell'agente e del flusso di lavoro, quindi li visualizza nel pannello di debug. In questo modo è possibile eseguire il debug del comportamento dell'agente, comprendere il flusso di esecuzione e identificare i problemi di prestazioni.

Prossimamente

La documentazione di DevUI per C# sarà presto disponibile. Si prega di controllare più tardi o fare riferimento alla documentazione di Python per indicazioni concettuali.

Abilitazione del tracciamento

Abilitare la traccia all'avvio di DevUI con il --tracing flag :

devui ./agents --tracing

In questo modo viene abilitata la traccia OpenTelemetry per le operazioni di Agent Framework.

Visualizzazione di tracce in DevUI

Quando la traccia è abilitata, l'interfaccia Web DevUI visualizza le informazioni di traccia:

  1. Eseguire un agente o un flusso di lavoro tramite l'interfaccia utente
  2. Aprire il pannello di debug (disponibile in modalità sviluppatore)
  3. Visualizzare la sequenza temporale della traccia che mostra:
    • Gerarchia di intervalli
    • Informazioni sulla tempistica
    • Eventi di agente/processo
    • Chiamate e risultati degli strumenti

Struttura di traccia

Agent Framework genera tracce seguendo le convenzioni semantiche OpenTelemetry per GenAI. Una traccia tipica include:

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

Per i flussi di lavoro, le tracce mostrano il percorso di esecuzione tramite executor:

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

Tracciamento programmatico

Quando si usa DevUI a livello di codice con serve(), è possibile abilitare la traccia:

from agent_framework.devui import serve

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

Integrazione con strumenti esterni

DevUI acquisisce e visualizza tracce generate da Agent Framework. Non crea intervalli specifici. Si tratta di tracce OpenTelemetry standard che possono essere esportate anche in strumenti di osservabilità esterni come:

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog

Per esportare tracce in un collettore esterno, impostare la OTLP_ENDPOINT Variabile di ambiente:

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

Senza un endpoint OTLP, le tracce vengono acquisite localmente e visualizzate solo nel pannello di debug devUI.

Per altri dettagli sull'osservabilità di Agent Framework:

Passaggi successivi

  • Last updated on