التتبعات
نظرة عامة
Section titled “نظرة عامة”توفر التتبعات رؤية شاملة لعمليات تنفيذ طواقمك، مما يساعدك على مراقبة الأداء وتصحيح الأخطاء وتحسين سير عمل وكلاء الذكاء الاصطناعي.
ما هي التتبعات؟
Section titled “ما هي التتبعات؟”التتبعات في CrewAI AMP هي سجلات تنفيذ مفصلة تلتقط كل جانب من جوانب عمل طاقمك، من المدخلات الأولية إلى المخرجات النهائية. تسجل:
- أفكار الوكلاء واستدلالاتهم
- تفاصيل تنفيذ المهام
- استخدام الأدوات ومخرجاتها
- مقاييس استهلاك الرموز
- أوقات التنفيذ
- تقديرات التكلفة
الوصول إلى التتبعات
Section titled “الوصول إلى التتبعات”- الانتقال إلى علامة تبويب التتبعات
في لوحة تحكم CrewAI AMP، انقر على Traces لعرض جميع سجلات التنفيذ.
- اختيار عملية تنفيذ
سترى قائمة بجميع عمليات تنفيذ الطاقم، مرتبة حسب التاريخ. انقر على أي عملية تنفيذ لعرض تتبعها المفصل.
فهم واجهة التتبع
Section titled “فهم واجهة التتبع”تنقسم واجهة التتبع إلى عدة أقسام، يقدم كل منها رؤى مختلفة حول تنفيذ طاقمك:
1. ملخص التنفيذ
Section titled “1. ملخص التنفيذ”يعرض القسم العلوي مقاييس عالية المستوى حول التنفيذ:
- إجمالي الرموز: عدد الرموز المستهلكة عبر جميع المهام
- رموز الطلب: الرموز المستخدمة في الطلبات إلى LLM
- رموز الإكمال: الرموز المُنشأة في استجابات LLM
- الطلبات: عدد استدعاءات API المُجراة
- وقت التنفيذ: المدة الإجمالية لتشغيل الطاقم
- التكلفة المقدرة: التكلفة التقريبية بناءً على استخدام الرموز
2. المهام والوكلاء
Section titled “2. المهام والوكلاء”يعرض هذا القسم جميع المهام والوكلاء الذين كانوا جزءاً من تنفيذ الطاقم:
- اسم المهمة وتعيين الوكيل
- الوكلاء ونماذج LLM المستخدمة لكل مهمة
- الحالة (مكتملة/فاشلة)
- وقت التنفيذ الفردي للمهمة
3. المخرجات النهائية
Section titled “3. المخرجات النهائية”يعرض النتيجة النهائية التي أنتجها الطاقم بعد اكتمال جميع المهام.
4. الجدول الزمني للتنفيذ
Section titled “4. الجدول الزمني للتنفيذ”تمثيل مرئي لوقت بدء وانتهاء كل مهمة، يساعدك على تحديد نقاط الاختناق أو أنماط التنفيذ المتوازي.
5. عرض المهمة المفصل
Section titled “5. عرض المهمة المفصل”عند النقر على مهمة محددة في الجدول الزمني أو قائمة المهام، سترى:
- مفتاح المهمة: معرّف فريد للمهمة
- معرّف المهمة: معرّف تقني في النظام
- الحالة: الحالة الحالية (مكتملة/قيد التشغيل/فاشلة)
- الوكيل: الوكيل الذي نفّذ المهمة
- LLM: نموذج اللغة المستخدم لهذه المهمة
- وقت البدء/الانتهاء: متى بدأت المهمة واكتملت
- وقت التنفيذ: مدة هذه المهمة المحددة
- وصف المهمة: ما طُلب من الوكيل تنفيذه
- المخرجات المتوقعة: تنسيق المخرجات المطلوب
- المدخلات: أي مدخلات مقدمة لهذه المهمة من مهام سابقة
- المخرجات: النتيجة الفعلية التي أنتجها الوكيل
استخدام التتبعات لتصحيح الأخطاء
Section titled “استخدام التتبعات لتصحيح الأخطاء”التتبعات لا تقدر بثمن لاستكشاف المشكلات في طواقمك:
- تحديد نقاط الفشل
عندما لا ينتج تنفيذ الطاقم النتائج المتوقعة، افحص التتبع لمعرفة أين حدث الخطأ. ابحث عن:
- المهام الفاشلة
- قرارات الوكيل غير المتوقعة
- أخطاء استخدام الأدوات
- التعليمات المُساء فهمها
- تحسين الأداء
استخدم مقاييس التنفيذ لتحديد نقاط اختناق الأداء:
- المهام التي استغرقت وقتاً أطول من المتوقع
- الاستخدام المفرط للرموز
- عمليات الأدوات المكررة
- استدعاءات API غير الضرورية
- تحسين كفاءة التكلفة
حلل استخدام الرموز وتقديرات التكلفة لتحسين كفاءة طاقمك:
- فكّر في استخدام نماذج أصغر للمهام الأبسط
- صقل الطلبات لتكون أكثر إيجازاً
- خزّن المعلومات المُوصول إليها بشكل متكرر مؤقتاً
- نظّم المهام لتقليل العمليات المكررة
الأداء والتجميع
Section titled “الأداء والتجميع”يجمّع CrewAI تحميلات التتبع لتقليل العبء في عمليات التشغيل ذات الحجم الكبير:
- يقوم TraceBatchManager بتخزين الأحداث مؤقتاً وإرسالها في دفعات عبر عميل Plus API
- يقلل حركة الشبكة ويحسّن الموثوقية في الاتصالات غير المستقرة
- يُفعّل تلقائياً في مستمع التتبع الافتراضي؛ لا حاجة لتهيئة
يوفر ذلك تتبعاً أكثر استقراراً تحت الحمل مع الحفاظ على بيانات القياس المفصلة للمهام/الوكلاء.
تحتاج مساعدة؟
تواصل مع فريق الدعم للمساعدة في تحليل التتبعات أو أي ميزات أخرى في CrewAI AMP.