Jev 1.13 دليل تجنّب الأخطاء: 9 أنماط فشل وممارسات بديلة
في الوثائق الرسمية صفحة مميزة: وثيقة jaggedness (الحواف الخشنة) — قائمة «عيوب Jev 1.13 المعروفة» التي جمعها TypeSafe بنفسه. تبدأ بجملة Jev isn't perfect، ثم تسرد 9 نمط فشل، ومع كل نمط ممارسة بديلة. هذا الدرس ينقل الوثيقة كاملة: جدول مرجعي سريع، وتفكيك بندًا بندًا، وكود رسمي قابل للنسخ، في نحو 15 دقيقة.
هذا الدرس مستقل تمامًا ويمكن قراءته دون لمس المتصفح — مستخدمو API الخالص يمكنهم الانتقال مباشرة من الدليل المتقدم إلى هذا الدرس دون خسارة. تشير الوثيقة إلى أنها تنطبق على jev-1.13 (آخر مراجعة 2026-10-02)، وتقول الجهة الرسمية أيضًا إن كثيرًا منها سيُصلح في الإصدارات اللاحقة؛ لكن عادة طرح الأسئلة هذه — «الحساب في الكود، والتواريخ باستخراج المكوّنات، والحالة الكبيرة بالترشيح أولًا» — تستحق التكوّن مع أي إصدار.
ماذا ستستطيع أن تفعل بعد التعلم
- حفظ أسماء أنماط الفشل الرسمية الـ 9، مع قدرة على ذكر ممارسة بديلة لكل نمط (فحص ذاتي مقابل الجدول المرجعي في ملخص هذا الدرس)
- تحويل مسائل «جعل Jev يعدّ» إلى النموذج الرسمي: تكرار المرشحين في الكود، وNoul واحد لكل عنصر، والجمع في الكود
- تحويل مقارنة التواريخ إلى «النموذج يستخرج المكوّنات + الكود يجمّع»: تعداد Choice بـ 12 شهرًا و31 يومًا وسنوات محدودة النطاق، مع مخرج طوارئ «غير مذكور»
- تخفيف الحالة الكبيرة: أرسل فقط الحقول التي يحتاجها السؤال؛ وإن تعذّر الترشيح فاستخدم Noul كبوابة صلة
- إكمال الفحوص الثلاثة قبل الإطلاق: ثبات إعادة ترتيب الخيارات، وحالات الحدود، ومواءمة instructions مع criteria
معضلتك الحالية
- إجابات «تسعة صحيحة من عشرة»: نفس نوع المدخلات، لكن إجابة واحدة أحيانًا تدخل مسارًا غريبًا، دون نمط واضح، فلا تجرؤ على الإطلاق
- سؤال حكم بسيط، لكن النموذج يتصرف كأنه يعدّ ويحسب — الأرقام خاطئة دائمًا، وتغيير الصياغة لا ينفع
- تريد من Jev إخراج ملخص نصي، فتسلسل Choice لساعات، بطيء ورديء، ولا تدري هل الخطأ في الطريقة أم في النموذج
متى تستخدم هذه الطريقة
عندما تحتاج إلى:
- تجنّب أخطاء Jev 1.13 المعروفة مسبقًا عند كتابة الأسئلة، بدلًا من تتبعها حالة بحالة بعد الإطلاق
- إعادة صياغة سؤال «إجابته خاطئة» إلى سؤال متين — أربع فئات أسباب شائعة: العدّ، والتواريخ، والحالة الكبيرة، والصياغة
- تحديد من يجب أن يتولى المهمة: حكم Jev، أم حساب الكود، أم نص نموذج التوليد
ولا تريد أن:
- تتعلم فقط بعد الوقوع في الـ 9 أخطاء واحدًا واحدًا — الجهة الرسمية جربتها قبلك وكتبت الوثائق
- تتلقى درسًا من المدخلات الخصومية بعد الإطلاق: criteria غير واضحة، وحدود غير مختبرة، فينهار كل شيء حين يغذي المستخدم بيانات قذرة
🎒 التحضير قبل البدء
- أكملت Confidence درجة الثقة: تعرف أن confidence هو «ملخص لشكل توزيع الاحتمالات للإجابة نفسها» — ستعتمد تنبيهات هذا الدرس على هذا الأساس
- استخدمت أنواع الأسئلة الأساسية الثلاثة: Choice سؤال الاختيار وScore سؤال التقييم وNoul سؤال نعم/لا
- (اختياري) لديك تطبيق Jev قيد التطوير — خطوات هذا الدرس هي «خذ مشكلتك الخاصة وعدّلها»، والمكسب أكبر مع مشكلة حقيقية
- (اختياري) تريد تشغيل نموذج العدّ الرسمي: بيئة Python ≥ 3.10 مع typesafe-sdk مثبتة (دليل التثبيت)
الفكرة الأساسية
لنبدأ بالتقييم الذاتي الرسمي (مقدمة وثيقة jaggedness): jev-1.13 سريع ومعاير ومتمكن من أحكام المعرفة العامة، ويقدم أفضل أداء في مهام System One. وفي الوقت نفسه لديه ثلاث فئات من نقاط الضعف الفطرية:
| نقطة الضعف | المعنى | نمط الفشل المقابل |
|---|---|---|
| الإحالة متعددة الطبقات | المهام التي تتطلب مستويات إحالة إضافية تجهد | #4 الإحالة غير المباشرة |
| الفهم الحرفي | قد يكون الفهم حرفيًا إلى حد كبير | #1 الفهم الحرفي |
| دقة الأرقام | المهام التي تتطلب دقة رقمية ستتعثر | #2 الرياضيات والأرقام، #3 مقارنة التاريخ والوقت |
9 نمط فشل هي في الأساس الشيء نفسه: ** إسناد عمل System Two (التفكير البطيء) إلى System One (الحكم السريع) **. لذا يمكن ضغط جميع الحلول البديلة في قاعدة واحدة:
** اترك الحكم إلى Jev، والحساب إلى الكود، والتوليد إلى نماذج التوليد.**
أعطت الجهة الرسمية في نهاية الوثائق قائمة avoid بأربعة بنود، يقابل كل منها واحداً:
- ❌ سؤال النموذج عن أشياء يستطيع الكود حسابها بدقة
- ❌ إخفاء عدة أحكام داخل سؤال واحد
- ❌ مهام System Two: مزيد من طبقات غير المباشرة
- ❌ حشو state بسياق يتجاوز ما يحتاجه السؤال — بالنص الحرفي الرسمي: Jev suffers from context rot (تعفّن السياق)، فالمواد غير ذات الصلة تنفق دقتك مباشرة
💡 موقف هذه الوثائق نفسها
الجهة الرسمية لا تخفي شيئاً: تبدأ الوثائق بعبارة Jev isn't perfect، وتترك في النهاية مدخل Discord لجمع أنماط فشل جديدة. كتابة المشكلات المعروفة في وثائق مع بديل لكل منها — هذا هو الموقف الذي يجب أن تتحلى به تجاه تطبيق Jev الخاص بك: وثّق الفخاخ وأرفق طرق الالتفاف عليها.
طبّق معي
الخطوة 1: استخدم جدول 9 أنماط الفشل الرسمي لإجراء فحص Jev للفخاخ
لماذا: اعرف اسم المرض قبل تعديل السؤال. رتبت الجهة الرسمية الفخاخ المعروفة في 9 أنماط فشل، مع بديل من جملة واحدة لكل منها — فمراجعة أسئلتك الحالية بهذا الجدول أولاً توفّر عليك الكثير من ذهاب والإياب مقارنة بالتتبع الرجعي بعد وقوع الأخطاء.
الجدول الرسمي الكامل (الأعراض والبدائل مأخوذة من وثائق jaggedness):
| # | نمط الفشل | الأعراض النموذجية | البديل الرسمي |
|---|---|---|---|
| 1 | القراءة الحرفية (Literal reading) | المحدِّدات والنفي والشروط الضمنية تُقرأ حرفياً جميعها؛ الإجابة عن السؤال الذي كتبته لا الذي تقصده | اكتب الشروط الدقيقة في instructions، والحالات الحدية في criteria؛ وإذا تعذّر التفادي فقسّمها إلى سؤالين حرفيين يجمعهما الكود |
| 2 | الرياضيات والأرقام (Math and Numbers) | العدّ غير موثوق والخطأ يزداد مع الحجم؛ قيم hex / RGB أقل فاعلية من الأسماء الإنجليزية | ضع كل الحساب في الكود؛ العدّ = تكرار المرشحين بالكود + سؤال واحد لكل عنصر |
| 3 | مقارنة التاريخ والوقت (Date and time comparison) | التواريخ تُقرأ كنص؛ أحكام الأسبقية والفواصل والنوافذ غير موثوقة | استخرج المكوّنات وقارن بالكود |
| 4 | غير المباشرة (Indirection) | النفي المزدوج، خصائص متداخلة داخل خصائص؛ كلما زادت القفزات قلّت الدقة | قلّل عدد القفزات وأشر مباشرة بالاسم إلى state ذات الصلة |
| 5 | state كبير مليء بالتفاصيل غير ذات الصلة | التفاصيل غير ذات الصلة عامل تشويش؛ يصعب تحديد أي جزء من المدخلات يتحمل خطأً معيناً | رشّح أولاً وأرسل فقط ما يحتاجه السؤال |
| 6 | المحتوى الخصمي (Adversarial content) | تعليمات محقونة، أطر مضللة، نصوص تبرر ذاتها يمكنها تحريك الإجابة | اكتب أسئلة دقيقة واختبر الحدود قبل الإطلاق |
| 7 | تعليمات متناقضة مع criteria | عندما تطلب instructions وcriteria شيئين مختلفين يرتبك النموذج | تعامل مع criteria كامتداد لـ instructions ووحّد بينهما |
| 8 | ترتيب خيارات Choice | الترتيب يؤثر على الإجابة مع تحيّز نحو الخيارات المتقدمة | أعد ترتيب الخيارات وتحقق من ثبات الإجابة |
| 9 | الحاجة إلى generation | سلسلة Choice تُجبَر على التوليد: النتيجة رديئة وبطيئة جداً | بدّل إلى نموذج توليد؛ وحوّل الاستخراج المحدود إلى Choice |
ينبغي أن ترى: كل سؤال مسودة لديك يندرج في ثلاث فئات — صالح للاستخدام مباشرة؛ اصطدم بأحد الصفوف ويحتاج إعادة صياغة؛ لا ينبغي سؤال النموذج عنه أصلاً (يستطيع الكود حسابه بدقة). الخطوات التالية تعالج الفئة الثانية فقط.
- وجدت لسؤالي صفاً مقابلاً في الجدول (أو تأكدت أنه لا يحتاج تعديلاً)
الخطوة 2: أعِد الحساب إلى الكود — ثلاث فخاخ متتالية: العدّ، التمثيل الرقمي، واستيفاء Score
لماذا: بالنص الحرفي الرسمي Jev is not a calculator — يُنصح بشدة بوضع أي منطق رياضي في الكود؛ وأداء Jev في الأسئلة الدلالية أفضل منه في المسائل الرياضية. لنمط الفشل #2 ثلاثة فخاخ فرعية، ننظر إليها واحداً واحداً.
الفخ A: العدّ. jev-1.13 غير موثوق في العدّ — عدد الحروف في كلمة، وعدد مرات ظهور مصطلح في فقرة، وعدد عناصر قائمة طويلة، كلها داخلة في ذلك. وصف الجهة الرسمية معبّر: النموذج يتعرّف على «شكل الإجابة» لا يجري tally واحداً واحداً، كما أن الخطأ يزداد مع حجم الأشياء المعدودة. اسأل نفسك قبل البدء: لماذا يحتاج هذا العدّ إلى النموذج؟ إذا كانت الوحدة شيئاً يستطيع regex أو parser إيجاده، فالعدّ من حق الكود ولا ينفع النموذج.
النموذج الرسمي (من وثائق jaggedness، قابل للنسخ حرفياً) — لعدّ عدد الفواكه في قائمة، يتحول إلى «Noul واحد لكل item + جمع بالكود»:
from typesafe_sdk import Noul, TypeSafeClient
client = TypeSafeClient(model="jev-1.13")
YES = 0.5 # up to you on what you want the threshold to be, depends on your usecase.
items = ["typesafe", "apple", "california", "banana", "likes", "calibration", "orange", "vertex"]
result = client.system_one(
{"items": items},
{
f"item_{i}": Noul(instructions=f"Is `items[{i}]` the name of a fruit?")
for i in range(len(items))
},
)
count = sum(result.nouls[f"item_{i}"].noul > YES for i in range(len(items)))النموذج أجرى فقط 8 حكماً من نوع «هل هو فاكهة»، ولم يعدّ ولا مرة واحدة؛ count هو الذي جمع 8 إجابات بواسطة الكود. ووفقاً لمحتوى القائمة، يجب الحكم على العناصر الثلاثة apple وbanana وorange بأنها فواكه، وينبغي أن ترى count = 3.
الفخ B: التمثيل الرقمي. التمثيل الدلالي أفضل من التمثيل الرقمي: في مسائل الألوان، استخدام أسماء الألوان الإنجليزية أفضل من قيم hex؛ إعطاء ثلاثية RGB أو قيمة hex للحكم على قرب قيمتين من بعضهما — غير موثوق. وبالمنطق نفسه، الأداء في مسائل لغات البرمجة عالية المستوى أفضل منه في تعليمات التجميع أو الترميز الثنائي. البديل: الكود يجري التحويل ويمرّر الأرقام المحسوبة أو الحاويات المسماة (named bucket)، ويُترك النموذج للجزء الذي يحتاج حكماً فعلياً — مثل «هل يبدو هذا اللون كتحذير».
الفخ C: استيفاء Score. لا تستخدم مخرجات Score (التوقع، الاحتمال) لحساب قيمة رقمية دقيقة بين مستويين. يمكن استخدام التوقع للتحقق من «تجاوز عتبة معينة»، لكن jev-1.13 ضعيف المعايرة الرقمية في score levels — وإعادة بناء رقم دقيق عبر الاستيفاء بين أقرب مستويين أمر لا يفيد فيه.
- ابحث في الكود عن أسئلة من نوع «اجعل النموذج يخرج كمية / فرقاً / قيمة رقمية دقيقة» وحوّلها جميعها إلى حساب بالكود أو تعداد بـ Choice
الخطوة 3: لا مقارنة للتواريخ — النموذج يستخرج المكوّنات والكود يجمّعها
لماذا: jev-1.13 يقرأ التواريخ كنص لا ككميات مرتبة. «أي تاريخين أسبق، وكم الفارق بينهما، وهل يقعان داخل نافذة» كلها غير موثوقة؛ والصيغ المختلطة والإشارات النسبية (الخميس القادم) وحدود النطاق (الأرباع، نوافذ التسوية، فترات الاستحقاق) تجعل الأمر أسوأ.
مبدأ تقسيم العمل الرسمي في جملة: الاستخراج حكم، فاتركه للنموذج؛ والحساب ليس كذلك، فاتركه في الكود.
كل مكوّن من مكوّنات التاريخ مجموعة صغيرة مغلقة: 12 شهراً، 31 يوماً، ونطاق سنوات محدود. هذا يحوّل الاستخراج إلى Choice على خيارات معدودة بدلاً من تحليل حر؛ كما يتيح وضع خيار صريح لـ «غير مذكور» (not stated) — فالمكوّن الناقص يُبلَّغ عنه بدلاً من التخمين. الكود يجمّع المكوّنات في تاريخ حقيقي، وكل ما بعده — الترتيب، المدة، الإزاحة، يوم الأسبوع — من حق الكود.
أسئلة Choice الـ 7 في cookbook الرسمي لاستخراج التواريخ (تُرسل جميعها في طلب واحد):
| السؤال | ما الذي يُقيَّم | مخرج الطوارئ |
|---|---|---|
| mode | absolute (تاريخ تقويمي كُتب فيه الشهر) / relative (بالنسبة إلى اليوم) / none (لم يُكتب هذا التاريخ) | none |
| month | شهر التاريخ المطلق (12 خيارًا) | none: لم يُذكر في النص |
| day | رقم اليوم من الشهر (خيار لكل رقم من 1–31) | none |
| year | أي سنة (خيار لكل سنة ضمن 1900–2050) | none: لم تُذكر السنة، فيكملها الكود؛ out_of_range: ذُكرت لكنها ليست في القائمة، فيعلّمها الكود ولا يخمّن |
| day_anchor | today / tomorrow / day_after / weekday (يوم أسبوع مُسمّى) | none |
| weekday | أي يوم من الأسبوع (7 خيارات) | none |
| week_offset | next (أسبوع التقويم التالي) / current (هذا الأسبوع) / none (يوم أسبوع مجرد) | — |
ثقة التجميع النهائي تأخذ «الأدنى بين المكونات المستخدمة فعليًا»، وإذا انخفضت عن 0.60 (REVIEW_BELOW في cookbook) تُحوَّل إلى مراجعة بشرية. النسخة الكاملة القابلة للتشغيل (بما فيها التواريخ النسبية وبوابة الثقة) في استخراج القيم: التواريخ، البريد الإلكتروني، الهاتف، المبالغ.
يجب أن ترى: طلب واحد يعيد إجابات 7 مكونات؛ الكود يجمّع كائن date؛ «next Thursday» يُحل باتفاقية الكود (يوم أسبوع مجرد = التالي بدءًا من اليوم، next = أسبوع التقويم التالي، current = هذا الأسبوع) — النموذج لم يقارن أي تاريخ من البداية إلى النهاية.
- لا يوجد في الكود أسئلة من نوع «أي تاريخ أبكر / كم الفارق بالأيام / هل هو داخل النافذة»، استُبدلت كلها باستخراج مكونات + مقارنة بالكود
الخطوة 4: فهم حرفي عبر سؤالين، وتقليل القفزات في الإحالة غير المباشرة
لماذا: نمطا الفشل #1 و#4 كلاهما علّته في صياغة السؤال. الفهم الحرفي: jev-1.13 يجيب عن السؤال الذي كتبتَه، لا السؤال الذي تعنيه — المحدِّدات والنفي والشروط الضمنية تُقرأ كلها حرفيًا؛ البشر يقرؤون النية، أما هو فلا. الإحالة غير المباشرة: الأسئلة ذات النفي المزدوج أو الإحالة المعقدة تنخفض موثوقيتها، والصفة فوق الصفة والاستدلال متعدد القفزات يستهلكان الدقة.
بدائل الفهم الحرفي، ثلاث:
- اكتب الشروط الدقيقة في
instructions، وكن محددًا - ضع الحالات الحدية في
criteria - الجملة الرسمية الذهبية: عندما تنظر إلى إجابة خاطئة وتجد نفسك تشرح «ما كنت أريد أن أسأل عنه حقًا هو…»، فإن ذلك الشرح هو النصف الآخر المفقود من instructions
حيث يتعذر فعلًا تجنّب الشرح، فصّله إلى سؤالين حرفيين يجمعهما الكود. مثلًا «احتفظ بالتعليقات ذات الصلة والودّية» تخفي حكمين في جملة واحدة:
from typesafe_sdk import Noul, TypeSafeClient
client = TypeSafeClient(model="jev-1.13") # 本页示例固定用 jaggedness 文档适用的版本
result = client.system_one(
{"comment": "这个服务真好用,就是贵了点"},
{
"is_on_topic": Noul(instructions="Is `comment` about the product itself?"),
"is_friendly": Noul(instructions="Is `comment` friendly in tone?"),
},
)
# 组合逻辑在代码里:改阈值、改逻辑,都不用动 prompt
keep = result.nouls["is_on_topic"].noul > 0.7 and result.nouls["is_friendly"].noul > 0.7بديل الإحالة غير المباشرة: اكتب instructions مباشرة قدر الإمكان؛ وأشِر إلى الأجزاء ذات الصلة من state بالاسم (باستخدام الإحالة إلى المسارات بعلامات backtick، مثل ticket.messages[0].text)، ولا تدع النموذج يقفز بنفسه.
يجب أن ترى: بعد إعادة الصياغة لم يبق في كل سؤال سوى حكم حرفي واحد؛ اختفت من instructions أدوات الربط مثل «و» و«ليس ليس»؛ منطق التجميع كله في الكود.
- كل instructions فيه حكم واحد فقط؛ وأداة النفي تظهر مرة واحدة على الأكثر
الخطوة 5: تخفيف state الكبير — الكود يرشّح أولًا، وNoul بوابة الصلة
لماذا: نمط الفشل #5. كلما زاد في state ما لا صلة له بالقرار، انخفضت الدقة — التفاصيل غير ذات الصلة عناصر مشتتة، كما أن state الكبير يصعّب عليك تحديد «أي جزء من المدخلات تسبب في الإجابة الخاطئة». النص الرسمي: Jev suffers from context rot، والمواد غير ذات الصلة في state تنفق دقتك مباشرة.
البديل على طبقتين:
- الكود يسترجع ويرشّح أولًا، وأرسل فقط الحقول التي يحتاجها هذا السؤال
- عندما لا يكفي الترشيح على مستوى state، اسأل Noul عن الصلة. طريقة RAG cookbook الرسمية: لكل مقطع مرشح 4 Noul — هل ذو صلة، هل يحوي دليلًا قابلًا للاستخدام، هل يتعارض مع فرضية الاستعلام، هل يحوي تعليمات حقن؛
is_relevantأقل من 0.45 (relevant_minفي cookbook) يُستبعد مباشرة
⚠️ احسب حساب السياق بوضوح في المرة نفسها
تنبّه الوثيقة الرسمية في وثائق jaggedness إلى أن state يُحتسب على jev-1.13 من حدّي السياق — per-request 64k (state + جميع الأسئلة) وper-question 32k (state + سؤال واحد). إذا تجاوز المحتوى الحد يمكن تفعيل ترويسة السياق الطويل (TypeSafe-Danger-Zone-Long-Context: true، يصبح الحدان كلاهما 262k)، لكن الوثيقة الرسمية تقول بوضوح إنها أبطأ وأقل دقة — الترتيب الصحيح هو الترشيح أولًا، لا تفعيل الترويسة أولًا.
الحالة الكاملة في تدقيق مقاطع RAG؛ ومراجعة الأشكال الثلاثة لstate والإحالة بالمسار في State الحالة.
يجب أن ترى: state المرسَل لا يحوي إلا الحقول التي تُستخدم في هذا السؤال؛ حجم نص الطلب يصغر بوضوح؛ إجابة السؤال نفسه تستقر.
- state كل سؤال اجتاز اختبار «هل يُستخدم هذا الحقل في هذا السؤال»
الخطوة 6: ثلاث فحوص قبل الإطلاق — إعادة ترتيب الخيارات، الحالات الحدية، مواءمة التعليمات
لماذا: أنماط الفشل #6 و#7 و#8 لا يمكن حلها نهائيًا بتعديل الصياغة مرة واحدة، والبدائل التي تعطيها الوثيقة الرسمية كلها «فحوص قبل الإطلاق». قبل التوجه إلى كثير من المستخدمين، أكمل هذه الفحوص الثلاثة.
الفحص الأول: إعادة ترتيب خيارات Choice. لاحظت الوثيقة الرسمية أن ترتيب الخيارات قد يؤثر في الإجابة، وjev-1.13 يميل إلى الخيارات الموضوعة في المقدمة. طريقة المراجعة: أعد ترتيب الخيارات واسأل مرة أخرى، ويجب أن تبقى الإجابة متسقة.
from typesafe_sdk import Choice, TypeSafeClient
client = TypeSafeClient(model="jev-1.13")
state = {"ticket": {"subject": "无法登录", "message": "从今天早上开始一直报 401"}}
def urgency(options: dict) -> str:
return client.system_one(
state,
{"urgency": Choice(instructions="How urgent is `ticket`?", criteria=options)},
).answers["urgency"].choice
print(urgency({"low": None, "medium": None, "high": None}))
print(urgency({"high": None, "medium": None, "low": None})) # 重排后再问一遍
# 两次不一致 → 这个问题的答案不可信:选项定义要更互斥、更具体الفحص الثاني: المحتوى العدائي. state بيانات، وjev-1.13 لا يعتبره افتراضيًا محتوى معاديًا — تعليمات الحقن، والأطر المضلِّلة عمدًا، والنصوص التي تدافع عن تصنيف نفسها، كلها قد تحرّك الإجابة (تقول الوثيقة الرسمية إن هذه النقطة ستتحسن مستقبلًا). البديل: اكتب criteria بوضوح؛ اختبر تكاملك اختبارًا شاملًا قبل الإطلاق. حالة الفحص الأمني الكاملة في هذا الاتجاه في حواجز LLM.
الفحص الثالث: مواءمة instructions مع criteria. عندما يطلب الاثنان شيئين مختلفين يرتبك النموذج. المثال الرسمي: Noul يربط true بـ«لا» وfalse بـ«نعم» يعمل بجودة أسوأ. البديل: تعامل مع criteria كامتداد لinstructions بلغة واضحة ودقيقة؛ والهدف أن يفهمها الشخص العادي من نظرة واحدة.
يجب أن ترى: الإجابات متسقة بعد إعادة الترتيب؛ الحالات الحدية مثل المدخلات الفارغة والطويلة جدًا والمحمولة بحقن اختُبرت كلها؛ instructions وcriteria يقولان الشيء نفسه.
- الفحوص الثلاثة أُجريت كلها، وتعريفات الخيارات غير المتسقة أُعيدت صياغتها
نقطة التحقق ✅
- تستطيع أن تردد أسماء 9 أنماط فشل، ولكل منها تقول بديلًا واحدًا (بمقارنة جدول المراجعة السريعة في ملخص هذا الدرس)
- العد ومقارنة التواريخ والقيم الدقيقة تحولت كلها إلى حسابات في الكود — النموذج يقوم بالحكم فقط
- كل instructions فيه حكم حرفي واحد فقط، ومنطق التجميع في الكود
- يرسل state فقط الحقول التي تحتاجها المسألة، وتم حساب حساب قيدي 64k / 32k
- تم تشغيل الفحوصات الثلاثة قبل الإطلاق: اتساق إعادة ترتيب الخيارات، وحالات الحدود، ومواءمة التعليمات
تنبيهات من المزالق
❌ جعل Jev يولّد نصًا
الظاهرة: تريد من Jev كتابة ملخص أو رد أو إخراج نص حر، فتستخدم Choice المتسلسل لتجميع النص كلمة بكلمة.
السبب: نمط الفشل #9. لم يتدرب jev-1.13 على توليد النص؛ وتقول الوثائق الرسمية صراحة إن إجبار Choice المتسلسل على التوليد «سيئ و بطيء جدًا».
الطريقة الصحيحة: عندما تكون مساحة الإجابات محدودة، حوّل الاستخراج إلى Choice على هذه الخيارات بدلًا من السؤال عن القيمة نفسها؛ وإذا احتجت نصًا حرًا فاستخدم نموذج توليد. التقسيم الرسمي الموصى به لاستخراج البيانات: يستخرج regex أو نموذج التوليد الخيارات المرشحة أولًا، ثم يتولى jev-1.13 فقط اختيار الصحيح منها — استخراج القيم هو التطبيق الكامل لهذا التقسيم. كلمات الوثيقة الرسمية صريحة: If you really need to generate text... there are other models for that.
❌ استخدام عتبة confidence كضمادة
الظاهرة: تكون الإجابة أحيانًا بعيدة عن المنطق، فتضيف عتبات confidence في كل مكان، وتحوّل كل ما دون العتبة إلى مراجعة بشرية، ظانًا أن الأمور صارت مستقرة.
السبب: confidence هو «ملخص لشكل التوزيع الاحتمالي الخاص بالإجابة نفسها»، وليس دليلًا على «صحة الإجابة». عند الوقوع في فخ الفهم الحرفي، يجيب النموذجبثقة عن إجابة السؤال الحرفي — التوزيع حاد وconfidence مرتفع، لكن الإجابة لا تطابق ما طُلب. المشكلة المكتوبة بشكل سيئ لا تنقذها العتبات.
الطريقة الصحيحة: أولًا أصلح المشكلة وفق أنماط هذا الدرس البالغة 9، ثم استخدم الاستخدامات الثلاثة لconfidence للأتمتة المتدرجة. كما أن هناك نقطة في الأسئلة الشائعة بوثيقة agent-skill الرسمية: إذا كان كل ما يهمك هو «اختيار الأفضل»، فخذ الخيار الأعلى احتمالًا مباشرة دون حاجة لتعيين عتبات confidence في كل مكان؛ وإذا احتجت حسابات إحصائية فاستخدم probabilities.
❌ «هذه المزالق في 1.14 أُصلحت كلها، لا داعي للتعلم»
الظاهرة: ترى الوثائق تشير إلى أن الإصدار المعني هو jev-1.13، بينما jev-latest يشير بالفعل إلى jev-1.14.0، فتظن أنه يمكن تخطي الصفحة بأكملها.
السبب: الوثائق الرسمية قالت فقط «سيُصلح الكثير منها في الإصدارات اللاحقة»، دون تحديد أيها أُصلح؛ كما أن آخر مراجعة لوثيقة jaggedness كانت في 2026-10-02، أي قبل إصدار 1.14 (2026-10-14)، ولا يوجد في موقع الوثائق الرسمي قائمة jaggedness لإصدار 1.14. إضافة إلى ذلك، لا يزال jev-1.13.0 يعمل، وتخطط الجهة الرسمية لإشعار مسبق مدته 60 يومًا قبل الإيقاف النهائي.
الطريقة الصحيحة: اجعل الأنماط البالغة 9 عادة في صياغة الأسئلة — الحساب في الكود، وتقسيم التواريخ إلى مكونات، وتصفية state الكبير أولًا؛ هذه قواعد لا علاقة لها بالإصدار وهي أسلوب جيد لـ 1.14 أيضًا. وللمستخدمين الصينيين نقطة رسمية إضافية: دقة محتوى CJK أقل منها بالإنجليزية، فاختبر ببياناتك قبل الإطلاق مع التركيز على confidence (قسم دعم اللغات في النماذج والأسعار).
تقنيات متقدمة (اختياري)
حوّل الجدول المرجعي السريع إلى قائمة فريق. توصي وثيقة agent-skill الرسمية بجمع الأسئلة وثوابت العتبات في ملف واحد لتسهيل المراجعة البشرية. أنماط الفشل البالغة 9 تشكل بطبيعتها قائمة مراجعة للأسئلة: قبل دمج سؤال جديد، راجعه مقابل الجدول المرجعي في الملخص. وبالتعاون مع TypeSafe Agent Skill دع Claude Code يساعدك في إعادة صياغة الأسئلة — حذّرت الوثائق الرسمية من أن الـ agent لا يجيد كتابة الأسئلة، فتوقع تعاونًا في التحرير.
أثر على أهداف Ultrafast الخاصة بك. عادات الصياغة هذه تنطبق أيضًا على كتابة أهداف مهام المتصفح: حرفية، ومحددة، ومع شرط توقف — جميع الأهداف في الأمثلة الرسمية تنتهي بـ Stop when…، و«كتابة هدف ضيق» توصية رسمية أيضًا (انظر استكشاف أخطاء Ultrafast).
إذا اكتشفت نمط فشل جديدًا، أبلغ الجهة الرسمية. تختم وثيقة jaggedness بدعوة: عند اكتشاف نمط فشل يستحق الإدراج، أبلغ عنه عبر Discord.
ملخص هذا الدرس
✅ القاعدة الكلية لتجنب مزالق Jev: اترك الحكم لـ Jev، والحساب للكود، والتوليد لنماذج التوليد؛ وأرسل في state فقط ما تحتاجه المسألة.
✅ من بين أنماط الفشل البالغة 9: #2 و#3 هي «أعمال تُعطى للكود»، و#1 و#4 هي «صياغة السؤال»، و#5 هي «تنظيم state»، و#6 و#7 و#8 تعتمد على «فحوصات ما قبل الإطلاق»، و#9 هي «حان وقت الانتقال إلى نموذج توليد».
✅ احفظ مثالين رسميين: العد = الكود يكرر عبر المرشحات + Noul واحد لكل عنصر؛ التاريخ = Choice يعدّد المكونات + الكود يجمعها، مع مخرج طوارئ لـ«غير مذكور».
✅ confidence ملخص لشكل التوزيع، ولا ينقذ مشكلة مكتوبة بشكل سيئ — أصلح المشكلة أولًا، ثم اضبط العتبة.
✅ هذه العادات لا تعتمد على الإصدار؛ وانتبه إضافيًا لدقة محتوى CJK، واختبر بنفسك قبل الإطلاق.
جدول مرجعي سريع لأنماط الفشل البالغة 9 (الأعراض ← البديل):
| # | نمط الفشل | البديل في سطر واحد |
|---|---|---|
| 1 | الفهم الحرفي | ضع الشروط الدقيقة في instructions والحدود في criteria؛ وقسّمها إلى سؤالين يجمعهما الكود |
| 2 | الرياضيات والأرقام | ضع كل الحساب في الكود؛ العد = تكرار بالكود + سؤال لكل عنصر |
| 3 | مقارنة التاريخ والوقت | استخرج المكونات (تعداد بـ Choice)، وقارن بالكود |
| 4 | الإشارة غير المباشرة | قلّل عدد القفزات، وأشر إلى state بالاسم |
| 5 | state كبير مليء بالتفاصيل غير ذات الصلة | صفِّه أولًا؛ وإذا تعذّر التصفية فاستخدم Noul كبوابة صلة |
| 6 | المحتوى المعادي | اكتب criteria بوضوح، واختبر الحدود قبل الإطلاق |
| 7 | تعليمات وcriteria متناقضة | criteria امتداد لـ instructions، فوحّد بينهما |
| 8 | ترتيب خيارات Choice | أعد ترتيب الخيارات وتحقق من اتساق الإجابات |
| 9 | الحاجة إلى generation | انتقل إلى نموذج توليد؛ وحوّل الاستخراج المحدود إلى Choice |
استعراض الدرس التالي
بهذا يُختتم الدليل المتقدم. الدرس التالي مرجع سريع لواجهة API: الطلبات والاستجابات والأخطاء يجمع معرفة طبقة الطلبات في صفحة واحدة. ستتعلم:
- قواعد نص الطلب:32 حد MiB، وUTF-8 JSON بدون BOM، والتداخل ≤ 64 مستوى، والأرقام يجب أن تكون محدودة
- جدول رموز الحالة:400 / 401 / 413 / 415 / 422 / 429 / 529 ومعاني كل منها واستراتيجية إعادة المحاولة
- قواعد الضغط: كيفية استخدام gzip / zstd، ومتى يظهر 415
- مقارنة حقول الطلب والاستجابة بين SDK والاتصال المباشر عبر curl
دروس ذات صلة
- أسئلة Noul الصواب/الخطأ: احتمال الحصول على 0 إلى 1 الحقيقي
- أسئلة Score للتقييم: التقييم وفق المقياس الذي تحدده
- استخراج القيم: التواريخ، ورسائل البريد الإلكتروني، وأرقام الهواتف، والمبالغ
ملحق: مرجع شيفرة المصدر
انقر لعرض المصدر في الوثائق الرسمية
وقت التحديث: 2026-11-04 (مصدر المعلومات المحلي للوثائق الرسمية sources/jev/docs/، URL = https://docs.typesafe.ai/<本地路径>)
| المحتوى | مسار الملف | المواضع الرئيسية |
|---|---|---|
| 9 جدول شامل لأنماط الفشل والممارسات البديلة قسمًا بقسم | docs/model-jaggedness/jev-1.13.md | تحديد الموقع في المقدمة (سرعة / معايرة / حكم سليم؛ ثلاث نقاط ضعف: التسلسل الهرمي غير المباشر، الفهم الحرفي، دقة الأرقام)؛ جدول أنماط الفشل؛ وفي الخاتمة أربع قواعد avoid ومدخل استدعاء Discord |
| نموذج العد الرسمي (حكم Noul لكل عنصر + جمع برمجي) | docs/model-jaggedness/jev-1.13.md | Math and Numbers → Counting: 8 عنصرًا، وYES = 0.5، وجمع result.nouls |
| تمثيل الأرقام واستيفاء Score | docs/model-jaggedness/jev-1.13.md | Numeric representations (سداسي عشري مقابل الاسم الإنجليزي، اللغات عالية المستوى مقابل لغة التجميع)؛ Math using score (القيمة المتوقعة تُستخدم فقط لفحص العتبة) |
| الفهم الحرفي / الإحالة غير المباشرة / الحالة الكبيرة / المواجهة / التعليمات المتناقضة / ترتيب الخيارات / التوليد | docs/model-jaggedness/jev-1.13.md | الأقسام الفرعية المماثلة بالاسم نفسه؛ وملاحظة NOTE حول context limit في قسم Large state |
| التنفيذ الكامل لاستخراج مكونات التاريخ | docs/cookbooks/date_extraction_cookbook.md | 7 Choice (mode / month / day / year / day_anchor / weekday / week_offset)؛ نطاق year 1900–2050 + none / out_of_range؛ REVIEW_BELOW = 0.60؛ الثقة تُؤخذ كأدنى قيمة للمكونات المستخدمة؛ شيفرة الإصدار مثبتة على TYPESAFE_MODEL = "jev-1.12" |
| بوابة الصلة بـ Noul وفحص الحقن | docs/cookbooks/classifying_rag_passages.md | 4 Noul (is_relevant / contains_answer_evidence / contradicts_query_premise / contains_prompt_injection)؛ relevant_min = 0.45 |
| حدود السياق والسياق الطويل | docs/models.md | 64k لكل طلب / 32k لكل سؤال؛ TypeSafe-Danger-Zone-Long-Context: true → 262k، أبطأ وأقل دقة |
| الجدول الزمني للإصدارات ودعم اللغات | docs/models.md؛ منشور المدونة typesafe.ai/blog/jev-1-14 (محليًا site/jev-1-14.md) | إصدار jev-1.14.0 بتاريخ 2026-10-14؛ jev-latest يشير الآن إلى 1.14.0؛ خطة ما قبل إيقاف 1.13 تتضمن إشعارًا مسبقًا بـ 60 يومًا؛ دقة CJK أقل، اختبر بنفسك قبل الإطلاق |
| أسئلة شائعة مثل «لا حاجة لتعيين عتبات confidence في كل مكان» | docs/agent-skill.md | قسم Common issues |