مقدمة
يوفر 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
حالات الاستخدام
البث ذو قيمة خاصة لـ:- التطبيقات التفاعلية: تقديم تغذية راجعة فورية للمستخدمين أثناء عمل الوكلاء
- المهام طويلة التشغيل: عرض التقدم للبحث والتحليل أو توليد المحتوى
- التصحيح والمراقبة: مراقبة سلوك الوكلاء واتخاذ القرارات في الوقت الفعلي
- تجربة المستخدم: تقليل زمن الاستجابة المتصور بعرض نتائج تدريجية
- لوحات المعلومات الحية: بناء واجهات مراقبة تعرض حالة تنفيذ الطاقم
ملاحظات مهمة
- يفعّل البث تلقائياً بث LLM لجميع الوكلاء في الطاقم
- يجب التكرار عبر جميع الأجزاء قبل الوصول إلى خاصية
.result - لـ
kickoff_for_each_async()مع البث، استخدم.results(بصيغة الجمع) للحصول على جميع المخرجات - يضيف البث حملاً ضئيلاً ويمكن أن يحسن الأداء المتصور فعلياً
- يتضمن كل جزء سياقاً كاملاً (المهمة، الوكيل، نوع الجزء) لواجهات مستخدم غنية
معالجة الأخطاء
التعامل مع الأخطاء أثناء تنفيذ البث:Code
