crewAI/docs/ar/enterprise/features/traces.mdx

---
title: التتبعات
description: "استخدام التتبعات لمراقبة طواقمك"
icon: "timeline"
mode: "wide"
---

## نظرة عامة

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

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

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

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

<Frame>![نظرة عامة على التتبعات](/images/enterprise/traces-overview.png)</Frame>

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

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

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

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

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

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

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

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

<Frame>![ملخص التنفيذ](/images/enterprise/trace-summary.png)</Frame>

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

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

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

<Frame>![قائمة المهام](/images/enterprise/trace-tasks.png)</Frame>

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

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

<Frame>![المخرجات النهائية](/images/enterprise/final-output.png)</Frame>

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

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

<Frame>![الجدول الزمني للتنفيذ](/images/enterprise/trace-timeline.png)</Frame>

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

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

<Frame>![عرض المهمة المفصل](/images/enterprise/trace-detailed-task.png)</Frame>

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

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

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

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

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

    <Frame>
      ![نقاط الفشل](/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>