المنهج الدراسي الدرس 119 من 250 · استدعاء نموذج لغوي كبير حقيقي
استدعاء نموذج لغوي كبير حقيقي

طيّ سلسلة الرموز (Token Stream)

عندما تقوم ببث استجابة، يرسل النموذج الإجابة كسلسلة من الأحداث الصغيرة بدلا من حمولة واحدة كبيرة، لكي تتمكن من عرض النص أثناء كتابته. توفر الـ SDK لك متكررا نظيفا من قطع النص، ولكن في الخلفية تقوم بطي تدفق من الأحداث المكتوبة: حدث message_start، ثم العديد من أحداث content_block_delta يحمل كل منها text_delta صغيرا، مع علامات content_block_stop و message_stop حولها. لإعادة بناء الإجابة الكاملة، تحتفظ فقط بفروقات النص وتقوم بدمجها.

تبدو النسخة الحقيقية الودودة بهذا الشكل (للتوضيح فقط -> نحن لا نستدعي الشبكة):

with client.messages.stream(model="claude-opus-5-5", max_tokens=1024,
                            messages=[{"role": "user", "content": "Hi"}]) as stream:
    for text in stream.text_stream:   # already just the text chunks
        print(text, end="", flush=True)
    final = stream.get_final_message()

إن text_stream هو وسيلة لتسهيل العمل. تحت هذا، تظهر الأحداث الخام مثل القائمة أدناه، وطيّها هو بالضبط المهارة التي يتدرب عليها هذا الدرس. نحن نمثل التدفق كقائمة من event dicts ليعمل في وضع offline:

[
  {"type": "message_start"},
  {"type": "content_block_delta", "delta": {"type": "text_delta", "text": "He"}},
  {"type": "content_block_delta", "delta": {"type": "text_delta", "text": "llo"}},
  {"type": "content_block_stop"},
  {"type": "message_stop"}
]

أنت تبني collect_stream(events). قم بالمرور على القائمة وادمج، بالترتيب، الـ text من كل حدث هو content_block_delta يحتوي الـ delta الداخلي الخاص به على type == "text_delta". تخطى كل حدث آخر -> علامات دورة الحياة (message_start, content_block_stop, message_stop) لا تحمل أي نص، والفرق غير النصي (مثل input_json_delta لاستدعاء أداة عبر البث) ليس جزءا من الإجابة المرئية. القائمة الفارغة تعيد "".

ابنِه بحيث تعيد قائمتا أحداث مختلفتان بناء نصّين مختلفين، وتُتخطّى أحداث دورة الحياة والأحداث غير النصية، ويُرجع البث الفارغ "".

دورك

اكتب collect_stream(events) حيث events هي قائمة من قواميس أحداث البث. قم بدمج text لكل حدث {"type": "content_block_delta", "delta": {"type": "text_delta", "text": ...}} بالترتيب. تخطى جميع الأحداث الأخرى (علامات دورة الحياة مثل message_start/content_block_stop، والتغييرات غير النصية). أرجع "" لبث فارغ.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.