Bagikan melalui

Pelacakan & Pengamatan

DevUI menyediakan dukungan bawaan untuk menangkap dan menampilkan jejak OpenTelemetry (OTel) yang dipancarkan oleh Kerangka Kerja Agen. DevUI tidak membuat rentangnya sendiri - DevUI ini mengumpulkan rentang yang dikeluarkan oleh Agent Framework ketika eksekusi agen dan alur kerja, dan kemudian menampilkannya pada panel debug. Ini membantu Anda men-debug perilaku agen, memahami alur eksekusi, dan mengidentifikasi masalah performa.

Segera hadir

Dokumentasi DevUI untuk C# akan segera hadir. Silakan periksa kembali nanti atau lihat dokumentasi Python untuk panduan konseptual.

Mengaktifkan Pelacakan

Aktifkan pelacakan saat memulai DevUI dengan flag --tracing.

devui ./agents --tracing

Ini memungkinkan pelacakan OpenTelemetry untuk operasi Kerangka Kerja Agen.

Melihat Jejak di DevUI

Saat pelacakan diaktifkan, antarmuka web DevUI menampilkan informasi pelacakan:

  1. Menjalankan agen atau alur kerja melalui UI
  2. Buka panel debug (tersedia dalam mode pengembang)
  3. Lihat garis waktu pelacakan yang memperlihatkan:
    • Hierarki rentang
    • Informasi waktu
    • Peristiwa agen/alur kerja
    • Panggilan alat dan hasil

Struktur Pelacakan

Agent Framework mengeluarkan jejak mengikuti konvensi semantik OpenTelemetry untuk GenAI. Jejak yang biasa meliputi:

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

Untuk alur kerja, pelacakan menunjukkan jalur proses eksekusi melalui pelaksana:

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

Pelacakan melalui Pemrograman

Saat menggunakan DevUI secara terprogram dengan serve(), pelacakan dapat diaktifkan:

from agent_framework.devui import serve

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

Integrasi dengan Alat Eksternal

DevUI menangkap dan menampilkan jejak yang dipancarkan oleh Kerangka Kerja Agen - itu tidak membuat rentangnya sendiri. Ini adalah jejak OpenTelemetry standar yang juga dapat diekspor ke alat pengamatan eksternal seperti:

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog

Untuk mengekspor jejak ke pengumpul eksternal, atur OTLP_ENDPOINT variabel lingkungan:

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

Tanpa titik akhir OTLP, jejak ditangkap secara lokal dan hanya ditampilkan di panel debug DevUI.

Untuk informasi lebih lanjut tentang Observabilitas Kerangka Kerja Agen:

Langkah Selanjutnya

  • Last updated on