BroadRouter
ابدأ الآن

وضع JSON (JSON mode)

آخر تحديث

وضع JSON (JSON mode) إعداد في LLM API، هو response_format {"type": "json_object"} في الواجهات على طريقة OpenAI، يجعل رد النموذج JSON صالحًا قابلًا للتحليل. وبخلاف المخرجات المنظَّمة مع JSON Schema، لا يضمن المفاتيح أو الأنواع أو القيم التي يحتويها الكائن.

يُسمّى أيضًا: وضع JSON، مخرجات JSON، رد بصيغة JSON، json_object، JSON mode، JSON output mode، JSON response mode

يجيب وضع JSON عن سؤال واحد: هل سينجح json.loads()؟ لكنه لا يجيب عن السؤال الثاني: هل هذا هو الكائن الذي تتوقعه شيفرتي؟

كيف يعمل

في Chat Completions API تفعّله بحقل واحد:

{"response_format": {"type": "json_object"},
 "messages": [
   {"role": "system", "content": "Return JSON with keys name and email."},
   {"role": "user", "content": "Reach me at Sara, sara@example.com"}]}

يصف المرجع التقني لدى OpenAI هذا بأنه “the older JSON mode, which ensures the message the model generates is valid JSON.” (ترجمة: وضع JSON الأقدم، الذي يضمن أن الرسالة التي يولّدها النموذج JSON صالح.) وتأتي معه قاعدتان. الأولى أن عليك طلب JSON في رسالة ما: يقول دليل OpenAI إن الواجهة “will throw an error if the string ‘JSON’ does not appear somewhere in the context.” (ترجمة: سترمي خطأً إن لم يظهر النص ‘JSON’ في مكان ما من السياق.) والثانية أن البنية متروكة للنموذج. إذ ينص الدليل على أن وضع JSON “will not guarantee the output matches any specific schema.” (ترجمة: لن يضمن أن تطابق المخرجات أي مخطط معيّن.)

المخرجات المنظَّمة هي الخيار الأكثر صرامة. فهي تمرّر JSON Schema عبر {"type": "json_schema", ...}، ويُقيَّد النموذج به.

وضع JSON (json_object) المخرجات المنظَّمة (json_schema)
JSON صالح نعم نعم
المفاتيح الإلزامية والأنواع لا نعم
تقدّم أنت مخططًا لا نعم
يجب ذكر “JSON” في الأمر نعم (OpenAI) لا

وتوصي OpenAI بـ “always using Structured Outputs instead of JSON mode when possible.” (ترجمة: استخدام Structured Outputs دائمًا بدل JSON mode متى أمكن.)

لماذا يهم

  • التحقق يبقى مسؤوليتك. مع وضع JSON، يمر مفتاح مفقود أو رقم أُرسل نصًا من التحليل بسلام ثم يفشل لاحقًا. تحقّق من المخرجات مقابل مخطط في الشيفرة.
  • القطع. إن بلغ الرد max_tokens، يصبح JSON ناقصًا. ونماذج الاستدلال أكثر عرضة لذلك، لأن التفكير يستهلك الميزانية نفسها.
  • الحل الاحتياطي. يذكر دليل OpenAI وضع JSON على النماذج الأقدم التي لا يتوفر فيها json_schema. والدعم يتفاوت بحسب المزوّد والنموذج، لذا فإن وضع JSON مع تحقّقك الخاص هو الحل الاحتياطي حين لا يُقبل المخطط.

في BroadNet Inference

يذكر المرجع التقني لـ BroadNet المخرجات المنظَّمة لنموذجي GLM 5.3 وQwen3.8 27B. لكنه لا يقول هل json_object أم json_schema هو قيمة response_format المدعومة، ولا هل يقبل DeepSeek V4.1 Flash وBroadNet Gemma 4 VL 26B أيًّا منهما. اختبر الاثنين على نموذجك. ولكتابة المخطط، استخدم مولّد JSON Schema. ويتناول مقال JSON mode مقابل json_schema الإصلاح والمراقبة، ويعرض دليل الفواتير استخراج JSON من الصور.

أسئلة شائعة

هل وضع JSON هو نفسه المخرجات المنظَّمة؟

لا. يقول دليل OpenAI إن كليهما يُنتج JSON صالحًا، لكن Structured Outputs وحدها تضمن الالتزام بالمخطط. أما وضع JSON فقد يُرجع أي كائن صالح.

لماذا يُرجع وضع JSON خطأً بخصوص كلمة JSON؟

تشترط OpenAI أن تطلب إنتاج JSON في مكان ما من الرسائل، وتُرجع خطأً إن لم يظهر النص "JSON" في السياق.

هل يمكن أن يُرجع وضع JSON رغم ذلك JSON معطوبًا؟

نعم، إن قُطع الرد بسبب max_tokens أو حد السياق. افحص finish_reason قبل التحليل.

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity