Поделиться через

Трассировка и наблюдаемость

DevUI обеспечивает встроенную поддержку записи и отображения трассировок OpenTelemetry (OTel), создаваемых фреймворком агента. DevUI не создает собственные диапазоны. Он собирает диапазоны, которые платформа агента выдает во время выполнения агента и рабочего процесса, а затем отображает их на панели отладки. Это помогает отладить поведение агента, понять поток выполнения и определить проблемы с производительностью.

Ожидается в скором времени

В ближайшее время ожидается документация по DevUI для C#. Вернитесь позже или ознакомьтесь с документацией по Python для получения концептуальных рекомендаций.

Включение трассировки

Включите трассировку при запуске DevUI с флагом --tracing :

devui ./agents --tracing

Это обеспечивает трассировку OpenTelemetry для операций Agent Framework.

Просмотр трассировок в DevUI

Если трассировка включена, веб-интерфейс DevUI отображает сведения о трассировке:

  1. Запуск агента или рабочего процесса с помощью пользовательского интерфейса
  2. Откройте панель отладки (доступна в режиме разработчика)
  3. Просмотрите временную шкалу трассировки, показывающую:
    • Иерархия диапазонов
    • Сведения о времени
    • События агента или рабочего процесса
    • Вызовы и результаты инструментов

Структура трассировки

Agent Framework генерирует трассировки в соответствии с семантическими стандартами OpenTelemetry для GenAI. Типичная трассировка включает:

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 фиксирует и отображает трассировки, создаваемые агентом Framework, — он не создает собственные диапазоны. Это стандартные трассировки OpenTelemetry, которые также можно экспортировать во внешние средства наблюдения, такие как:

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Датадог

Чтобы экспортировать трассировки во внешний сборщик, задайте OTLP_ENDPOINT переменную среды:

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

Без конечной точки OTLP трассировки записываются локально и отображаются только на панели отладки DevUI.

Чтобы получить больше информации о наблюдаемости Agent Framework,

Дальнейшие шаги

  • Last updated on