وضع JSON: تحليل + التحقق من صحة البيانات مقابل مخطط
في اللحظة التي تريد فيها من LLM تزويد نظام تابع -> قاعدة بيانات، أو API، أو مهمة فوترة -> فإن النثر الحر لا فائدة منه. أنت بحاجة إلى structured output: حيث يعيد النموذج JSON، ويقوم الكود الخاص بك بتحويل ذلك JSON إلى typed object يمكنه الوثوق به. تمتلك معظم واجهات برمجة تطبيقات النماذج "JSON mode" الذي يجعل النموذج يخرج JSON string. لكن "إنه JSON صالح" و "إنه الكائن الذي طلبته" هما أمران مختلفان. الحدود بين النموذج والكود الخاص بك هي المكان الذي تقوم فيه بالتحقق.
في الكود الحقيقي يبدو استدعاء النموذج بهذا الشكل (للتوضيح فقط -> نحن لا نستدعي أي نموذج هنا):
resp = client.messages.create(model="...", messages=[...])
text = resp.content[0].text # a JSON string, hopefully
record = parse_and_validate(text, {"name": str, "age": int})أنت تقوم ببناء parse_and_validate(text, schema). الـ schema هو dict يربط كل حقل مطلوب بنوع الـ Python الخاص به، مثل {"name": str, "age": int}. يجب أن تقوم الـ function الخاصة بك بما يلي:
json.loadsالنص إلى كائن Python.- تأكد من أنه ليس
dict-> مصفوفة JSON أو رقم مجرد هو السجل الذي طلبته. - لكل حقل في schema: تحقق من أنه present (أظهر خطأ في حال فقدان حقل) وأنه من right type (أظهر خطأ في حال عدم التطابق).
- أعد dict من نوع typed يحتوي على تلك الحقول فقط.
فخ bool-is-int. في Python، bool هو subclass من int، لذا isinstance(True, int) هو True. يقوم JSON true بفك التشفير إلى Python True. إذا كان schema الخاص بك يريد int لـ age وأرسل model قيمة "age": true، فإن فحص isinstance بسيط سيسمح بمرورها. احمِ النظام منها: عندما يكون النوع المتوقع هو int، ارفض قيمة bool صراحة.
if expected is int and isinstance(value, bool):
raise ValueError("age must be int, got bool")أطلق استثناء واضح (استثناء ValueError مع رسالة تحدد الحقل الخاطئ) حتى يتمكن المستدعي من تسجيل ما أخطأ فيه النموذج بالضبط. ابنِ الكود بحيث يمر طلبان مختلفان صحيحان، بينما يطلق كل من الحقل المفقود، والنوع الخاطئ، و bool الخفي استثناء.
اكتب parse_and_validate(text, schema) حيث schema هو dict من نوع {field: type}. اكتب json.loads النص، وتأكد أنه dict، ثم لكل حقل في schema تحقق من وجوده ونوعه الصحيح، مع إرجاع typed dict. يجب إثارة خطأ في حال فقدان الحقول أو اختلاف الأنواع. ارفض JSON true حيث يكون int مطلوبا (فخ bool-is-int).
سيفتح هذا التمرين قريبا
أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.
يقوم هذا المتصفح بحظر ملفات تعريف الارتباط لـ learn.floati.life، لذا لا يمكن فتح الدروس التي أنهيتها هنا بالترتيب. اسمح بملفات تعريف الارتباط لهذا الموقع وأعد التحميل.