قد ينجح الرد في التحول إلى JSON، لكنه يفشل عند إدخاله إلى التطبيق لأن اسم حقل تغير أو قيمة تصنيف جاءت خارج الخيارات المسموحة. المخرجات المنظمة تضيف الالتزام بمخطط محدد إلى صلاحية التنسيق، مع بقاء مراجعة صحة المعلومات مسؤولية التطبيق. هذا شرح للتحضير لعام 2027 وفق الخصائص المتاحة وقت الرصد في 28 أكتوبر 2026، وليس إعلانًا عن قواعد أو إمكانات مستقبلية.
الفرق بين JSON صالح ومخرجات تتبع مخططًا
وضع JSON mode يطلب كائن JSON صالحًا للتحليل، لكنه لا يضمن مطابقة حقوله للمخطط الذي يريده برنامجك. أما Structured Outputs فتتيح تحديد JSON Schema للرد. في Responses API تكون إعدادات الرد داخل text.format، مع النوع json_schema واسم للمخطط والمخطط نفسه وstrict: true.
لا تخلط هذا المسار باستدعاء الدوال. إذا كان الهدف أن يطلب النموذج تنفيذ وظيفة في تطبيقك، مثل استعلام قاعدة بيانات، فالمسار المناسب هو function calling. وإذا كنت تريد استخراج بيانات أو تصنيف نص في بنية يستهلكها برنامجك، فتنسيق الرد المنظم هو المسار المقصود هنا.
كيف تبني مخططًا مقبولًا؟
- اجعل جذر المخطط كائنًا من نوع
object، لا اتحادًا من نوعanyOfفي الجذر. - ضع جميع الحقول ضمن
required. ولتمثيل حقل قد لا توجد له قيمة، اسمح بالنوعnullإلى جانب نوعه الأساسي، بدل تركه اختياريًا خارج القائمة. - أضف
additionalProperties: falseإلى كل كائن، بما في ذلك الكائنات المتداخلة، لمنع مفاتيح إضافية غير معرّفة. - استخدم أسماء واضحة ووصفًا مفيدًا للحقول، ولا تفترض دعم كل كلمات JSON Schema. المخطط غير المدعوم مع الوضع الصارم يؤدي إلى خطأ في الطلب.
مثلًا، يمكن لاستخراج بيانات منتج أن يحتوي حقول الاسم والتصنيف والسعر. إذا لم يذكر النص السعر، فاسمح له بقيمة null، ووجّه النموذج إلى استخدامها عند غياب المعلومة. وجود حقل مطلوب لا ينبغي أن يتحول إلى سبب لاختراع سعر.
حدود الحجم ليست حدودًا لطول الإجابة
تسمح القيود الموثقة للمخطط بما يصل إلى 5000 خاصية إجمالًا و10 مستويات من التداخل. ويبلغ الحد الإجمالي لأطوال أسماء الخصائص والتعريفات وقيم enum وconst نحو 120000 محرف. كما يصل إجمالي قيم enum إلى 1000 قيمة؛ وإذا تجاوزت قائمة نصية واحدة 250 قيمة، فلا يتجاوز مجموع أطوال قيمها 15000 محرف. هذه حدود لبنية المخطط، وليست ميزانية رموز للرد.
بعض قيود النصوص والأرقام والمصفوفات متاحة، لكن دعم النماذج المضبوطة دقيقًا يختلف. راجع توافق النموذج والمخطط الفعلي قبل تعميم إعداد نجح مع نموذج آخر، خصوصًا عند استخدام قيود مثل pattern أو minimum أو minItems.
افصل الرفض والرد المقطوع عن البيانات
لا تبدأ بتحليل النتيجة كأنها سجل أعمال مكتمل. افحص حالة الرد أولًا: قد تكون incomplete بسبب بلوغ حد رموز الإخراج، وقد يظهر محتوى من نوع refusal بدل البيانات المتوقعة. عالج هاتين الحالتين في مسار مستقل، ولا تحفظ JSON جزئيًا أو رسالة رفض داخل الحقول المطلوبة.
تساعد مكتبات Python وJavaScript الرسمية في تعريف البنية وتحليلها، لكن نجاح التحليل لا يثبت صحة القيم. اختبر نصًا لا علاقة له بالمهمة، وسعرًا مفقودًا، ورفضًا، وردًا مقطوعًا، ثم تحقق من القيم المهمة مقابل أصلها. مطابقة المخطط تحمي شكل البيانات؛ ولا تثبت صدقها أو ملاءمتها لاتخاذ قرار.
