المنهج الدراسي الدرس 137 من 250 · المخرجات المهيكلة واستدعاء الوظائف/الأدوات
المخرجات المهيكلة واستدعاء الوظائف/الأدوات

إصلاح ملف JSON الخاص بالنموذج غير الصالح

ليست

نماذج مثالية لإخراج JSON. حتى في وضع JSON، تقوم بتغليف المخرجات في أسوار ```json، أو إضافة مقدمة مطولة ("بالتأكيد! إليك البيانات:"), أو ترك فاصلة في النهاية، أو استخدام علامات اقتباس فردية. يسبب json.loads خطأ في كل هذه الحالات، وفي بيئة الإنتاج يعتبر ذلك طلباً فاشلاً. خطوة repair صغيرة تستعيد معظمها بتكلفة منخفضة قبل أن تستسلم وتعيد توجيه الطلب للنموذج.

يبدو شكل المسار القوي كما يلي:

text = call_model(prompt)        # may be fenced / prose-wrapped / sloppy
try:
    data = json.loads(text)
except ValueError:
    data = repair_json(text)     # one cheap repair attempt before re-prompting

أنت تقوم ببناء repair_json(text). اتبع هذه الخطوات بالترتيب، وتوقف بمجرد نجاح json.loads:

  • إزالة سياج الكود. إذا كان الشيء بأكمله ملفوفا في ``` (اختياريا ```json)، احتفظ بالداخل فقط. تعبير regex مثل ^```[a-zA-Z]*\s*(.*?)\s*```$ مع re.DOTALL يقوم بذلك.
  • احذف النصوص المحيطة.ابحث عن أول { أو [ وآخر } أو ] المطابق، وقم بقص ذلك النطاق فقط. هذا يحذف "Sure! Here is..." قبل وأي كلام زائد بعده.
  • جرب كما هي. العديد من السلاسل صالحة الآن -> أعد مبكرا.
  • أصلح الكسور الأبسط أولا:احذف الفواصل الزائدة باستخدام re.sub(r",(\s*[}\]])", r"\1", s)، ثم json.loads مرة أخرى.
  • الخيار الأخير: تحويل علامات الاقتباس المفردة إلى علامات اقتباس مزدوجة والمحاولة مرة أخرى.
  • إذا لم يتم التحليل بعد، ارفع خطأValueError -> لا تعيد بيانات عشوائية أبدا. السلسلة غير القابلة للإصلاح هي إشارة لإعادة الطلب، وليس للتخمين.

لماذا يأتي تبديل الاقتباس في الأخير: لأنه يعيد كتابة الفواصل العليا داخل قيم string، لذا سيتعطل {"note": "it's fine",} إذا قمت بالتبديل أولا، بينما إزالة الفاصلة وحدها تصلحه. غالباً ما يحتوي مخرجات Model على فواصل عليا (أسماء مثل O'Brien، كلمات مثل it's)، لذا جرب الإصلاحات التي لا يمكنها إتلاف القيم قبل تلك التي يمكنها ذلك. حتى مع ذلك، هذا خط دفاع أول؛ عندما لا يتم تحليل رد حقيقي، فإن إعادة الطلب (أو structured outputs، التي تقيد model بـ JSON صالح) تتفوق على الإصلاح الذكي. تأكد من مرور JSON نظيف دون تغيير، وبقاء true/false كـ Python True/False، ورفع خطأ عند وجود string بدون JSON قابل للاسترداد.

دورك

اكتب repair_json(text) الذي يزيل سياج الكود ```/```json، ويحذف أي نص قبل أول {/[ وبعد آخر }/] المطابق، ثم يحاول json.loads؛ في حال الفشل، يقوم بإزالة الفواصل الزائدة ويحاول مرة أخرى؛ فقط إذا فشل ذلك أيضاً، يقوم بتحويل علامات الاقتباس المفردة إلى علامات اقتباس مزدوجة ويحاول مرة أخيرة (يأتي تبديل علامات الاقتباس في الأخير لأنه يعيد كتابة الفواصل العليا داخل القيم أيضاً)؛ إذا لم ينجح في التحليل، فإنه يرفع ValueError. يجب أن يمر JSON النظيف دون تغيير.

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

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

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