Sdílet prostřednictvím

Trasování a pozorovatelnost

DevUI poskytuje integrovanou podporu pro zachytávání a zobrazování následů OpenTelemetry (OTel) vygenerovaných frameworkem agenta. DevUI nevytváří vlastní rozsahy – shromažďuje rozsahy, které Agent Framework generuje během provádění agenta a pracovního postupu, a poté je zobrazuje v panelu ladění. To vám pomůže ladit chování agenta, porozumět toku provádění a identifikovat problémy s výkonem.

Již brzy

Dokumentace k DevUI pro C# bude brzy k dispozici. Zkontrolujte to prosím později nebo se obraťte na dokumentaci k Pythonu pro konceptuální pokyny.

Povolení trasování

Povolte trasování při spuštění DevUI příznakem --tracing :

devui ./agents --tracing

To umožňuje trasování OpenTelemetry pro operace rozhraní Agent Framework.

Zobrazení trasování v DevUI

Pokud je povolené trasování, webové rozhraní DevUI zobrazí informace o trasování:

  1. Spuštění agenta nebo pracovního postupu prostřednictvím uživatelského rozhraní
  2. Otevření panelu ladění (k dispozici v režimu vývojáře)
  3. Zobrazte časovou osu trasování, která ukazuje:
    • Hierarchie spanů
    • Informace o časování
    • Události agenta nebo pracovního postupu
    • Volání a výsledky nástrojů

Struktura trasování

Agent Framework generuje trasování podle sémantických konvencí OpenTelemetry pro GenAI. Typické trasování zahrnuje:

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

Trasování pracovních postupů zobrazuje cestu provádění přes vykonávače.

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

Programové trasování

Při programovém používání DevUI s serve() je možné povolit trasování:

from agent_framework.devui import serve

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

Integrace s externími nástroji

DevUI zachytává a zobrazuje výstupy generované Agent Frameworkem – nevytváří vlastní úseky. Toto jsou standardní trasování OpenTelemetry, které je možné exportovat také do externích nástrojů pozorovatelnosti, jako jsou:

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog

Pokud chcete exportovat trasování do externího kolektoru, nastavte proměnnou OTLP_ENDPOINT prostředí:

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

Bez koncového bodu OTLP jsou trasové údaje zachyceny místně a zobrazují se pouze na panelu ladění DevUI.

Další podrobnosti o pozorovatelnosti agenta Framework:

Další kroky

  • Last updated on