الاستخدام اليومي: أتقن خمس طرق للسؤال في Jev
💡 الهدف: إتقان طريقة الاستخدام اليومي لـ Jev في حوالي 1 ساعة — تقديم المواد الصحيحة (state)، وطرح الأسئلة الصحيحة (Choice / Score / Noul / Box)، وقراءة درجة الثقة في الإجابات، بحيث تتحول كل إجابة مباشرة إلى فرع من فروع الكود.
🎯 أهداف المرحلة
- كتابة state بأشكاله الثلاثة حسب شكل المواد (سلسلة نصية / كائن JSON / مصفوفة نصوص)، واستخدام dot path لتوجيه السؤال إلى حقل محدد
- عند مواجهة أي حاجة إلى حكم، القدرة على اختيار نوع السؤال المناسب — Choice أو Score أو Noul أو Box — وذكر الحقول الموجودة في الإجابة
- ضبط العتبات باستخدام confidence واحتمال Noul: أي الإجابات تُنفَّذ تلقائيًا، وأيها تُعلَّم للمراجعة، وأيها تُحوَّل إلى شخص
⏳ الوقت المتوقع
- مجموع 6 دروس حوالي 58 دقيقة، وبعد إضافة هامش مرونة حوالي 41–75 دقيقة
- كل درس مستقل بذاته ويمكن قراءته منفردًا حسب الحاجة؛ 2.1 State هو أساس الدروس الخمسة الأخرى، ويُنصح بالبدء به
🚀 قبل أن تبدأ
- أكملت التثبيت وأول طلب:
route_ticket.pyما زال يعمل، وTYPESAFE_API_KEYموجود في متغيرات البيئة (القراء الذين يبدأون من الصفر عليهم أولاً الاطلاع علىدليل البداية السريعة) - تعرف أن Jev يقوم بالأحكام المُهيكلة فقط ولا يولّد نصوصًا — إن لم تقرأ ذلك بعد، خصص 8 دقائق للاطلاع على ما هو Jev
- لا بأس إن كنت لا تريد فتح الطرفية: الصق state وأضف الأسئلة في TypeSafe Playground (
console.typesafe.ai/playground) لتجربة بدون كود - كوب من الماء ☕ — تركز هذه المرحلة على بناء الحس العملي، والكود في كل درس قصير
📚 دروس هذه المرحلة
طلب Jev واحد لا يتكون إلا من شيئين: state (المواد المطلوب الحكم عليها) + questions (أسئلة مُنمّطة). لقد أرسلت طلبًا بالفعل في مرحلة البداية السريعة؛ في هذه المرحلة ستجعل «كيفية السؤال» غريزة لديك — الدرس 1 يعلّمك تقديم المواد، والدروس الـ 5 التالية تتناول طرق السؤال الخمس واحدة تلو الأخرى.
لنلقِ نظرة على الصورة الكاملة أولًا. أنواع الأسئلة في questions أربعة: Choice (اختيار)، وScore (تقييم)، وNoul (نعم/لا)، وBox (تحديد مواقع الصور)؛ كما تخبرك قيمة confidence المرفقة بالإجابة بمدى تأكد هذا الحكم. أربعة أنواع أسئلة + درجة الثقة هي طرق السؤال الخمس التي يجب إتقانها في الاستخدام اليومي، ولكل منها درس:
| طريقة السؤال | بماذا يجيب | ماذا في الإجابة |
|---|---|---|
| Choice سؤال اختيار | أي خيار من الخيارات الثابتة | choice، وprobabilities (احتمال كل خيار)، وconfidence |
| Score سؤال تقييم | على أي درجة يقع في المقياس المرتب الذي حددته | score (قد يقع بين درجتين، مثل 0.67)، وlegend، وprobabilities، وconfidence |
| Noul سؤال نعم/لا | احتمال صحة هذا الحكم | noul (0–1؛ لا توجد confidence منفصلة) |
| Confidence درجة الثقة | مدى التأكد من هذه الإجابة | رقم واحد بين 0–1؛ مرفقة بإجابات Choice / Score / Box، وغير موجودة في Noul |
| Box تحديد مواقع الصور | موقع الهدف داخل الصورة | box (أربعة حدود: top / bottom / left / right، كل منها 0–1) + confidence |
كيف تختار؟ توصية الاختيار الرسمية لا تتجاوز أربع جمل:
- الإجابة مجموعة خيارات معروفة → Choice (إذا كانت القائمة قد لا تكون كاملة، أضف خيار
otherأوnone of the above) - الإجابة تقع على طيف ويمكن وصف كل درجة فيه → Score
- حكم نعم/لا واضح والاحتمال بذاته مفيد → Noul (0.5 يعني عدم اليقين «خمسين-خمسين»، وليس «درجة متوسطة» — لقياس الدرجة استخدم Score)
- تريد إيجاد شيء داخل صورة → Box (ميزة تجريبية: تقول الجهة الرسمية إن Images / Box لم تصل بعد إلى معايير الإنتاج، وقد يتغير التنسيق مع الإصدارات)
عندما يناسب نوعا سؤال كلاهما، اختر ما «يمكن للكود التصرف بناءً على إجابته مباشرة»: Choice يقابل عدة فروع في الكود، وScore يقابل عتبة واحدة، وNoul يقابل if واحدًا.
ترتيب الدروس:
| الدرس | المحتوى | المدة |
|---|---|---|
| 2.1 حالة State | كيفية اختيار أشكال state الثلاثة، وتنظيم التذاكر في JSON مُنمّط، واستخدام dot path لتوجيه السؤال إلى حقل محدد، وتقليم المواد ضمن حدود السياق | 8 دقيقة |
| 2.2 سؤال الاختيار Choice | إدراج جميع الخيارات في criteria وقراءة probabilities لكل خيار، وإضافة خيار other عندما لا تكون القائمة كاملة | 10 دقيقة |
| 2.3 سؤال التقييم Score | تعريف مقياس مرتب، وقراءة score الذي قد يقع بين درجتين، وتقسيم الأحكام المعقدة إلى أسئلة متعددة تُدمج موزونة في الكود | 10 دقيقة |
| 2.4 سؤال نعم/لا Noul | كيفية قراءة الاحتمال 0–1، وعتبات البداية 0.7 / 0.3، وكيفية الاختيار بينه وبين Score | 8 دقيقة |
| 2.5 درجة الثقة Confidence | كيف يُحسب confidence من التوزيع الاحتمالي، واستخدام ثلاث درجات (تنفيذ تلقائي / وضع علامة للمراجعة / تحويل إلى إنسان)، وتكييف العتبة مع مستوى المخاطرة | 12 دقيقة |
| 2.6 Box والصور | وضع الصورة في state وفي السؤال، وإرجاع Box لنِسب الحواف الأربعة، وترويسة Danger Zone ودعم Image في Python SDK | 10 دقيقة |
نظرة سريعة: طلب واحد يجمع ثلاثة أنواع من الأسئلة
يمكن مزج أنواع الأسئلة بحرية، وتُقيَّم جميع الأسئلة بشكل متوازٍ ومستقل على نفس الـ state — إضافة الأسئلة لا تزيد زمن الاستجابة تقريبًا، بل تستهلك فقط توكنات الأسئلة الإضافية. هذا المثال من الوثائق الرسمية يطرح في طلب واحد سؤال نعم/لا وسؤال اختيار وسؤال تقييم:
from typesafe_sdk import Choice, Noul, Score, TypeSafeClient
state = {
"ticket_message": "My flight was cancelled. Can I get a refund?",
"refund_policy": "Cancelled flights are eligible for a full refund.",
}
with TypeSafeClient() as client:
response = client.system_one(
state=state,
questions={
"refund_requested": Noul(
instructions="Does `ticket_message` request a refund?",
),
"request_type": Choice(
instructions="What is the main request in `ticket_message`?",
criteria={
"refund": "The customer wants money returned.",
"rebooking": "The customer wants a replacement flight.",
"information": "The customer is asking for information only.",
},
),
"frustration": Score(
instructions="How frustrated does the customer appear in `ticket_message`?",
criteria=[
"Calm and neutral.",
"Concerned but civil.",
"Very angry or using strong language.",
],
),
},
)
print(response.answers["refund_requested"].noul)
print(response.answers["request_type"].choice)
print(response.answers["frustration"].score)كل إجابة من الإجابات الثلاث هي قيمة ذات نوع: احتمال، واسم خيار، ودرجة — في الكود تكتب if مباشرة دون تحليل من نص مولَّد.
⚠️ اختبر المواد الصينية قبل الإطلاق
اللغة الرئيسية في تدريب Jev هي الإنجليزية، ودقتها أفضل مع المواد الإنجليزية؛ أما الصينية وغيرها من اللغات فتعمل لكن بدقة أقل. قبل إطلاق محتوى بالصينية، اختبره أولًا ببياناتك الخاصة مع التركيز على confidence.
🎒 ما ستكتسبه
- حدس في صياغة الأسئلة: عند استلام متطلب حكم، فكّر أولًا في «كيف يبدو الجواب» — خيارات، أو مقياس، أو احتمال، أو إحداثيات على صورة — ثم اختر نوع السؤال
- قدرة كاملة على قراءة الإجابات:
probabilitiesلرؤية التوزيع، وconfidenceلرؤية درجة التأكد، وscoreمقروءًا معlegend - تحويل «عدم التأكد» إلى فروع في الكود: تنفيذ تلقائي عند الثقة العالية، ووضع علامة للمراجعة عند الثقة المتوسطة، وتحويل إلى إنسان عند الثقة المنخفضة
- مقدمة في الحكم على الصور: تحديد Box مع مفتاح Danger Zone، تمهيدًا لسيناريوهات مثل التعرف على المستندات الممسوحة والتحقق من OCR
بإتقان طرق السؤال الخمس، تكتمل أساليب الاستخدام اليومي لـ Jev. أمامك بعدها مساران تختار أحدهما: لبناء نظام كامل، انتقل إلى سير العمل الفعال لتتعلم أربعة أنماط معمارية رسمية؛ ولمشاهدة مشاريع حقيقية أولًا، يوفر سيناريوهات عملية 15 حالة كاملة — مثل تصفية محادثات البث المباشر: طلب واحد لكل رسالة وثلاثة أسئلة، تُحكم معًا على الإساءة وحرق الأحداث والرسائل المزعجة.
هل أنت مستعد؟ابدأ الدرس الأول: State الحالة →