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