Aracılığıyla paylaş

İzleme ve Gözlemlenebilirlik

DevUI, Agent Framework tarafından yayılan OpenTelemetry (OTel) izlemelerini yakalamak ve görüntülemek için yerleşik destek sağlar. DevUI kendi aralıklarını oluşturmaz; aracı ve iş akışı yürütme sırasında Agent Framework'ün yaydığı yayılma aralıklarını toplar ve ardından bunları hata ayıklama panelinde görüntüler. Bu, aracı davranışında hata ayıklamanıza, yürütme akışını anlamanıza ve performans sorunlarını belirlemenize yardımcı olur.

Çok Yakında

C# için DevUI belgeleri yakında kullanıma sunulacaktır. Kavramsal yönergeler için lütfen daha sonra tekrar kontrol edin veya Python belgelerine bakın.

İzlemeyi Etkinleştirme

DevUI'yi şu bayrakla --tracing başlatırken izlemeyi etkinleştirin:

devui ./agents --tracing

Bu, Ajan Çerçevesi işlemleri için OpenTelemetry izlemeyi etkinleştirir.

DevUI'de İzlemeleri Görüntüleme

İzleme etkinleştirildiğinde DevUI web arabirimi izleme bilgilerini görüntüler:

  1. Kullanıcı arabirimi aracılığıyla bir aracı veya iş akışı çalıştırma
  2. Hata ayıklama panelini açın (geliştirici modunda kullanılabilir)
  3. Aşağıdakileri gösteren izleme zaman çizelgesini görüntüleyin:
    • Span hiyerarşisi
    • Zamanlama bilgileri
    • Aracısı/iş akışı olayları
    • Araç çağrıları ve sonuçları

İz Yapısı

Agent Framework, GenAI için OpenTelemetry anlamsal kurallarını izleyerek izler yayar. Tipik bir izleme şunları içerir:

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

İş akışları için izlemeler yürütücüler aracılığıyla yürütme yolunu gösterir:

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

Programlı İzleme

DevUI, serve() program aracılığıyla kullanılırken, izleme etkinleştirilebilir:

from agent_framework.devui import serve

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

Dış Araçlarla Tümleştirme

DevUI, Agent Framework tarafından yayılan izleri yakalar ve görüntüler; kendi aralıklarını oluşturmaz. Bunlar, aşağıdaki gibi dış gözlemlenebilirlik araçlarına da aktarılabilir standart OpenTelemetry izlemeleridir:

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog

İzlemeleri dış toplayıcıya aktarmak için ortam değişkenini OTLP_ENDPOINT ayarlayın:

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

OTLP uç noktası olmadan izlemeler yerel olarak yakalanır ve yalnızca DevUI hata ayıklama panelinde görüntülenir.

Agent Framework gözlemlenebilirliği hakkında daha fazla ayrıntı için:

Sonraki Adımlar

  • Last updated on