Udostępnij przez

Śledzenie i obserwowalność

Interfejs DevUI zapewnia wbudowaną obsługę przechwytywania i wyświetlania śladów OpenTelemetry (OTel) emitowanych przez platformę Agent Framework. Interfejs DevUI nie tworzy własnych zakresów — zbiera zakresy emitowane przez platformę Agent Framework podczas wykonywania agenta i przepływu pracy, a następnie wyświetla je w panelu debugowania. Ułatwia to debugowanie zachowania agenta, zrozumienie przepływu wykonywania i identyfikowanie problemów z wydajnością.

Wkrótce

Dokumentacja usługi DevUI dla języka C# jest dostępna wkrótce. Sprawdź ponownie później lub przejrzyj dokumentację języka Python, aby uzyskać wskazówki koncepcyjne.

Włączanie śledzenia

Włącz śledzenie podczas uruchamiania interfejsu DevUI z flagą --tracing :

devui ./agents --tracing

Umożliwia to śledzenie OpenTelemetry dla operacji platformy Agent Framework.

Wyświetlanie śladów w DevUI

Po włączeniu śledzenia interfejs internetowy DevUI wyświetla informacje śledzenia:

  1. Uruchamianie agenta lub przepływu pracy za pośrednictwem interfejsu użytkownika
  2. Otwórz panel debugowania (dostępny w trybie dewelopera)
  3. Wyświetl oś czasu śledzenia pokazującą:
    • Hierarchia zakresu
    • Informacje o chronometrażu
    • Zdarzenia agenta/przepływu zadań
    • Wywołania narzędzi i wyniki

Struktura śledzenia

Struktura agenta emituje ślady zgodnie z konwencjami semantycznymi OpenTelemetry dla usługi GenAI. Typowy ślad obejmuje:

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

W przypadku procesów roboczych, ślady pokazują ścieżkę wykonania przez wykonawców.

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

Śledzenie programowe

W przypadku programowego używania interfejsu DevUI z funkcją serve()można włączyć śledzenie:

from agent_framework.devui import serve

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

Integracja z narzędziami zewnętrznymi

DevUI przechwytuje i wyświetla ślady emitowane przez platformę Agent — nie tworzy własnych odcinków. Są to standardowe ślady OpenTelemetry, które można również eksportować do zewnętrznych narzędzi do obserwacji, takich jak:

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog

Aby wyeksportować ślady do zewnętrznego modułu zbierającego, ustaw zmienną OTLP_ENDPOINT środowiskową:

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

Bez punktu końcowego OTLP ślady są przechwytywane lokalnie i wyświetlane tylko w panelu debugowania DevUI.

Aby uzyskać więcej informacji na temat możliwości obserwowania platformy Agent Framework:

Dalsze kroki

  • Last updated on