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