عرض تدفق أحداث الوكيل تدريجياً ومعالجة حالات الانتهاء

الهدف

اعرض التقدم مع الحفاظ على ترتيب الأحداث وأنهِ العرض بشكل صحيح عند الإكمال أو الفشل أو الإلغاء.

الخطوات

1. تعرّف على فئات الأحداث مثل أجزاء النص واستدعاءات الأدوات والتحويل وانتهاء التشغيل. [openai-streaming] [openai-running]
2. ابدأ بـ result=Runner.run_streamed(agent, input) واستهلك الأحداث عبر async for event in result.stream_events(). [openai-streaming] [openai-running]
3. فرّع حسب event.type بين raw_response_event وrun_item_stream_event؛ ولا تعرض للمستخدم سوى أجزاء النص. [openai-streaming] [openai-running]
4. أغلق الاتصال واضبط الحالة النهائية عند انتهاء التدفق أو المهلة أو إلغاء المستخدم. [openai-streaming] [openai-running]
5. اختبر تدفقاً وهمياً يتضمن نصاً وأحداث أدوات وفشلاً وتأكد من عدم كشف الواجهة للمعاملات المخفية. [openai-streaming] [openai-running]

طريقة التحقق

يجب أن تغطي اختبارات الأحداث الانتهاء الطبيعي والفشل أثناء التدفق؛ ولا تدمج أحداث الأدوات في الإجابات الظاهرة للمستخدم.

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

إذا تكرر الإخراج، فافحص ترتيب الأحداث وتأكد من عدم إضافة الأجزاء مرتين بعد إعادة الاتصال.