共用方式為

追蹤與可觀察性

DevUI 內建支持捕捉和顯示由代理框架發出的 OpenTelemetry（OTel）追蹤。 DevUI 不會自行建立 span，而是收集 Agent Framework 在執行代理和工作流程時所發出的 span，然後在偵錯面板中顯示。 這有助於你除錯代理行為、理解執行流程並識別效能問題。

即將推出

C# 的 DevUI 文件即將推出。 請稍後回來查看，或參考 Python 文件以獲得概念指引。

啟用追蹤

啟動 DevUI 時啟用追蹤功能，使用標誌 --tracing：

devui ./agents --tracing

這使 Agent Framework 的操作能夠啟用 OpenTelemetry 追蹤。

在 DevUI 中檢視追蹤記錄

啟用追蹤時，DevUI 網頁介面會顯示追蹤資訊：

  1. 透過介面執行代理或工作流程
  2. 開啟除錯面板（開發者模式中可用）
  3. 查看追蹤時間軸，顯示：
    • 跨度階層
    • 計時資訊
    • 代理人/工作流事件
    • 工具呼叫與結果

痕跡結構

Agent Framework 依照 GenAI 的 OpenTelemetry 語意慣例發出痕跡。 典型的痕跡包括：

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

對於工作流程，追蹤顯示經由執行器的運行路徑：

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

程式化追蹤

以程式碼方式使用 DevUI 時，可以啟用追蹤：serve()

from agent_framework.devui import serve

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

與外部工具的整合

DevUI 會擷取並顯示由代理框架（Agent Framework）發出的痕跡，但不會自行建立區間。 這些是標準的 OpenTelemetry 追蹤資料，也可以匯出至外部的可觀測性工具，例如以下這些工具：

  • 機甲
  • 齊普金
  • Azure 監視器
  • Datadog

要將追蹤資料匯出到外部收集器，請設定 OTLP_ENDPOINT 環境變數：

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

若無 OTLP 端點，追蹤會被擷取於本地，並僅顯示在 DevUI 除錯面板中。

想了解更多關於 Agent Framework 的可觀測性細節：

後續步驟

  • Last updated on