المنهج الدراسي الدرس 245 من 250 · العمل مع ردود النموذج
العمل مع ردود النموذج

قراءة رد حقيقي: الكتل وأسباب التوقف

لماذا هذا مهم كل خطأ في هذه الوحدة يبدأ بنفس الطريقة: كود يقرأ reply["content"][0]["text"] ويفترض أن هذا هو الإجابة. في النموذج الحالي غالباً ما لا يكون الكتلة الأولى نصاً على الإطلاق.

رد

A من Claude Messages API هو dict. الإجابة موجودة في content، وهي list of blocks، وكل block يحتوي على type:

  • "thinking": قام النموذج بالتحليل قبل الإجابة. في النماذج الحالية غالباً ما يأتي هذا الجزء أولاً، ويكون نص thinking فارغاً بشكل افتراضي (حدث التحليل ولكن لا يتم عرضه).
  • "text": كلمات للمستخدم. يمكن أن يكون هناك أكثر من كتلة نصية؛ الإجابة هي جميعها مجمعة.
  • "tool_use": يريد النموذج منك تشغيل أداة (دروس لاحقة).

بجانب المحتوى يوجد stop_reason، الذي يذكر لماذا توقف النموذج: "end_turn" (انتهى)، "max_tokens" (وصلت إلى حد الطول، لذا قد يكونت الإجابة مقصوصة أو مفقودة)، "tool_use" (في انتظار نتيجة أداة) أو "refusal" (تم الرفض). هناك المزيد، مثل "stop_sequence" و "pause_turn"، لذا تعامل مع أي شيء غير "end_turn" على أنه غير مكتمل. تحقق دائما من ذلك قبل الوثوق بالمحتوى.

{'id': 'msg_01',
 'type': 'message',
 'role': 'assistant',
 'model': 'claude-opus-5-5',
 'content': [{'type': 'thinking', 'thinking': '', 'signature': 'EuYBCkQYAiJA...'},
             {'type': 'text',
              'text': 'A context window is the amount of text a model can read at once.'}],
 'stop_reason': 'end_turn',
 'stop_sequence': None,
 'usage': {'input_tokens': 412, 'output_tokens': 60}}

حول هذه الردود: هي simulated. كُتب كل واحد منها لهذا المساق بالشكل الذي تعيده Claude Messages API بالضبط (content blocks، stop_reason، usage)، وكل واحد منها ينسخ شيئا تفعله النماذج الحقيقية. هي ليست تسجيلات لنموذج مباشر، لذا الصياغة الدقيقة هي من اختيارنا؛ الأشكال والمشكلات هي الحقيقية التي سيواجهها كودك.

دورك

اكتب reply_text(reply)الذي يعيد جميع كتل النصوص مدمجة بالترتيب (سلسلة فارغة إذا لم يوجد أي منها)، مع تخطي كل نوع كتلة آخر. اكتب finished(reply)الذي يعيد True فقط عندما يكون stop_reason هو "end_turn". اترك REPLIES الخاص بالبدء كما هو: فعملية التحقق تقرأه.

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

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

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