---
title: "ما هو JSON Schema؟ وصف بنية JSON لمخرجات LLM | BroadRouter"
description: "JSON Schema معيار لوصف بنية بيانات JSON. كيف تستخدمه واجهات LLM API لمعاملات الأدوات وللمخرجات المنظَّمة، وأي الكلمات المفتاحية تدعمها."
url: https://broadrouter.com/ar/glossary/json-schema/
lang: ar
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/glossary/json-schema/) (حُدّث في 2026-11-15).

# مخطط JSON (JSON Schema)

آخر تحديث 2026-11-15

JSON Schema (مخطط JSON) مفردات مكتوبة بصيغة JSON لوصف بنية بيانات JSON والتحقق منها: الأنواع والحقول الإلزامية والقيم المسموحة والتداخل. والإصدار الحالي هو 2020-12. وتستخدمه واجهات LLM API لتعريف معاملات الأدوات والبنية الدقيقة التي يجب أن تتبعها المخرجات المنظَّمة.

يُسمّى أيضًا: مخطط JSON، مخطط جيسون، التحقق من JSON، JSON Schema، json\_schema، JSON Schema draft 2020-12

الأمر الذي يقول “أجب بصيغة JSON” يترك البنية للصدفة. أما JSON Schema فيدوّن البنية كي تتمكن الآلة من التحقق منها.

## كيف يعمل

للمواصفة جزءان رئيسيان: Core، الذي “defines the basic foundation of JSON Schema” (ترجمة: يحدّد الأساس الذي يقوم عليه JSON Schema)، وValidation، الذي “defines the validation keywords” (ترجمة: يحدّد الكلمات المفتاحية للتحقق). والإصدار الحالي هو 2020-12، وكان الذي قبله 2019-09.

```json
{
  "type": "object",
  "properties": {
    "name":    {"type": "string"},
    "amount":  {"type": "number", "minimum": 0},
    "currency": {"type": "string", "enum": ["SAR", "AED", "USD"]},
    "note":    {"type": ["string", "null"]}
  },
  "required": ["name", "amount", "currency", "note"],
  "additionalProperties": false
}
```

تستخدم واجهات LLM API المخططات في موضعين. فتعريفات الأدوات تضع مخططًا في `parameters` لوصف الوسائط. و[المخرجات المنظَّمة](https://broadrouter.com/ar/glossary/structured-output/) ترسل مخططًا في `response_format` بالشكل `{"type": "json_schema", "json_schema": {...}}`، وتقول OpenAI إنه “ensures the model will match your supplied JSON schema” (ترجمة: يضمن أن يطابق النموذج مخطط JSON الذي قدّمته).

لا يقبل الوضع الصارم لدى OpenAI إلا مجموعة جزئية. ومن قسم المخططات المدعومة لديها:

-   الأنواع: string وnumber وboolean وinteger وobject وarray وenum وanyOf.
-   يجب أن يكون الجذر كائنًا، ولا يجوز أن يستخدم `anyOf`.
-   `additionalProperties: false` وإدراج كل حقل في `required`؛ ولجعل حقل اختياريًا اسمح له بالقيمة `null`، كما يفعل `note` أعلاه.
-   حتى 5000 خاصية للكائنات و10 مستويات من التداخل، وحتى 1000 قيمة enum إجمالًا.
-   غير مدعوم: `allOf` و`not` و`dependentRequired` و`dependentSchemas` و`if` و`then` و`else`.

## لماذا يهم

-   **التحقق.** المخطط نفسه الذي يوجّه النموذج يتحقق من رده في شيفرتك. والفحص الفاشل يعطيك خطأً دقيقًا تعيد إرساله إلى النموذج.
-   **قابلية النقل.** المخطط المكتوب ضمن المجموعة الجزئية الصارمة يعمل لدى مزوّدين أكثر من مخطط يستخدم كل الكلمات المفتاحية.
-   **الرموز.** المخططات في تعريفات الأدوات تُرسَل مدخلاتٍ مع كل طلب. والأوصاف الطويلة تكلّف رموزًا في كل دورة.

## في BroadNet Inference

يوثّق [المرجع التقني لـ BroadNet](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-json-schema&utm_content=body) استدعاء الأدوات والمخرجات المنظَّمة لنموذجي [GLM 5.3](https://broadrouter.com/ar/models/glm-5.3/) و[Qwen3.8 27B](https://broadrouter.com/ar/models/qwen3.8-27b/)، لكنه لا يذكر الكلمات المفتاحية التي تُفرَض من المخطط. التزم في مخططاتك بالمجموعة البسيطة أعلاه، وتحقّق من كل رد. أنشئ المخطط بـ [مولّد JSON Schema](https://broadrouter.com/tools/json-schema-generator/)، وافحص الردود بـ [مدقّق مخرجات JSON لنماذج اللغة](https://broadrouter.com/tools/llm-json-output-validator/)، وراجع [مقال المخرجات المنظَّمة](https://broadrouter.com/ar/blog/structured-output-json-schema/) لمثال كامل. ومع النماذج الأخرى، اطلب JSON في الأمر وتحقّق من الرد؛ فـ [وضع JSON](https://broadrouter.com/ar/glossary/json-mode/) غير موثّق لدى BroadNet، فاختبره قبل الاعتماد عليه.

## أخطاء شائعة

-   استخدام `allOf` أو الكلمات المفتاحية الشرطية مع افتراض أن الخادم يفرضها.
-   جعل الحقول اختيارية بحذفها من `required` في الوضع الصارم، بدل السماح بالقيمة `null`.

## أسئلة شائعة

### هل تدعم واجهات LLM API كل JSON Schema؟

لا. تدعم OpenAI مجموعة جزئية منه: مثلًا يجب أن يكون الجذر كائنًا، وأن يكون كل حقل إلزاميًا، وأن تكون additionalProperties بالقيمة false، والكلمات المفتاحية مثل allOf وnot وif/then/else غير مدعومة.

### ما الفرق بين JSON Schema ووضع JSON؟

لا يعد وضع JSON إلا بـ JSON صالح. أما JSON Schema فيخبر النموذج، ومدقّقك أيضًا، بالحقول والأنواع التي يجب أن يحتويها هذا الـ JSON.

### هل يمكنني استخدام JSON Schema مع BroadNet Inference؟

معاملات الأدوات والمخرجات المنظَّمة، وكلاهما يستخدم المخططات، موثّقة لنموذجي GLM 5.3 وQwen3.8 27B. ولا يوثّق BroadNet الكلمات المفتاحية التي يفرضها من المخطط، فتحقّق من كل رد.

## انظر أيضًا

-   [المخرجات المنظَّمة (Structured output)](https://broadrouter.com/ar/glossary/structured-output/) (مصطلح)
-   [وضع JSON (JSON mode)](https://broadrouter.com/ar/glossary/json-mode/) (مصطلح)
-   [استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/) (مصطلح)
-   [tool\_choice (اختيار الأداة)](https://broadrouter.com/ar/glossary/tool-choice/) (مصطلح)
-   [MCP (بروتوكول سياق النموذج)](https://broadrouter.com/ar/glossary/mcp/) (مصطلح)
-   [التعرّف على الكيانات المسماة (NER)](https://broadrouter.com/ar/glossary/named-entity-recognition/) (مصطلح)
-   [وضع JSON أم json\_schema: مخرجات منظَّمة يمكن الاعتماد عليها](https://broadrouter.com/ar/blog/structured-output-json-schema/) (مقال)
-   [إصلاح JSON غير الصالح من LLM: الأسباب والإصلاح وإعادة المحاولة](https://broadrouter.com/ar/blog/fix-invalid-json-from-llm/) (مقال)
-   [استخراج بيانات الفواتير والإيصالات والنماذج إلى JSON بنموذج رؤية](https://broadrouter.com/ar/blog/extract-data-from-documents-with-vision-llm/) (مقال)

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-json-schema&utm_content=page-cta) ·

**المصادر**

-   [مواصفة JSON Schema، الإصدار 2020-12 (Core وValidation) (رُوجع في 2026-11-15)](https://json-schema.org/specification)
-   [OpenAI، دليل المخرجات المنظَّمة (المخططات المدعومة) (رُوجع في 2026-11-15)](https://developers.openai.com/api/docs/guides/structured-outputs)
-   [مرجع OpenAI API، إنشاء إكمال محادثة (response\_format json\_schema) (رُوجع في 2026-11-15)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
