jev-latest
نموذج قرارات من TypeSafe: لا يكتب النص، بل يجيب عن أسئلة محددة النوع حول نص أو JSON — اختيار بديل أو تقييم على مقياس أو «نعم/لا» مع الاحتمالات. يناسب التوجيه وفرز طلبات الدعم والإشراف على المحتوى وإسناد الدرجات؛ وتُقيّم جميع أسئلة الطلب الواحد بالتوازي.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Jev هو النموذج الرائد لدى TypeSafe وأول نموذج من الفئة الجديدة System One. لا يكتب النص، بل يتخذ سريعًا قرارات تستطيع البرمجية استخدامها مباشرةً: تقدم الحالة (state) — نصًا أو JSON — ومجموعة أسئلة، وتتلقى قيمًا محددة النوع باحتمالات معايرة.
تكتب النماذج اللغوية الكلمات للناس، بينما Jev، بحسب TypeSafe، أقرب إلى الشيفرة: إجابة بالشكل الذي تحتاجه الشيفرة مباشرةً، وسرعة عالية، ولا قيمة خارج البدائل المحددة. وصُمم النموذج لتقديم إجابات ثابتة عند تكرار الطلبات.
اختلاف System One عن النموذج اللغوي
- لا يولّد. لا يكتب Jev إجابات للمستخدم أو شيفرة، ولا يشرح مسار الاستدلال. أنت تحدد الإجابات المحتملة عبر أحد أنواع الأسئلة الثلاثة.
- مدرّب على قرارات معايرة. تدرب TypeSafe النموذج بطريقة RLCD (Reinforcement Learning for Calibrated Decisions): تُضبط الاحتمالات وفق النتائج الفعلية وتعكس عدم اليقين. ومن بين عدد كبير من الإجابات باحتمال 0,8 يُفترض أن يكون نحو 80% صحيحًا. والمعايرة خاصية لعينة كبيرة، وليست ضمانًا لصحة إجابة منفردة.
- هدف تدريب مختلف. تُدرّب نماذج المحادثة على إرضاء الناس (RLHF)، وترى TypeSafe أن ذلك يشجع التملق والأخطاء التي تبدو واثقة. وأحد المشاركين في ابتكار RLHF، ديوغو ألميدا، شريك مؤسس في TypeSafe.
يشير الاسم إلى «النظام 1» من كتاب دانيال كانيمان «التفكير، السريع والبطيء»: الحكم الحدسي السريع في مقابل التفكير المتأني البطيء لـ«النظام 2». وصُمم Jev لأحكام سريعة ومحددة النطاق.
ثلاثة أنواع من الأسئلة
السؤال حكم واحد حول الحالة، والإجابة قيمة تقارنها الشيفرة بعتبة أو ترتبها أو تمررها إلى خطوة لاحقة.
- Choice — اختيار بديل. قسم طلب الدعم أو فئة المنتج أو لغة مقطع الشيفرة. البدائل قاموس «البديل → الوصف»، حتى 255 بديلًا. تحتوي الإجابة على
choiceالمختار وprobabilitiesلجميع البدائل (ومجموعها 1) والثقةconfidence. وإذا كانت القائمة قد لا تغطي جميع الحالات، فأضف «أخرى» أو «لا شيء مما سبق». - Score — تقييم على مقياس. موضع على مقياس مرتب تصفه أنت: شدة الخطأ أو انزعاج العميل أو مستوى المهارة. من 2 إلى 10 مستويات، من الأدنى إلى الأعلى؛ ويقيّم النموذج كل مستوى بصورة مستقلة دون رؤية رقمه أو المستويات المجاورة. تتضمن الإجابة
score(مجموع أرقام المستويات مضروبة في احتمالاتها، لذا قد تقع القيمة بين المستويات)، وlegendبأوصاف المستويات، وprobabilitiesوconfidence. - Noul — نعم أو لا. هل العبارة صحيحة؟ الإجابة
noulهي احتمال «نعم» من 0 إلى 1: قرب 1 يعني «نعم» واثقة، وقرب 0 يعني «لا» واثقة، وقرب 0,5 يعني تردد النموذج. ولا توجدconfidenceمستقلة: يصف عدد واحد الإجابة بالكامل. وتوضحcriteriaالاختيارية ما يُعد «نعم» وما يُعد «لا».
كيفية الاختيار: بدائل معروفة دون ترتيب — choice؛ درجات نطاق — score؛ «نعم/لا» فقط، حيث يهم الاحتمال نفسه — noul. تعني Noul 0,5 فرصًا متساوية لـ«نعم» و«لا»، وليست «مستوى متوسطًا»: فقياس الدرجة من اختصاص score. ومن نوعين مناسبين اختر الذي تتصرف الشيفرة بناءً عليه مباشرةً: choice للتفرعات، وscore للعتبة، وnoul لـif.
يمكن الجمع بين الأنواع في طلب واحد. وتبقى الإجابة محصورة دائمًا في بدائلك ولا تعتمد على الأسئلة الأخرى: ويمكن إضافة الأسئلة أو حذفها دون تغيير الإجابات الأخرى.
الحالة
الحالة هي ما يقيّمه النموذج: رسالة عميل أو مقطع وثيقة أو سجل من قاعدة بيانات أو حالة تطبيقك.
- سلسلة نصية — عندما يكون النص واحدًا: رسالة أو مقالة أو مقطع.
- كائن — حقول مسماة أو سجلات مترابطة أو حالة التطبيق. توصي TypeSafe بالكائن لمعظم الطلبات: إذ يكون لكل جزء اسم واضح.
- مصفوفة — تسلسل رسائل أو سجلات.
أعدّها كما تُعد المواد للخبراء: ضع المراسلات والطلب وقواعد الاسترجاع معًا إذا كان القرار يتطلب مقارنتها. وضع المحتوى في الحالة والأحكام في الأسئلة. وإذا تعلق السؤال بجزء واحد من الحالة، فاذكر فيه المسار إلى ذلك الجزء بين علامات الاقتباس العكسية، مثل ticket.messages[0].text.
كيفية صياغة الأسئلة
- حكم سريع واحد لكل سؤال. السؤال الجيد هو الذي يستطيع شخص مطلع ولديه السياق اللازم الإجابة عنه خلال ثانية: «هل تشير الرسالة إلى الاستعجال؟». أما «حلل الرسالة وقرر ما ينبغي فعله» فهو استدلال بطيء، ويجب تقسيمه إلى أسئلة بسيطة.
- السؤال كاملًا في
instructions. مفتاح السؤال، مثلrefund_requested، تحتاجه شيفرتك فقط ولا يُمرر إلى النموذج. - جميع أسئلة الحالة الواحدة في طلب واحد. يقيّمها النموذج بالتوازي: ووفقًا لـTypeSafe، لا تزيد الأسئلة الإضافية وقت الإجابة تقريبًا، ولا تُكلف إلا توكناتها. فالسؤال «احتياطًا» شبه مجاني — وتقرر الشيفرة بنفسها أي إجابات تحتاجها.
- الحكم المعقد على أجزاء. بدلًا من «قيّم طلب شركة ناشئة»، اسأل بصورة مستقلة عن حجم السوق والجدوى التقنية والاختلافات عن المنافسين، واحسب النتيجة في الشيفرة بالأوزان. وإذا تغيرت الأولويات، غيّر الأوزان بدل إعادة صياغة السؤال.
- الأسئلة التابعة في طلب ثانٍ. لا تشكل إجابات الطلب الواحد سياقًا لبعضها. ويُحتاج إلى طلب ثانٍ فقط إذا تعذر تكوينه دون الإجابة الأولى: مثل الحاجة إلى تحميل بيانات إضافية أو اختيار بدائل السؤال التالي.
- السؤال الطويل في كائن. تكون
instructionsوcriteriaعادةً سلسلتين نصيتين، لكن قد تكونان كائنًا أو مصفوفة: السؤال في حقل والبيانات في حقول أخرى. وهذا مناسب لمقارنة سيرة ذاتية بسجلات قاعدة البيانات بسؤال واحد.
الثقة
في choice وscore تُظهر confidence من 0 إلى 1 مدى تركز الاحتمال على إجابة واحدة: 1 يعني الاحتمال كله في بديل واحد، و0 توزيعه بالتساوي على الجميع. وفي score يخفض المستوى المجاور الثقة بدرجة أقل من المستوى البعيد. أما في noul فالثقة هي القيمة نفسها: كلما ابتعدت عن 0,5، كانت الإجابة أكثر حسمًا.
توصي TypeSafe بثلاثة نطاقات:
- ثقة عالية — اتخذ الإجراء تلقائيًا.
- متوسطة — تصرف بحذر، مثل أن تطلب من المستخدم التأكيد.
- منخفضة — أحل الحالة إلى شخص، أو وضّح الطلب، أو استخدم مسارًا احتياطيًا، مثل نموذج أقوى مزود بالاستدلال.
كلما كانت تكلفة الخطأ أكبر، وجب تشديد العتبة: فتكون أعلى للإجراءات غير القابلة للتراجع عنها مقارنة بالقراءة. وتحدد الإجابة ما تختاره، والثقة ما إذا كان ينبغي التصرف. واضبط العتبات على بياناتك بمقارنة الثقة بالدقة.
بناء نظام حول Jev
صُمم Jev للبرامج التي تتحكم الشيفرة في مسار عملها ويجيب فيها النموذج عن أسئلة دلالية ضيقة، وليس للوكلاء الذين يختارون الخطوة التالية بأنفسهم وقد ينحرفون في كل دورة. ثماني خطوات للتصميم بحسب TypeSafe:
- نفّذ بالشيفرة كل ما يمكن تنفيذه بها — بصورة موثوقة وبتكلفة منخفضة.
- ضع في الحالة ما تحتاجه الأسئلة الحالية فقط؛ وخذ الحقائق الحديثة من قاعدة معرفتك، لا من ذاكرة النموذج.
- البنية في الحالة: JSON متداخل، وفي السؤال مسار إلى الحقل المطلوب بين علامات الاقتباس العكسية إذا كان ذلك يقلل الالتباس.
- أضيق الأسئلة وأكثرها تحديدًا — وهي ربما القاعدة الأهم بحسب TypeSafe: يخفي السؤال الواسع عدة أحكام وراء إجابة واحدة.
- البنية في الأسئلة: السؤال نفسه قصير؛ والشروح والأمثلة والقيم من قاعدتك في الحقول المجاورة للكائن
instructionsأوcriteria، لا في سلسلة نصية طويلة واحدة. - أسئلة مستقلة كثيرة للحالة الواحدة في طلب واحد — فائدة أكبر لكل دولار.
- تجمع الشيفرة الإجابات: بالقواعد أو بالمجموع الموزون أو بوصفها ميزات لنموذج تقليدي للتعلم الآلي.
- التفرع حسب الثقة: الحالات غير الواثقة تُحال إلى شخص أو إلى نموذج مزود بالاستدلال.
Jev ليس محادثة ولا نموذجًا لإكمال الشيفرة تلقائيًا، ولا يمكن وضعه بدل نموذج لغوي في وكيل للبرمجة. لكن يمكن للوكيل كتابة شيفرة لك تستدعي Jev حيث تحتاج إلى إجابة سريعة ومعايرة.
مواضع الاستخدام
- الأتمتة في الخلفية — قرارات تُنفذ مليون مرة دون وجود شخص بجوارها.
- الوقت الفعلي — وفقًا لـTypeSafe، تُنفذ معظم الطلبات في نحو 100 مللي ثانية: وهو ما يكفي للمعالجة أثناء التشغيل وللواجهات.
- البيانات الضخمة — البحث في مجموعات نصية هائلة ووسم سجلات عمل الوكلاء والميزات للتنبؤات.
- التحقق من النماذج الأخرى — الطلبات والاستخراجات والاستدلال واستدعاءات الأدوات: تجاوز القيود وأخطاء الاستشهاد والمعلومات المختلقة.
- البحث والترتيب — ملاءمة زوج «الطلب — المرشح»، وإعادة الترتيب واختيار السياق.
- التفرع حسب النية — ما يريده المستخدم والمعالج اللازم: منطق بسيط أو نموذج متخصص أو شخص؛ وتحدد الموضوعات والتعقيد والمخاطر النموذج اللغوي الذي يُحال إليه الطلب.
- الفحوص الوقائية — مدخلات النموذج اللغوي ومخرجاته واستدعاءات أدواته: التعليمات المحقونة ومخالفة القواعد وتسريب البيانات الشخصية.
- الدعم — موضوع طلب الدعم ونيته والاستعجال والانزعاج واحتمال مغادرة العميل وطلب استرداد المال وقائمة الانتظار.
- الإشراف على المحتوى — وفق قواعد منصتك: السمية والتنمر والرسائل المزعجة والاحتيال والنصائح الخطرة والبيانات الشخصية؛ وبحسب الشدة والثقة تُسمح الحالة أو يُصدر تحذير أو تُراجع أو تُحظر.
- القطاعات — مطالبات التأمين والتحقيقات المالية وKYC والعقود والإعلان وبطاقات المنتجات والتوظيف والعملاء المحتملون والألعاب والمخاطر وتوقع الطلب ورسوم المعرفة والمراجعات العلمية والفحوص الدلالية للشيفرة في CI.
الخصائص
jev-latest— اسم مستعار لأحدث إصدار مستقر، وهو حاليًا Jev 1.13؛ ويُذكر الإصدار الذي أجاب في حقلmodel، مثلjev-1.13.0. ينتقل الاسم المستعار إلى الإصدار الجديد، وقد تتغير الإجابات دون تعديل من جانبك — راقب هذا الحقل إذا كانت العتبات مضبوطة لإصدار معين.- السياق — 64K توكنًا للطلب: الحالة وجميع الأسئلة معًا؛ والحالة مع أطول سؤال حتى 32K. يقرأ النموذج الحالة مرة واحدة ويقيّم جميع الأسئلة في ضوئها بالتوازي.
- المدخلات — نص فقط: سلسلة نصية أو كائن JSON أو مصفوفة نصوص. ولا تُدعم الصور أو الصوت أو الفيديو بعد — حوّلها إلى نص مسبقًا.
- اللغة — الإنجليزية هي لغة التدريب الأساسية، والدقة عليها هي الأعلى حاليًا. يقبل النموذج لغات أخرى، منها الصينية واليابانية والكورية، لكن الدقة أقل — تحقق على بياناتك.
- الأسعار والفوترة في Ailoot API — تعتمد الشروط على الطريقة المختارة، وهي موضّحة في بطاقة تلك الطريقة.
- الضبط — لا يُدرّب Jev تدريبًا إضافيًا على بيانات العميل: ضع موادك في
stateوقواعد المجال فيinstructionsوcriteria. - البيانات — تذكر TypeSafe أن Jev لا يُدرّب على طلبات العملاء وإجاباتهم.
نقاط الضعف المعروفة في Jev 1.13
تذكر TypeSafe صراحةً نقاط ضعف الإصدار الحالي وتعد بإصلاح كثير منها في الإصدارات التالية. النموذج سريع ومعاير، ويصدر أحكامًا جيدة بالمنطق السليم، لكن:
- يقرأ حرفيًا. يجيب عن السؤال المكتوب لا المقصود ضمنًا: ويفهم التحفظات والنفي والشروط الضمنية حرفيًا. اكتب الشرط الدقيق والحالات الحدّية في
criteria؛ وقسّم أي تفسير لا مفر منه إلى سؤالين حرفيين. - ليس آلة حاسبة. عدّ الأحرف والتكرارات وعناصر القائمة غير موثوق، ويزداد الخطأ مع الحجم — احسب في الشيفرة، واجعل لكل مرشح سؤالًا. يفهم النموذج الألوان بصيغة hex أو RGB أقل من أسمائها. ويصلح
scoreلعتبة، لكنه لا يصلح لعدد دقيق بين المستويات. - التواريخ والوقت. تحديد أي تاريخ أسبق، والفاصل بين تاريخين، ووقوع تاريخ ضمن فترة غير موثوق، خصوصًا مع الصيغ المختلطة والتواريخ النسبية. استخرج أجزاء التاريخ عبر choice (ببديل «غير مذكور»)، وقارنها في الشيفرة.
- عدم المباشرة. يخفض النفي المزدوج والأسئلة عن خاصية لخاصية أخرى الدقة. اكتب مباشرةً، وسمِّ أجزاء الحالة بأسمائها.
- المواد الزائدة في الحالة. يخفض النص غير المرتبط الدقة. رشّحه في الشيفرة، وإذا تعذر ذلك فاستبعد غير ذي الصلة بأسئلة noul.
- النص المعادي. لا يتوقع النموذج افتراضيًا خداعًا في الحالة: فقد تغير تعليمات محقونة أو نص يجادل في تصنيفه الإجابة. اكتب معايير دقيقة وتحقق من الحالات الحدّية قبل التشغيل.
- التناقضات. إذا طلبت
instructionsوcriteriaأمرين مختلفين — مثل وصف «نعم» بأنها «لا» في noul — تنخفض الدقة. والمعايير امتداد للسؤال. - ترتيب البدائل. يميل النموذج أحيانًا إلى البديل الأول في choice. أعد ترتيب البدائل وتحقق من ثبات الإجابة.
- التوليد. لم يُدرّب Jev على كتابة النص. وللاستخراج اعثر على المرشحين بتعبير منتظم أو نموذج توليدي، واترك Jev يختار الصحيح عبر choice.
Ailoot · System One POST /v1/systemone jev-latest
jev-latestالبداية
نموذج قرارات من TypeSafe: لا يكتب النص، بل يجيب عن أسئلة محددة النوع حول نص أو JSON — اختيار بديل أو تقييم على مقياس أو «نعم/لا» مع الاحتمالات. يناسب التوجيه وفرز طلبات الدعم والإشراف على المحتوى وإسناد الدرجات؛ وتُقيّم جميع أسئلة الطلب الواحد بالتوازي.
- المدخلات المقبولة
- النص
- النتائج
- structured
متاح في Ailoot · المدخلات والطرائق
Ailoot · System One POST /v1/systemone
- الإدخال
text- الإخراج
structured- السياق
- 64,000 tokens
- صيغة الإخراج
- json
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود jev-latest | القيمة الافتراضية— |
الحقلstate | النوعstring|object|array | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلquestions | النوعobject | المتطلبمطلوب | القيم والحدود الحد الأدنى لحقول الكائن: 1 | القيمة الافتراضية— |
الحقلquestions.<id>.type | النوعstring | المتطلبمطلوب | القيم والحدود noul, choice, score | القيمة الافتراضية— |
الحقلquestions.<id>.instructions | النوعstring|object|array|null | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلquestions.<id>.criteria | النوعobject|array|null | المتطلباختياري | القيم والحدود الشروط: noul: أوصاف اختيارية تقبل القيمة null من النوع true/false؛ choice: كائن معايير؛ score: مصفوفة معايير غير فارغة | القيمة الافتراضية— |
الحقلstream | النوعboolean|null | المتطلباختياري | القيم والحدود false, null | القيمة الافتراضية— |
تركيبات مواد الإدخال
noul · مطلوب: state, questions.<id>.type=noul
choice · مطلوب: state, questions.<id>.type=choice, criteria object
score · مطلوب: state, questions.<id>.type=score, nonemptycriteriaarray
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةmaterial_types | المواصفاتtext |
المعلمةrequired | المواصفاتmodel, state, questions |
المعلمةoptional_controls | المواصفاتnull |
المعلمةcontent_type | المواصفاتapplication/json |
دورة الحياة: exact retained published method
بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب.
الباقات
تعرفات طرائق Ailoot
POST /v1/systemone- الإدخال
- ≈0.000084 US$ / 1K
- الإخراج
- 0.00 US$ / 1K
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot · System One
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 customer message}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "jev-latest", "state": "", "questions": {"is_urgent": {"type": "noul", "instructions": "Does the supplied customer message express urgency?"}}}')
f=Path(os.environ["AILOOT_TEXT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 source material")
text=f.read_text(encoding="utf-8")
if not text.strip():raise SystemExit("Source material must contain text")
p["state"]=text
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))
PY_RESULT
استلام النتائج وحفظها
Ailoot · System One
json
الاحتفاظ بكل النتائج المكتملة
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
احتفظ بكل إجابة حسب معرّف السؤال المقدَّم واحتمالها ودليل تفسير القيم؛ تتطلب معادلة الثقة التي تستخدم n أن يكون n>1، دون تقرير قاعدة API لحد أدنى من الخيارات.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلanswers.<id>.type | النوعstring |
الحقلanswers.<id>.noul | النوعnumber |
الحقلanswers.<id>.choice | النوعstring |
الحقلanswers.<id>.score | النوعnumber |
الحقلanswers.<id>.confidence | النوعnumber |
الحقلanswers.<id>.probabilities | النوعobject |
الحقلanswers.<id>.legend | النوعobject |
الحقلusage | النوعobject |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة | الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot jev-latest
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · jev-latest
- ما المدخلات والنتائج المتاحة؟
POST /v1/systemone·jev-latest:text→structured- ما الحقول التي يستخدمها الطلب؟
POST /v1/systemone·jev-latest:model,state,questions,stream- ما الحدود المطبقة؟
POST /v1/systemone·jev-latest:ctx:64000