التتبع وقابلية المراقبة

يوفر DevUI دعما مضمنا لالتقاط وعرض آثار OpenTelemetry (OTel) المنبعثة من إطار عمل العامل. لا تقوم DevUI بإنشاء امتداداتها الخاصة - فهي تجمع الامتدادات التي يصدرها إطار عمل العامل أثناء تنفيذ العامل وسير العمل، ثم يعرضها في لوحة التصحيح. يساعدك هذا على تصحيح سلوك العامل وفهم تدفق التنفيذ وتحديد مشكلات الأداء.

قريباً

ستتوفر وثائق DevUI ل C# قريبا. يرجى التحقق مرة أخرى لاحقا أو الرجوع إلى وثائق Python للحصول على إرشادات تصورية.

تمكين التتبع

تمكين التتبع عند بدء تشغيل DevUI مع العلامة --tracing :

devui ./agents --tracing

وهذا يمكن تتبع OpenTelemetry لعمليات إطار عمل العامل.

عرض التتبعات في DevUI

عند تمكين التتبع، تعرض واجهة ويب DevUI معلومات التتبع:

  1. تشغيل عامل أو سير عمل من خلال واجهة المستخدم
  2. فتح لوحة تتبع الأخطاء (متوفرة في وضع المطور)
  3. عرض المخطط الزمني للتتبع الذي يظهر:
    • التسلسل الهرمي للامتداد
    • معلومات التوقيت
    • أحداث العامل/سير العمل
    • استدعاءات الأداة ونتائجها

بنية التتبع

يرسل إطار عمل العامل آثارا بعد الاصطلاحات الدلالية 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 التتبعات المنبعثة من إطار عمل العامل ويعرضها - لا ينشئ امتداداته الخاصة. هذه هي تتبعات القياس المفتوح القياسية التي يمكن تصديرها أيضا إلى أدوات المراقبة الخارجية مثل:

  • Jaeger
  • Zipkin
  • Azure Monitor
  • مربع بيانات

لتصدير التتبعات إلى جامع خارجي، قم بتعيين OTLP_ENDPOINT متغير البيئة:

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

بدون نقطة نهاية OTLP، يتم التقاط التتبعات محليا وعرضها فقط في لوحة تتبع أخطاء DevUI.

Note

سيتوفر الدعم لهذه الميزة قريبا. راجع مستودع Agent Framework Go للحصول على أحدث حالة.

لمزيد من التفاصيل حول إمكانية مراقبة إطار عمل العامل:

الخطوات التالية

  • تاريخ آخر تحديث في