Traccia e osservabilità

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
• Monitoraggio di Azure
• 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.