Skip to main content

مقدمة

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

كيف يعمل بث التدفق

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

تفعيل البث

لتفعيل البث، عيّن خاصية stream إلى True في فئة التدفق الخاصة بك:
Code

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

عند استدعاء kickoff() على تدفق مع تفعيل البث، يُرجع كائن FlowStreamingOutput يمكنك التكرار عليه:
Code

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

يوفر كل جزء سياقاً حول مصدره في التدفق:
Code

الوصول إلى خصائص البث

يوفر كائن FlowStreamingOutput خصائص وطرق مفيدة:
Code

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

للتطبيقات غير المتزامنة، استخدم kickoff_async() مع التكرار غير المتزامن:
Code

البث مع التدفقات متعددة الخطوات

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

مثال عملي: لوحة معلومات التقدم

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

البث مع إدارة الحالة

يعمل البث بشكل طبيعي مع إدارة حالة التدفق:
Code

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

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

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

مثل بث الطاقم، يمكن أن تكون أجزاء التدفق من أنواع مختلفة:

أجزاء TEXT

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

أجزاء TOOL_CALL

معلومات حول استدعاءات الأدوات داخل التدفق:
Code

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

التعامل مع الأخطاء بأناقة أثناء البث:
Code

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

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

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

Code

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

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

ملاحظات مهمة

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

الدمج مع تصور التدفق

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