> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# التتبعات

> استخدام التتبعات لمراقبة طواقمك

## نظرة عامة

توفر التتبعات رؤية شاملة لعمليات تنفيذ طواقمك، مما يساعدك على مراقبة الأداء وتصحيح الأخطاء وتحسين سير عمل وكلاء الذكاء الاصطناعي.

## ما هي التتبعات؟

التتبعات في CrewAI AMP هي سجلات تنفيذ مفصلة تلتقط كل جانب من جوانب عمل طاقمك، من المدخلات الأولية إلى المخرجات النهائية. تسجل:

* أفكار الوكلاء واستدلالاتهم
* تفاصيل تنفيذ المهام
* استخدام الأدوات ومخرجاتها
* مقاييس استهلاك الرموز
* أوقات التنفيذ
* تقديرات التكلفة

<Frame>
  <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/traces-overview.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=9c02d5b7306bf7adaeadd77a018f8fea" alt="نظرة عامة على التتبعات" width="2244" height="1422" data-path="images/enterprise/traces-overview.png" />
</Frame>

## الوصول إلى التتبعات

<Steps>
  <Step title="الانتقال إلى علامة تبويب التتبعات">
    في لوحة تحكم CrewAI AMP، انقر على **Traces** لعرض جميع سجلات التنفيذ.
  </Step>

  <Step title="اختيار عملية تنفيذ">
    سترى قائمة بجميع عمليات تنفيذ الطاقم، مرتبة حسب التاريخ. انقر على أي عملية تنفيذ لعرض تتبعها المفصل.
  </Step>
</Steps>

## فهم واجهة التتبع

تنقسم واجهة التتبع إلى عدة أقسام، يقدم كل منها رؤى مختلفة حول تنفيذ طاقمك:

### 1. ملخص التنفيذ

يعرض القسم العلوي مقاييس عالية المستوى حول التنفيذ:

* **إجمالي الرموز**: عدد الرموز المستهلكة عبر جميع المهام
* **رموز الطلب**: الرموز المستخدمة في الطلبات إلى LLM
* **رموز الإكمال**: الرموز المُنشأة في استجابات LLM
* **الطلبات**: عدد استدعاءات API المُجراة
* **وقت التنفيذ**: المدة الإجمالية لتشغيل الطاقم
* **التكلفة المقدرة**: التكلفة التقريبية بناءً على استخدام الرموز

<Frame>
  <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/trace-summary.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=a6a26eda2add26a6f649b1727bf90d8d" alt="ملخص التنفيذ" width="2576" height="916" data-path="images/enterprise/trace-summary.png" />
</Frame>

### 2. المهام والوكلاء

يعرض هذا القسم جميع المهام والوكلاء الذين كانوا جزءاً من تنفيذ الطاقم:

* اسم المهمة وتعيين الوكيل
* الوكلاء ونماذج LLM المستخدمة لكل مهمة
* الحالة (مكتملة/فاشلة)
* وقت التنفيذ الفردي للمهمة

<Frame>
  <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/trace-tasks.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=f0358b4a17e78532500b4a14964bc30c" alt="قائمة المهام" width="1778" height="594" data-path="images/enterprise/trace-tasks.png" />
</Frame>

### 3. المخرجات النهائية

يعرض النتيجة النهائية التي أنتجها الطاقم بعد اكتمال جميع المهام.

<Frame>
  <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/final-output.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=5ca9ef8e4071ee570c3e0c8f93ff4253" alt="المخرجات النهائية" width="2212" height="1572" data-path="images/enterprise/final-output.png" />
</Frame>

### 4. الجدول الزمني للتنفيذ

تمثيل مرئي لوقت بدء وانتهاء كل مهمة، يساعدك على تحديد نقاط الاختناق أو أنماط التنفيذ المتوازي.

<Frame>
  <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/trace-timeline.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=c860975d3e15e3a6988bedc7d1bf6ba4" alt="الجدول الزمني للتنفيذ" width="2210" height="1406" data-path="images/enterprise/trace-timeline.png" />
</Frame>

### 5. عرض المهمة المفصل

عند النقر على مهمة محددة في الجدول الزمني أو قائمة المهام، سترى:

<Frame>
  <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/trace-detailed-task.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=74f5e92354196325edca8d62c29363c7" alt="عرض المهمة المفصل" width="2036" height="1572" data-path="images/enterprise/trace-detailed-task.png" />
</Frame>

* **مفتاح المهمة**: معرّف فريد للمهمة
* **معرّف المهمة**: معرّف تقني في النظام
* **الحالة**: الحالة الحالية (مكتملة/قيد التشغيل/فاشلة)
* **الوكيل**: الوكيل الذي نفّذ المهمة
* **LLM**: نموذج اللغة المستخدم لهذه المهمة
* **وقت البدء/الانتهاء**: متى بدأت المهمة واكتملت
* **وقت التنفيذ**: مدة هذه المهمة المحددة
* **وصف المهمة**: ما طُلب من الوكيل تنفيذه
* **المخرجات المتوقعة**: تنسيق المخرجات المطلوب
* **المدخلات**: أي مدخلات مقدمة لهذه المهمة من مهام سابقة
* **المخرجات**: النتيجة الفعلية التي أنتجها الوكيل

## استخدام التتبعات لتصحيح الأخطاء

التتبعات لا تقدر بثمن لاستكشاف المشكلات في طواقمك:

<Steps>
  <Step title="تحديد نقاط الفشل">
    عندما لا ينتج تنفيذ الطاقم النتائج المتوقعة، افحص التتبع لمعرفة أين حدث الخطأ. ابحث عن:

    * المهام الفاشلة
    * قرارات الوكيل غير المتوقعة
    * أخطاء استخدام الأدوات
    * التعليمات المُساء فهمها

    <Frame>
      <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/failure.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=c892a75b7a22a57949a2641a0fe45bfa" alt="نقاط الفشل" width="820" height="924" data-path="images/enterprise/failure.png" />
    </Frame>
  </Step>

  <Step title="تحسين الأداء">
    استخدم مقاييس التنفيذ لتحديد نقاط اختناق الأداء:

    * المهام التي استغرقت وقتاً أطول من المتوقع
    * الاستخدام المفرط للرموز
    * عمليات الأدوات المكررة
    * استدعاءات API غير الضرورية
  </Step>

  <Step title="تحسين كفاءة التكلفة">
    حلل استخدام الرموز وتقديرات التكلفة لتحسين كفاءة طاقمك:

    * فكّر في استخدام نماذج أصغر للمهام الأبسط
    * صقل الطلبات لتكون أكثر إيجازاً
    * خزّن المعلومات المُوصول إليها بشكل متكرر مؤقتاً
    * نظّم المهام لتقليل العمليات المكررة
  </Step>
</Steps>

## الأداء والتجميع

يجمّع CrewAI تحميلات التتبع لتقليل العبء في عمليات التشغيل ذات الحجم الكبير:

* يقوم TraceBatchManager بتخزين الأحداث مؤقتاً وإرسالها في دفعات عبر عميل Plus API
* يقلل حركة الشبكة ويحسّن الموثوقية في الاتصالات غير المستقرة
* يُفعّل تلقائياً في مستمع التتبع الافتراضي؛ لا حاجة لتهيئة

يوفر ذلك تتبعاً أكثر استقراراً تحت الحمل مع الحفاظ على بيانات القياس المفصلة للمهام/الوكلاء.

<Card title="تحتاج مساعدة؟" icon="headset" href="mailto:support@crewai.com">
  تواصل مع فريق الدعم للمساعدة في تحليل التتبعات أو أي ميزات أخرى في
  CrewAI AMP.
</Card>
