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

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

# المخرجات المنظَّمة (Structured output)

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

المخرجات المنظَّمة هي ميزة في LLM API تقيّد رد النموذج بصيغة يحدّدها المطوّر، عادةً JSON Schema، لكي تحلّلها الشيفرة بموثوقية. وهي أكثر صرامة من وضع JSON (JSON mode)، الذي يضمن JSON صالحًا لكن لا يضمن بنية معيّنة.

يُسمّى أيضًا: مخرجات منظمة، المخرجات المهيكلة، مخرجات JSON، مخطط JSON، structured output، structured outputs، JSON schema output، response\_format

تحتاج الشيفرة إلى مدخلات متوقعة. والمخرجات المنظَّمة تحوّل النص الحر الذي يكتبه النموذج إلى بيانات يستطيع برنامجك الوثوق بها.

## كيف تعمل

هناك ثلاثة مستويات من التحكم:

| الطريقة | ما تحصل عليه |
| --- | --- |
| الطلب في الأمر | JSON غالبًا، مع نص زائد أو حقول ناقصة أحيانًا |
| JSON mode | JSON صالح بأي بنية |
| المخرجات المنظَّمة مع مخطط | JSON يطابق مخططك |

في صيغة OpenAI، يُفعَّل JSON mode بـ `response_format: {"type": "json_object"}`. أما المخرجات المنظَّمة فتمرّر مخططًا:

```json
"response_format": {
  "type": "json_schema",
  "json_schema": {
    "name": "invoice",
    "strict": true,
    "schema": {
      "type": "object",
      "properties": {
        "vendor": { "type": "string" },
        "total": { "type": "number" }
      },
      "required": ["vendor", "total"],
      "additionalProperties": false
    }
  }
}
```

يقول المرجع التقني لدى OpenAI إن النوع `json_schema` “ensures the model will match your supplied JSON schema” (ترجمة: يضمن أن يطابق النموذج مخطط JSON الذي قدّمته). ويحقّق كثير من المزوّدين ذلك بالتوليد المقيَّد: تقييد الرموز التي يُسمح للنموذج بإنتاجها في كل خطوة، فلا يمكن توليد مخرجات تخالف المخطط.

## لماذا تهم

-   **أخطاء تحليل أقل.** تستطيع خطوط الاستخراج والمصنِّفات والوكلاء قراءة الحقول مباشرة.
-   **أوامر أبسط.** يحلّ المخطط محل تعليمات التنسيق الطويلة.
-   **ليست ضمانًا كاملًا.** يقول دليل OpenAI إن تطبيقك يجب أن يتعامل مع حالات الرفض والاستجابات غير المكتملة والأخطاء. والرد الذي قطعه [`max_tokens`](https://broadrouter.com/ar/glossary/max-tokens/) هو JSON معطوب مهما قال المخطط.

يتفاوت الدعم بين [واجهات API المتوافقة مع OpenAI](https://broadrouter.com/ar/glossary/openai-compatible-api/). بعضها لا يقبل إلا `json_schema`، وبعضها لا يقبل إلا `json_object`، وبعضها يتجاهل الحقل. تحقّق قبل أن تعتمد عليه.

## في BroadNet Inference

تذكر وثائق BroadNet المخرجات المنظَّمة لنموذجي [GLM 5.3](https://broadrouter.com/ar/models/glm-5.3/) و[Qwen3.8 27B](https://broadrouter.com/ar/models/qwen3.8-27b/). ولا تسمّي الوثائق معامل الطلب، فاختبر `response_format` على نموذجك، واحتفظ بمحلّل JSON مع معالجة للأخطاء في كل الأحوال. ويوضّح [مدقّق مخرجات JSON لنماذج اللغة](https://broadrouter.com/tools/llm-json-output-validator/) موضع انكسار الرد ويتحقق منه مقابل مخططك. ويستدل النموذجان كلاهما منطقيًا أولًا، فامنح `max_tokens` مساحة للتفكير وللـ JSON معًا.

تعمل المخرجات المنظَّمة جيدًا مع [نماذج الرؤية](https://broadrouter.com/ar/glossary/vision-language-model/). يرسل [دليل الفواتير العربية](https://broadrouter.com/ar/guides/read-arabic-invoices-with-vision/) صورة ويطلب الحقول بصيغة JSON. وللأفعال بدل الإجابات، استخدم [استدعاء الأدوات](https://broadrouter.com/ar/glossary/tool-calling/).

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

-   نسيان `additionalProperties: false`، أو عدم إدراج كل حقل في `required`، عند استخدام الوضع الصارم.
-   عدم فحص `finish_reason` قبل التحليل.

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

### ما الفرق بين JSON mode والمخرجات المنظَّمة؟

يعد JSON mode فقط بأن الرد يُحلَّل بوصفه JSON. أما المخرجات المنظَّمة مع مخطط فتعد أيضًا بالحقول والأنواع والمفاتيح الإلزامية التي حدّدتها. ويقول دليل OpenAI إن Structured Outputs وحدها تضمن الالتزام بالمخطط.

### هل ما زلت بحاجة إلى التحقق من المخرجات؟

نعم. قد يكون الرد رفضًا، أو قد يُقطع بسبب max\_tokens، ولا يستطيع المخطط التعبير عن كل قاعدة عمل، مثل إجمالي يجب أن يساوي مجموع البنود.

### هل أستخدم المخرجات المنظَّمة أم استدعاء الأدوات؟

استخدم المخرجات المنظَّمة حين تريد الإجابة النهائية بصيغة ثابتة. واستخدم استدعاء الأدوات حين ينبغي أن يطلب النموذج من شيفرتك تنفيذ شيء ثم يتابع.

## انظر أيضًا

-   [استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/) (مصطلح)
-   [max\_tokens (الحد الأقصى لرموز المخرجات)](https://broadrouter.com/ar/glossary/max-tokens/) (مصطلح)
-   [نموذج الرؤية واللغة (Vision-language model)](https://broadrouter.com/ar/glossary/vision-language-model/) (مصطلح)
-   [واجهة API متوافقة مع OpenAI (OpenAI-compatible API)](https://broadrouter.com/ar/glossary/openai-compatible-api/) (مصطلح)
-   [وضع JSON (JSON mode)](https://broadrouter.com/ar/glossary/json-mode/) (مصطلح)
-   [ضوابط الحماية (Guardrails)](https://broadrouter.com/ar/glossary/guardrails/) (مصطلح)
-   [مخطط JSON (JSON Schema)](https://broadrouter.com/ar/glossary/json-schema/) (مصطلح)
-   [قراءة الفواتير والإيصالات العربية بنموذج رؤية](https://broadrouter.com/ar/guides/read-arabic-invoices-with-vision/) (دليل)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/) (دليل)
-   [اختيار LLM API للغة العربية: ما الذي تختبره؟](https://broadrouter.com/ar/blog/choosing-an-llm-for-arabic/) (مقال)

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

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

**المصادر**

-   [OpenAI، دليل Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
-   [المرجع التقني لـ OpenAI API، إنشاء إكمال محادثة (response\_format)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [المرجع التقني لـ BroadNet Inference API، النماذج (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-structured-output&utm_content=sources#models)
