الدرس 4 من 4 · ٩ دقائق

استقبل الرد بالبث

اعرض الرد أثناء كتابته، وميّز البث المكتمل من البث المنقطع.

اضبط "stream": true وسترسل Phaseo المخرجات كأحداث مرسلة من الخادم (SSE) أثناء كتابة النموذج لها:

curl --no-buffer https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-astra",
    "input": "Say hello in one sentence.",
    "stream": true
  }'

تحقّق من حالة HTTP أولًا. الطلب الذي يفشل قبل بدء البث يحصل على خطأ JSON العادي، لا على بث. ثم اقرأ الأحداث. لكل نقطة نهاية تنسيقها الخاص:

نقطة النهايةيصل النص فيالنهاية الناجحةنهاية الفشل
Responsesresponse.output_text.deltaresponse.completedresponse.failed أو error
Chat Completionschoices[].deltafinish_reason، ثم [DONE]إطار error دون finish_reason

في Chat Completions، يحمل جزء أخير بقيمة choices فارغة الحقل usage، بما فيه cost للبث كله، قبل [DONE]. ولا يرسل [DONE] إلا Chat Completions. قد يحمل جزء الشبكة نصف حدث أو عدة أحداث، لذا خزّن البيانات مؤقتًا حتى يكتمل الحدث قبل تحليله، أو استخدم أداة بث من SDK.

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

للإلغاء، مرّر AbortSignal (أو ما يقابله في عميل HTTP لديك) وألغِ الطلب عندما يتوقف المستخدم. الإلغاء لا يضمن أن يتوقف المزوّد فورًا، ولا أن تكون المخرجات المولّدة بالفعل مجانية.

تحقّق من فهمك

أرسل بث Chat Completions نصًا، ثم أُغلق الاتصال. لم ترَ finish_reason ولا [DONE]. ماذا تفعل؟

طبّق ما تعلّمته

يستطيع المستخدمون الضغط على إيقاف في واجهة الدردشة لديك. يفترض مدير المنتج أن الردود الموقوفة لا تكلّف شيئًا. هل هذا صحيح؟

اعرض الإجابة

لا. ألغِ الطلب بـ AbortSignal كي يتوقف تطبيقك عن القراءة، لكن التوثيق يقول إن الإلغاء لا يضمن أن يتوقف المزوّد فورًا، ولا أن تكون المخرجات التي ولّدها بالفعل مجانية. توقّع أن تُحتسب الردود الموقوفة على العمل الذي أُنجز.

الخلاصة

انتظر حدث النهاية الناجحة لنقطة النهاية، واعتبر أي شيء آخر منقطعًا، ولا تفترض أن البث الملغى مجاني.

روابط ذات صلة

يُحفظ تقدّمك في هذا المتصفح.

آخر مراجعة: ١٧ نوفمبر ٢٠٢٦