Skip to main content

مقدمة

يوفر CrewAI القدرة على بث المخرجات في الوقت الفعلي أثناء تنفيذ الطاقم، مما يتيح لك عرض النتائج فور توليدها بدلاً من انتظار اكتمال العملية بالكامل. هذه الميزة مفيدة بشكل خاص لبناء التطبيقات التفاعلية وتقديم تغذية راجعة للمستخدم ومراقبة العمليات طويلة التشغيل.

كيف يعمل البث

عند تفعيل البث، يلتقط CrewAI استجابات LLM واستدعاءات الأدوات فور حدوثها، ويحزمها في أجزاء منظمة تتضمن سياقاً حول المهمة والوكيل المنفذ. يمكنك التكرار على هذه الأجزاء في الوقت الفعلي والوصول إلى النتيجة النهائية بمجرد اكتمال التنفيذ.

تفعيل البث

لتفعيل البث، عيّن معامل stream إلى True عند إنشاء طاقمك:
Code

البث المتزامن

عند استدعاء kickoff() على طاقم مع تفعيل البث، يُرجع كائن CrewStreamingOutput يمكنك التكرار عليه لاستلام الأجزاء فور وصولها:
Code

معلومات جزء البث

يوفر كل جزء سياقاً غنياً حول التنفيذ:
Code

الوصول إلى نتائج البث

يوفر كائن CrewStreamingOutput عدة خصائص مفيدة:
Code

البث غير المتزامن

للتطبيقات غير المتزامنة، يمكنك استخدام إما akickoff() (async أصلي) أو kickoff_async() (قائم على الخيوط) مع التكرار غير المتزامن:

async أصلي مع akickoff()

توفر طريقة akickoff() تنفيذاً غير متزامن أصلياً حقيقياً عبر السلسلة بالكامل:
Code

async قائم على الخيوط مع kickoff_async()

للتكامل البسيط مع async أو التوافق مع الإصدارات السابقة:
Code
لأحمال العمل عالية التزامن، يُوصى باستخدام akickoff() لأنه يستخدم async أصلي لتنفيذ المهام وعمليات الذاكرة واسترجاع المعرفة. راجع دليل تشغيل الطاقم بشكل غير متزامن لمزيد من التفاصيل.

البث مع kickoff_for_each

عند تنفيذ طاقم لمدخلات متعددة مع kickoff_for_each()، يعمل البث بشكل مختلف حسب ما إذا كنت تستخدم المتزامن أو غير المتزامن:

kickoff_for_each المتزامن

مع kickoff_for_each() المتزامن، تحصل على قائمة كائنات CrewStreamingOutput، واحد لكل مدخل:
Code

kickoff_for_each_async غير المتزامن

مع kickoff_for_each_async() غير المتزامن، تحصل على CrewStreamingOutput واحد يُخرج أجزاء من جميع الأطقم فور وصولها بشكل متزامن:
Code

أنواع أجزاء البث

يمكن أن تكون الأجزاء من أنواع مختلفة، يُشار إليها بحقل chunk_type:

أجزاء TEXT

محتوى نصي قياسي من استجابات LLM:
Code

أجزاء TOOL_CALL

معلومات حول استدعاءات الأدوات الجارية:
Code

مثال عملي: بناء واجهة مستخدم مع البث

إليك مثالاً كاملاً يوضح كيفية بناء تطبيق تفاعلي مع البث:
Code

حالات الاستخدام

البث ذو قيمة خاصة لـ:
  • التطبيقات التفاعلية: تقديم تغذية راجعة فورية للمستخدمين أثناء عمل الوكلاء
  • المهام طويلة التشغيل: عرض التقدم للبحث والتحليل أو توليد المحتوى
  • التصحيح والمراقبة: مراقبة سلوك الوكلاء واتخاذ القرارات في الوقت الفعلي
  • تجربة المستخدم: تقليل زمن الاستجابة المتصور بعرض نتائج تدريجية
  • لوحات المعلومات الحية: بناء واجهات مراقبة تعرض حالة تنفيذ الطاقم

الإلغاء وتنظيف الموارد

يدعم CrewStreamingOutput الإلغاء السلس بحيث يتوقف العمل الجاري فوراً عند انقطاع اتصال المستهلك.

مدير السياق غير المتزامن

Code

الإلغاء الصريح

Code
بعد الإلغاء، يكون كل من streaming.is_cancelled و streaming.is_completed بقيمة True. كل من aclose() و close() متساويان القوة.

ملاحظات مهمة

  • يفعّل البث تلقائياً بث LLM لجميع الوكلاء في الطاقم
  • يجب التكرار عبر جميع الأجزاء قبل الوصول إلى خاصية .result
  • لـ kickoff_for_each_async() مع البث، استخدم .results (بصيغة الجمع) للحصول على جميع المخرجات
  • يضيف البث حملاً ضئيلاً ويمكن أن يحسن الأداء المتصور فعلياً
  • يتضمن كل جزء سياقاً كاملاً (المهمة، الوكيل، نوع الجزء) لواجهات مستخدم غنية

معالجة الأخطاء

التعامل مع الأخطاء أثناء تنفيذ البث:
Code
من خلال الاستفادة من البث، يمكنك بناء تطبيقات أكثر استجابة وتفاعلية مع CrewAI، مما يوفر للمستخدمين رؤية فورية لتنفيذ الوكلاء والنتائج.