Home/Prompt Engineering/المخرجات المهيكلة في النماذج اللغوية الكبيرة: وضع JSON وأمثلة ومتى تستخدمه

Techniques

المخرجات المهيكلة في النماذج اللغوية الكبيرة: وضع JSON وأمثلة ومتى تستخدمه

Last updated: April 2026·١٠ دقائق للقراءة·By Hans Kuepper · Founder of PromptQuorum, multi-model AI dispatch tool · PromptQuorum

اقرأ بـ:

🇺🇸en 🇩🇪de 🇫🇷fr 🇯🇵ja 🇨🇳zh 🇪🇸es 🇧🇷pt 🇸🇦ar

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

Key Takeaways

تُحسّن الموثوقية: المخرجات المهيكلة تُقلّل أخطاء التحليل بإلزام مخططات صارمة.
تُتيح الأتمتة: وضع JSON يُفعّل المنطق الشرطي بناءً على الحقول المستخرجة (الأولوية والفئة والإلحاح).
جاهزة لواجهات برمجة التطبيقات: تكامل مباشر مع قواعد البيانات وأنظمة CRM والأنظمة التجارية دون إعادة تنسيق.
تعتمد على النموذج: وضع JSON الأصيل متاح في GPT-5.5 وClaude وGemini؛ النماذج الأقدم أو مفتوحة المصدر تحتاج هندسة برومبت.
الأفضل للمهام الحتمية: واجهات برمجة التطبيقات والأتمتة وخطوط أنابيب البيانات. تجنّب للكتابة الإبداعية أو التفكير المفتوح.
يتطلب التحقق: دائماً حلّل وتحقق من مخرج JSON قبل استخدامه في الأنظمة اللاحقة.
يتوسّع عبر النماذج: عرّف المخطط مرة واحدة؛ اختبر ووثّق الفروق بين OpenAI وAnthropic وGoogle والمزودين مفتوحي المصدر.

المخرجات المهيكلة هي طريقة لإجبار النماذج اللغوية على إعادة البيانات بصيغة محددة مسبقاً (كـJSON)، مما يُتيح تحليلاً موثوقاً وأتمتة وتكاملاً في أنظمة البرمجيات. تختلف عن النص الحر بإلزام أسماء حقول صارمة وأنواع بيانات ومخططات يمكن للأدوات اللاحقة معالجتها دون تنظيف يدوي.

هنا مثال بسيط على مخرجات مهيكلة بصيغة JSON:

json

{
  "task": "summarize",
  "title": "Quick AI Guide",
  "summary": "This article explains structured output and JSON mode.",
  "key_points": ["JSON enforces format", "Reduces parsing errors", "Enables automation"],
  "audience_level": "intermediate",
  "confidence": 0.95
}

ما هي المخرجات المهيكلة

المخرجات المهيكلة تعني طلب النموذج اتباع مخطط ثابت — كالقوائم أو الجداول أو JSON — حتى تستطيع الأدوات اللاحقة تحليل النتائج بشكل موثوق. بدلاً من فقرة حرة، تُعرّف الحقول والأنواع والقيم المسموح بها.

يمكن أن تتخذ المخرجات المهيكلة عدة أشكال:

قوائم نقطية بعدد ثابت من العناصر.
جداول Markdown بأعمدة محددة.
أزواج مفتاح-قيمة للسمات البسيطة.
كائنات أو مصفوفات JSON كاملة بمفاتيح محددة مسبقاً.

الهدف دائماً هو نفسه: تحويل وصف غامض ("بعض ملاحظات الاجتماع") إلى شكل قابل للتنبؤ ("العنوان والتاريخ والحضور والقرارات والمخاطر").

ما هو وضع JSON

وضع JSON هو نوع أكثر صرامة من المخرجات المهيكلة حيث يُوجَّه النموذج — أو يُضبط — لإعادة JSON صالح فقط. في وضع JSON، كل ما يُنتجه النموذج يجب أن يكون قابلاً للتحليل كـJSON دون تنظيف إضافي.

قد يبدو مخطط JSON نموذجي هكذا:

json

{
  "title": "string",
  "summary": "string",
  "tags": ["string"],
  "priority": "low | medium | high"
}

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

لماذا تهم المخرجات المهيكلة ووضع JSON

تهم المخرجات المهيكلة ووضع JSON لأنهما يُتيحان تحويل النماذج اللغوية إلى مكونات لأنظمة أكبر، وليس مجرد مساعدات دردشة. عندما تكون المخرجات قابلة للتنبؤ، يمكنك:

تغذية النتائج مباشرة إلى قواعد البيانات أو أنظمة CRM أو أدوات التحليل.
تفعيل أتمتة مبنية على حقول مثل `priority` أو `status` أو `confidence`.
إنشاء واجهات تعرض نتائج النموذج في بطاقات أو جداول أو لوحات تحكم دون تنسيق يدوي.

كما تُسهّل تصحيح البرومبتات. إذا فشل الهيكل، تعرف أن المشكلة في البرومبت أو المخطط، وليس في بُعد غامض من "الجودة".

وضع JSON مقابل استدعاء الوظائف مقابل برومبت المخطط

ثمة ثلاثة طرق للحصول على مخرجات مهيكلة من النماذج اللغوية الكبيرة. لكل منها نقاط قوة وضعف مختلفة:

وضع JSON: النموذج يُعيد JSON صالحاً فقط. الأفضل لـ: استخراج البيانات والتصنيف والتلخيص. القيد: محدود بصيغة المخرج، بدون تنفيذ أدوات.
استدعاء الوظائف: النموذج يختار أي وظيفة يستدعي ويُقدّم الحجج بـJSON. الأفضل لـ: تكامل واجهات برمجة التطبيقات وسير العمل العملياتي ومهام الوكيل. القيد: يتطلب مخططات وظائف محددة مسبقاً.
برومبت المخطط: تعليمات صريحة وأمثلة تطلب من النموذج اتباع مخطط. الأفضل لـ: المرونة والنماذج مفتوحة المصدر والصيغ المخصصة. القيد: موثوقية ~80–85٪، بدون ضمان على مستوى واجهة برمجة التطبيقات.

مثال: نص حر مقابل JSON مهيكل

يتضح الفرق عند مقارنة برومبت نص حر مع برومبت JSON مهيكل لنفس المهمة. هنا نُصنّف ونلخّص بريداً إلكترونياً من عميل.

برومبت سيئ

"اقرأ هذا البريد الإلكتروني من العميل ولخّص ما يريده."

برومبت جيد – وضع JSON

"أنت مساعد دعم عملاء. اقرأ البريد الإلكتروني من العميل أدناه واستخرج المعلومات الرئيسية في كائن JSON. المتطلبات: أعد JSON صالحاً فقط بمفاتيح بين علامات اقتباس مزدوجة وقيم نصية. لا تُدرج أي شرح أو نص إضافي خارج JSON. إذا كانت القيمة مفقودة، استخدم سلسلة فارغة. مخطط JSON: { "issue_type": "string", "urgency": "low | medium | high", "summary": "string (أقصى 25 كلمة)", "customer_sentiment": "negative | neutral | positive" } البريد الإلكتروني من العميل: الصق نص البريد الإلكتروني هنا"

النسخة "الجيدة" تُعرّف المخطط والقيم الصالحة ومتطلب JSON فقط، مما يجعل المخرج سهل التحليل والاستخدام في الأنظمة الأخرى.

أفضل الممارسات للمخرجات المهيكلة ووضع JSON

للحصول على مخرجات مهيكلة موثوقة، يجب أن تكون صريحاً ومتسقاً وصارماً في برومبتاتك. بعض الممارسات تُساعد كثيراً:

أظهر المخطط الدقيق الذي تتوقعه بما في ذلك القيم المسموح بها للتعدادات.
وضّح صراحةً أنه لا يجب إعادة أي شيء إلا JSON (أو البنية).
استخدم أسماء مفاتيح قصيرة وغير غامضة (مثل `issue_type` و`urgency` و`summary`).
أضف أمثلة على مخرجات صالحة عندما تكون المهمة معقدة أو حساسة.
للبنى المتداخلة، ابنها خطوة بخطوة واختبر بمدخلات حقيقية.
استخدم أطر عمل تركّز على المواصفات مثل SPECS أو RTF مع قيود التنسيق لترميز المخططات مباشرة في البرومبتات.

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

مقارنة النماذج: امتثال JSON حسب المزود

تمتلك النماذج المختلفة مستويات مختلفة من الدعم الأصيل لوضع JSON. اعتباراً من أبريل 2026، هكذا تُصنَّف المزودون الرئيسيون:

النموذج	وضع JSON الأصيل	الامتثال بالبرومبت فقط	ملاحظات
OpenAI GPT-5.5	نعم (مُلزَم)	غير ضروري	معيار الصناعة لوضع JSON؛ معدل نجاح > 99٪.
Anthropic Claude Sonnet 4.6	نعم (مُلزَم)	غير ضروري	امتثال JSON ممتاز؛ يدعم البنى المتداخلة المعقدة.
Google Gemini 2.0	نعم (مُلزَم)	غير ضروري	دعم JSON أصيل؛ استنتاج سريع.
Meta Llama 3.3 70B	جزئي	موصى به بشدة	مفتوح المصدر؛ يعمل بشكل جيد مع برومبتات مفصّلة وأمثلة.
Mistral Large	جزئي	موصى به	سلوك JSON جيد؛ اختبر مع مخططك المحدد.
GPT-3.5 القديم، Claude 2	لا	مطلوب	يتطلب هندسة برومبت متينة؛ معدل نجاح ~80–85٪.
نماذج صغيرة مفتوحة المصدر (<13B)	لا	مطلوب مع أمثلة	تحتاج مخططات مفصّلة وأمثلة متعددة؛ معدل نجاح ~60–70٪.

المخرجات المهيكلة في البيئات المنظّمة

المخرجات المهيكلة ذات قيمة خاصة في الصناعات المنظّمة لأنها تُلزم باستخراج بيانات متسق وسجلات تدقيق وتوثيق امتثال. تختلف المتطلبات باختلاف المناطق:

الاتحاد الأوروبي (GDPR، قانون الذكاء الاصطناعي): المخرجات المهيكلة تتيح التصنيف المنهجي للبيانات وتتبع حق الحذف. وضع JSON يُتيح وسم الحقول التي تحتوي على بيانات شخصية، مما يُسهّل تقييمات أثر حماية البيانات وعمليات تدقيق الامتثال.
دول الخليج العربي والعالم العربي (أطر الامتثال المحلية): يدعم الاستخراج المهيكل مع تعريفات مخطط واضحة متطلبات الشفافية والمساءلة. يتيح وضع JSON تصنيف المحتوى الحساس بشكل منهجي للامتثال للوائح المحلية.
الأسواق الناشئة (متطلبات إقامة البيانات): المخرجات المهيكلة تُساعد في إدارة إقامة البيانات وتسجيل المحتوى. وضع JSON يُتيح التصنيف المنهجي للبيانات الخاضعة لمتطلبات التخزين المحلية.

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

تجنّب هذه الأخطاء الشائعة عند تنفيذ المخرجات المهيكلة ووضع JSON:

مخططات غامضة: قول "استخرج النقاط الرئيسية" دون تحديد مخطط يؤدي إلى مخرجات غير متسقة. حدّد دائماً أسماء الحقول والأنواع والقيود الدقيقة.
غياب الأمثلة: توفير وصف المخطط فقط دون أمثلة يسبب معدلات فشل 20–30٪. أظهر دائماً 1–3 أمثلة على مخرجات صالحة.
عدم التحقق من المخرج: افتراض أن النموذج سيُعيد دائماً JSON صالحاً يؤدي إلى أخطاء تحليل في الإنتاج. تحقق دائماً وتعامل مع إخفاقات التحليل بلطف.
عدم معالجة الحالات الحافة: الحقول التي قد تكون مفقودة أو غامضة أو خارج النطاق يجب أن يكون لها سلوك احتياطي محدد (null أو سلسلة فارغة أو قيمة افتراضية).
الاختبار بمدخلات سهلة فقط: بيانات العالم الحقيقي فوضوية. اختبر مخططك مع الحالات الحافة: رسائل بريد إلكتروني ناقصة وأحرف خاصة ولغات مختلطة ومدخلات طويلة جداً.

متى تستخدم وضع JSON مقابل البدائل

اختر وضع JSON عندما تحتاج إلى إلزام صارم بالمخطط ومخرجات حتمية. تجنّبه عندما تكون الإبداعية والتفكير المفتوح هو ما يهم.

✓ استخدم وضع JSON: مطلوب مخطط صارم وخطوط أنابيب أتمتة وتكامل واجهات برمجة التطبيقات واستخراج البيانات ومهام التصنيف والمخرجات الحتمية والأنظمة الإنتاجية التي تتطلب التحقق.
✗ تجنّب وضع JSON: الكتابة الإبداعية والتفكير المفتوح والعصف الذهني والمقالات وتوليد الكود (استدعاء الوظائف أفضل) والأسئلة الفلسفية والمحتوى السردي.
البديل: استخدم استدعاء الوظائف عندما تحتاج إلى تكامل الأدوات وسير العمل العملياتي (النموذج يختار أي وظيفة يستدعي).
البديل: استخدم برومبت المخطط عندما تحتاج إلى مرونة أو تعمل مع نماذج مفتوحة المصدر أو لا تحتاج إلى ضمانات على مستوى واجهة برمجة التطبيقات.

متى يجب استخدام المخرجات المهيكلة؟

تتألق المخرجات المهيكلة في ثلاثة سيناريوهات رئيسية. استخدمها عندما تحتاج نتائج حتمية وقابلة للقراءة الآلية:

واجهات برمجة التطبيقات والتكامل: وصّل مخرج النموذج اللغوي مباشرة بالأنظمة اللاحقة (قواعد البيانات وأنظمة CRM ولوحات التحكم). المخرجات المهيكلة تمنع أخطاء التحليل والتنظيف اليدوي. مثال: استخراج بيانات العملاء من رسائل البريد الإلكتروني وكتابتها في نظام CRM.
الأتمتة وسير العمل: تفعيل الإجراءات بناءً على حقول مخرج النموذج (الأولوية والإلحاح والفئة). وضع JSON يضمن استخراج موثوقاً للحقول للمنطق الشرطي. مثال: توجيه تذاكر الدعم حسب مستوى الإلحاح.
خطوط أنابيب البيانات: معالجة البيانات بالجملة (المستندات والرسائل الإلكترونية والسجلات) على نطاق واسع. المخططات المتسقة تُتيح المعالجة الدُفعية والتحقق ومعالجة الأخطاء. مثال: استخراج البيانات الوصفية من 10,000 مقالة بحثية في قاعدة بيانات قابلة للبحث.

كيفية استخدام المخرجات المهيكلة ووضع JSON

1
لاستخراج البيانات والمخرجات القابلة للقراءة الآلية، استخدم وضع JSON (متاح في OpenAI GPT-5.5 وAnthropic Claude وGoogle Gemini وغيرهم). يضمن هذا أن يُعيد النموذج JSON صالحاً وليس نثراً. مثال: استخرج معلومات المنتج كـJSON بالمفاتيح: الاسم والسعر والوصف والتقييم.
2
عرّف مخطط JSON بشكل صريح بما في ذلك أسماء الحقول وأنواع البيانات والقيود. مثال: { "name": string, "price": number (≥ 0), "in_stock": boolean, "tags": مصفوفة من السلاسل }.
3
وفّر مثالاً على بنية JSON الدقيقة التي تريدها. مثال: { "issue": "memory leak", "severity": "critical", "suggested_fix": "...", "code_snippet": "..." }. الأمثلة أقوى من أوصاف المخططات.
4
للبنى المتداخلة (كائنات داخل مصفوفات)، كن صريحاً بشأن التسلسل الهرمي. وفّر مثالاً كاملاً على JSON يتضمن مصفوفات متداخلة.
5
تحقق من مخرج JSON قبل استخدامه في الأنظمة اللاحقة. حلّل JSON المُعاد وتحقق: (1) نحو JSON صالح، (2) جميع الحقول المطلوبة موجودة، (3) أنواع البيانات تطابق المتوقع. تعامل مع أخطاء التحليل بلطف.

هنا مثال كامل على JSON مع مصفوفات متداخلة يُظهر التسلسل الهرمي الصحيح:

json

{
  "articles": [
    {
      "title": "string",
      "author": "string",
      "citations": [
        {
          "title": "string",
          "year": "number"
        }
      ]
    }
  ]
}

قراءات ذات صلة

وسّع معرفتك بهذه المواضيع المرتبطة بهندسة البرومبت:

البرومبت بالقيود — يُلزم بصيغ مخرج محددة وميزانيات رموز.
إطار SPECS — برومبتات تركّز على المواصفات لسلوك موثوق للنموذج.
RAG موضَّح — يجمع الاستخراج المهيكل مع استرداد البيانات في الوقت الحقيقي.
سلسلة الأفكار — التفكير خطوة بخطوة قبل إعادة المخرجات المهيكلة.
قوالب البرومبت — أنماط قابلة لإعادة الاستخدام لمهام المخرجات المهيكلة الشائعة.
Zero-Shot مقابل Few-Shot — متى تُحسّن الأمثلة (few-shot) امتثال JSON.

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

ما الفرق بين المخرجات المهيكلة ووضع JSON؟

المخرجات المهيكلة هي الفئة الأوسع لطلب إعادة البيانات بصيغة ثابتة (قوائم أو جداول أو أزواج مفتاح-قيمة أو JSON). وضع JSON هو نوع أكثر صرامة يُلزم بمخرج JSON صالح، غالباً بضمانات على مستوى واجهة برمجة التطبيقات من مزود النموذج.

هل تدعم جميع النماذج اللغوية الكبيرة وضع JSON؟

لا. OpenAI GPT-5.5 وAnthropic Claude Sonnet 4.6+ وGoogle Gemini تدعم وضع JSON الأصيل. النماذج الأقدم والنماذج مفتوحة المصدر قد تتطلب تطبيقاً قائماً على البرومبت.

كيف أُلزم بردود JSON فقط بدون وضع JSON الأصيل؟

استخدم هندسة البرومبت: (1) صرّح صراحةً بـ"أعد JSON صالحاً فقط"، (2) وفّر مخططاً مفصلاً وأمثلة، (3) أضف تعليمة "لا تُدرج أي نص خارج JSON". معدلات النجاح تتحسن بشكل ملحوظ مع أمثلة جيدة.

ماذا يحدث إذا أعاد النموذج JSON غير صالح؟

تحقق من JSON من جهتك باستخدام محلل. إذا فشل، أعد المحاولة بطلب أكثر وضوحاً أو العودة إلى الاستخراج اليدوي. مع هندسة برومبت جيدة وأمثلة مخططات، معدلات الفشل منخفضة (عادةً < 5٪ للبرومبتات المصممة جيداً).

هل يمكن استخدام المخرجات المهيكلة للمستندات المعقدة؟

نعم. قسّم المهام المعقدة إلى خطوات: استخرج الحقول الرئيسية أولاً، ثم تحقق، ثم حوّل اختيارياً في الأنظمة اللاحقة. تقسيم المستندات الكبيرة ومعالجتها بشكل منفصل عادةً يُحسّن الموثوقية ويُقلّل استخدام الرموز.

كيف أتعامل مع البيانات المفقودة أو الغامضة في المخرجات المهيكلة؟

عرّف سلوك الاحتياطي في مخططك: استخدم سلاسل فارغة أو قيم null أو علامة خاصة مثل "مجهول". أضف التعليمة: "إذا كانت القيمة غامضة أو مفقودة، استخدم null بدلاً من التخمين."

هل وضع JSON متأثر بالامتثال التنظيمي (GDPR وما شابه)؟

وضع JSON في حد ذاته محايد. ومع ذلك، المخرجات المهيكلة مفيدة للامتثال لأنها تُتيح تتبع البيانات المستخرجة والمحوّلة والمسجلة بشكل منهجي، وهو أمر بالغ الأهمية لسجلات التدقيق.

كيف أختبر البرومبتات في وضع JSON؟

اختبر بمدخلات متنوعة: حالات حافة وبيانات غامضة وأمثلة من الواقع. حلّل المخرج وتحقق: (1) JSON صالح، (2) مخطط صحيح، (3) أنواع بيانات متوقعة. استهدف معدل نجاح ≥95٪ قبل النشر في الإنتاج.

هل يمكن إعادة استخدام مخططات المخرجات المهيكلة عبر النماذج المختلفة؟

نعم، مع الحذر. عرّف مخططك مرة واحدة واختبره على نماذج مختلفة؛ قد تحتاج إلى ضبط البرومبتات للنماذج الأقدم أو الأصغر. وثّق أي اختلافات خاصة بالنموذج ومعدلات النجاح.

ما تكلفة الأداء لوضع JSON؟

ضئيلة. وضع JSON الأصيل (OpenAI وAnthropic وGoogle) له تأثير أداء ضئيل جداً. التطبيق بالبرومبت فقط قد يُضيف زمن استجابة 5–10٪ بسبب تكاليف شرح المخطط، لكن مكاسب الأمان عادةً تُبرر ذلك.

المصادر

توثيق وضع JSON من OpenAI — الدليل الرسمي لوضع JSON في واجهة برمجة تطبيقات OpenAI.
دليل المخرجات المهيكلة من Anthropic — توثيق Anthropic للمخرجات المهيكلة في Claude.
واجهة برمجة تطبيقات Google Gemini – المخرجات المهيكلة — دعم وضع JSON الأصيل من Google في Gemini 2.0.
مواصفة JSON Schema — المواصفة القياسية لتصميم وتحقق JSON Schema.

Apply these techniques with a local LLM or your own API keys — PromptQuorum works with any backend.

Try PromptQuorum free →

← Back to Prompt Engineering