استراتيجية Output Specifications
تحديد مواصفات المخرجات

• تحديد ستة محاور لأي مواصفة مخرجات: الصيغة، الطول، البنية، لغة الحقول، سلوك النقص، وما يُمنع.
• كتابة مخطط JSON صارم يمنع النموذج من اختراع حقول أو قيم خارج القائمة المسموحة.
• التعامل مع البيانات الناقصة بقاعدة صريحة بدل ترك النموذج يخمّن.
• تفعيل Structured Outputs في OpenAI Platform وربطه بالمواصفة المكتوبة في الأمر.

المجال: الموارد البشرية. المطلوب تحويل سيرة ذاتية نصية إلى صف بيانات يدخل جدول المتقدمين مباشرة. الفرق هنا ليس في جمال الرد، بل في كونه صالحًا للتحليل البرمجي أم لا.

استخرج أهم البيانات من السيرة الذاتية التالية:
محمد عبد الرحمن — مهندس برمجيات. عملت 4 سنوات في تطوير الواجهات باستخدام React وTypeScript، وسنتين قبلها في الدعم الفني. حاصل على بكالوريوس حاسبات 2018. متاح للعمل عن بُعد. للتواصل: 0100xxxxxxx

استخرج بيانات المتقدم من النص داخل <السيرة> وأخرجها بهذه المواصفة:

الصيغة: JSON صالح فقط. لا نص قبله ولا بعده، ولا علامات تنسيق.
الحقول بالترتيب: full_name (نص) · title (نص) · total_years (عدد صحيح) · skills (مصفوفة نصوص، 5 عناصر كحد أقصى) · degree_year (عدد صحيح) · remote_ok (منطقي) · seniority (من: junior / mid / senior فقط) · contact_email (نص) · contact_phone (نص)

قواعد:
— أي حقل غير مذكور صراحةً في النص = null. لا تستنتج ولا تخمّن ولا تُكمل من معرفتك العامة.
— skills تُدرج كما وردت حرفيًا في النص فقط.
— total_years = مجموع سنوات الخبرة المذكورة عدديًا فقط.
— seniority: أقل من 3 = junior، من 3 إلى 7 = mid، أكثر من 7 = senior.

<السيرة>
محمد عبد الرحمن — مهندس برمجيات. عملت 4 سنوات في تطوير الواجهات باستخدام React وTypeScript، وسنتين قبلها في الدعم الفني. حاصل على بكالوريوس حاسبات 2018. متاح للعمل عن بُعد. للتواصل: 0100xxxxxxx
</السيرة>

المجال: التعليم. المطلوب بنك أسئلة اختيار من متعدد يُستورد إلى منصة تعليمية. هنا لا يكفي ضبط الصيغة؛ يجب ضبط خصائص المحتوى نفسه: عدد البدائل، وتوزيع الإجابة الصحيحة، ومنع الأنماط التي تفضح الحل.

اكتب 3 أسئلة اختيار من متعدد عن دورة المياه في الطبيعة.

أنشئ ثلاثة أسئلة اختيار من متعدد عن دورة المياه، بهذه المواصفة:

الصيغة: مصفوفة JSON فقط، بلا نص خارجها.
حقول كل عنصر: id (عدد) · stem (نص، لا يتجاوز 20 كلمة) · options (أربعة نصوص) · answer_index (0–3) · rationale (نص، جملة واحدة) · bloom_level (من: تذكر / فهم / تطبيق فقط)

قواعد المحتوى:
— البدائل الثلاثة الخاطئة يجب أن تكون معقولة وتنتمي لنفس المجال، لا كلمات عشوائية.
— يجب أن تتوزع answer_index على ثلاث قيم مختلفة بين الأسئلة الثلاثة.
— يُمنع أن يكون الخيار الصحيح أطول من غيره بأكثر من ثلاث كلمات.
— يُمنع استخدام «كل ما سبق» أو «لا شيء مما سبق».
— سؤال واحد على الأقل من مستوى «تطبيق».

في الـ Playground، المواصفة تُكتب في مكانين لا مكان واحد: نصًّا داخل رسالة النظام حتى يفهم النموذج المنطق، ومخططًا في Response format حتى يُفرض عليه الشكل. النص وحده يُخالَف أحيانًا، والمخطط وحده يعطيك شكلًا صحيحًا بمحتوى ضعيف.

{
  "name": "applicant",
  "strict": true,
  "schema": {
    "type": "object",
    "properties": {
      "full_name":     { "type": ["string", "null"] },
      "total_years":   { "type": ["integer", "null"] },
      "skills":        { "type": "array", "items": { "type": "string" }, "maxItems": 5 },
      "remote_ok":     { "type": ["boolean", "null"] },
      "seniority":     { "type": "string", "enum": ["junior", "mid", "senior"] },
      "contact_email": { "type": ["string", "null"] }
    },
    "required": ["full_name", "total_years", "skills", "remote_ok", "seniority", "contact_email"],
    "additionalProperties": false
  }
}

1. فعّل Response format ثم اختر json_schemaستجده في العمود الجانبي للـ Playground. الوضع الافتراضي نص حر، ووضع json_object يضمن JSON صالحًا فقط دون ضمان الحقول، أما json_schema فهو الذي يفرض بنيتك أنت حرفًا بحرف.
2. اضبط strict على trueهذا هو البند الذي يحوّل المخطط من رجاء إلى إلزام. بدونه قد يخرج النموذج حقلًا إضافيًا أو يبدّل نوع قيمة، وستكتشف ذلك بعد أن يسقط نظامك على سيرة رقم 400.
3. أغلق الباب أمام الحقول المخترعةadditionalProperties: false تمنع أي حقل خارج قائمتك، و enum تحصر القيم في مجموعة مغلقة. هذان السطران يوفّران عليك نصف شفرات التحقق التي كنت ستكتبها لاحقًا.
4. اجعل الحقول الناقصة null صراحةًاستخدم النوع المزدوج ["string", "null"] وضع الحقل في required. بهذا يظهر الحقل دائمًا بقيمة null بدل أن يختفي — والفرق كبير: الحقل المفقود يكسر الكود، والقيمة الفارغة يتعامل معها الكود بسهولة.
5. صفّر درجة الحرارةمهام الاستخراج والتنسيق لا تحتاج تنوعًا. الصفر مع مخطط صارم يعطيك أقرب ما يكون إلى ناتج قابل للتكرار، وهو ما يسمح لك بمقارنة نسختين من الأمر مقارنة عادلة.
6. اختبر على الحالة الفارغةشغّل الأمر على نص ناقص عمدًا (سيرة بلا سنوات خبرة ولا بريد). النموذج الذي يخترع رقمًا هنا سيخترعه في الإنتاج. هذا الاختبار الواحد يكشف أضعف بند في مواصفتك: بند سلوك النقص.

• المخرَج غير المحدد المواصفات ليس خطأ النموذج، بل فراغ تركته أنت فملأه هو.
• ستة محاور تضبط أي مخرَج: الصيغة، البنية، الطول، القيم المسموحة، سلوك النقص، الممنوعات.
• أخطر بند هو سلوك النقص، لأن التخمين المعقول لا يبدو خطأً حتى يتراكم.
• اكتب المواصفة نصًّا وافرضها مخططًا: النص يشرح المنطق، والمخطط يضمن الشكل.
• هذه الاستراتيجية هي الجسر بين «أستخدم النموذج» و«بنيت به نظامًا».