الانتقال إلى المحتوى الرئيسي
أرسل JSON Schema مع الطلب فيعيد النموذج JSON بهذا الشكل بدلًا من النص الحر. ويظل على شيفرتك تحليله والتحقق منه قبل استخدامه.

اختيار تنسيق

يعتمد موضع التنسيق على نقطة النهاية:

إرسال مخطط

يعود JSON في صورة سلسلة نصية داخل محتوى الرسالة:

تصميم المخطط

ابدأ بكائن صغير. أدرج كل حقل في required، واستخدم enum للفئات المعروفة، وعيّن additionalProperties: false عندما يجب رفض المفاتيح الإضافية. أدِر إصدارات المخطط مع المتحقِّق على الخادم معًا حتى لا يختلفا أبدًا.

التحقق من النتيجة

تحقّق من وجود رفض أو محتوى مفقود أو إجابة مبتورة (finish_reason غير stop) قبل التحليل. ثم تحقّق من الكائن المحلَّل. يطابق متحقِّق Zod هذا المخطط أعلاه:
إذا فشل التحقق، فأعد المحاولة مرة واحدة مع إدراج الخطأ في الموجّه، ثم أعِد فشلًا آمنًا. تُفرض رسوم على كل إعادة محاولة. ولا يثبت JSON الصالح أن القيم صحيحة أو أن إجراءً ما مصرّح به. تتبّع إخفاقات التحقق لكل نموذج وإصدار مخطط، وأعد تشغيل حالات التقييم لديك عندما يتغير أي منهما. لإصلاح JSON غير السليم تلقائيًا، راجع إصلاح الاستجابة.
آخر تعديل في ٥ نوفمبر ٢٠٢٦