Freigeben über

Ablaufverfolgung und Beobachtbarkeit

DevUI bietet integrierte Unterstützung für das Erfassen und Anzeigen von OpenTelemetry (OTel)-Traces, die vom Agent Framework ausgegeben werden. DevUI erstellt keine eigenen Spannen – es sammelt die Spannen, die das Agent Framework während der Agent- und Workflowausführung ausgibt, und zeigt sie dann im Debug-Panel an. Auf diese Weise können Sie das Verhalten des Agents debuggen, den Ausführungsfluss verstehen und Leistungsprobleme identifizieren.

In Kürze verfügbar

DevUI-Dokumentation für C# wird in Kürze verfügbar sein. Bitte schauen Sie später wieder vorbei, oder lesen Sie die Python-Dokumentation, um konzeptionelle Anleitungen zu erhalten.

Aktivieren der Ablaufverfolgung

Aktivieren Sie Tracing, wenn Sie DevUI mit dem --tracing-Flag starten.

devui ./agents --tracing

Dadurch wird die OpenTelemetry-Ablaufverfolgung für Agent Framework-Vorgänge aktiviert.

Anzeigen von Ablaufverfolgungen in DevUI

Wenn die Ablaufverfolgung aktiviert ist, zeigt die DevUI-Weboberfläche Ablaufverfolgungsinformationen an:

  1. Ausführen eines Agents oder Workflows über die Benutzeroberfläche
  2. Öffnen des Debugbereichs (im Entwicklermodus verfügbar)
  3. Zeigen Sie die Ablaufverfolgungszeitachse an, die Folgendes zeigt:
    • Span-Hierarchie
    • Zeitinformationen
    • Agenten-/Workflow-Ereignisse
    • Toolaufrufe und Ergebnisse

Ablaufverfolgungsstruktur

Agent Framework gibt Traces gemäß den OpenTelemetry-Semantikkonventionen für GenAI aus. Eine typische Ablaufverfolgung umfasst:

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

Für Workflows zeigen Ablaufverfolgungen den Ausführungspfad über Executoren an:

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

Programmgesteuerte Ablaufverfolgung

Bei programmgesteuerter Verwendung von DevUI mit serve() kann die Ablaufverfolgung aktiviert werden.

from agent_framework.devui import serve

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

Integration in externe Tools

DevUI erfasst und zeigt Traces an, die vom Agent-Framework ausgegeben werden – es erstellt keine eigenen Spans. Dies sind standardmäßige OpenTelemetry-Ablaufverfolgungen, die auch in externe Überwachungstools exportiert werden können, z. B.

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog

Um Traces zu einem externen Sammler zu exportieren, legen Sie die OTLP_ENDPOINT Umgebungsvariable fest.

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

Ohne einen OTLP-Endpunkt werden Traces lokal erfasst und nur im Debug-Bereich der DevUI angezeigt.

Weitere Informationen zur Überwachbarkeit des Agent Frameworks:

Nächste Schritte

  • Last updated on