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

اقرأ الاستجابة

يجيب النموذج بكائن JSON، ويقوم الـ SDK بإعادته كاستجابة تحتوي على قائمة content، و stop_reason، وكتلة usage. المفاجأة المهمة للمبتدئين: content هو قائمة من الكتل، وليس سلسلة نصية واحدة. معظم الردود هي كتلة نصية واحدة، ولكن يمكن للرد أن يحتوي على عدة كتل (على سبيل المثال جزء من نص، ثم طلب أداة)، لذا لا يمكنك افتراض أن الإجابة تكون دائما عند الفهرس صفر.

في الكود الحقيقي تصل إليه بهذا الشكل (للتوضيح فقط):

resp = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
                              messages=[{"role": "user", "content": "Hi"}])
print(resp.content[0].text)        # the first block's text
print(resp.stop_reason)            # "end_turn", "max_tokens", "tool_use", ...
print(resp.usage.input_tokens, resp.usage.output_tokens)
يعمل

Reaching for content[0].text في الحالة البسيطة، لكنه يتوقف عن العمل إذا لم تكن الكتلة الأولى نصا (على سبيل المثال إذا كانت كتلة tool_use). الخطوة القوية هي المرور على كل كتلة ودمج تلك التي هي نص بالفعل. نحن نمثل JSON الاستجابة كـ dict بسيط ليعمل دون اتصال بالإنترنت:

{
  "content": [{"type": "text", "text": "Hello there."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 12, "output_tokens": 5}
}

أنت تقوم ببناء get_text(resp). قم بقطع resp["content"] ودمج text لكل كتلة يكون type الخاص بها هو "text"، بالترتيب. تخطى أي كتلة لا يكون نوعها "text" (الكتلة من نوع tool_use لا تحتوي على نص للمستخدم). إذا كان content فارغاً أو مفقوداً، أرجع السلسلة النصية الفارغة "" -> قيمة افتراضية نظيفة وآمنة بدلاً من حدوث خطأ.

قم ببنائه بحيث تعيد الاستجابة أحادية الكتلة ذلك النص فقط، وتعيد الاستجابة متعددة الكتل كتل النص مدمجة بالترتيب، ويتم تخطي الكتلة غير النصية، وتعيد content الفارغة أو المفقودة "".

دورك

اكتب get_text(resp) حيث يمثل resp استجابة API وهي {"content": [ {"type": "text", "text": ...}, ... ], "stop_reason": ..., "usage": {...}}. قم بدمج text لكل كتلة يكون type == "text" الخاص بها، مع تخطي أي نوع كتلة آخر (مثل tool_use) بالترتيب. أرجع "" عندما يكون content فارغا أو مفقودا.

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

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

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