Cloudflare: Clef Flash
Cloudflare Clef Flash هو نموذج Clef الأصغر لاتخاذ القرار، بحجم 9B، والمصمّم للتصنيف السريع واختيار خطوات سير العمل. يقيّم النص والحالة المنظّمة والمدخلات البصرية وفق أسئلة مسماة، ويعيد احتمالات لكل خيار، أو فئة مختارة، أو درجة مرتّبة، دون توليد نص نثري.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Cloudflare Clef Flash هو نموذج اتخاذ القرار الأصغر في عائلة Clef، وقد بُني عبر التدريب اللاحق لـQwen3.5-9B مع مشفّره البصري. يقرأ رأس مشترك للمخطط الأدلة من المدخلات ويقيّم الإجابات المسموح بها لكل سؤال مطلوب في مرور أمامي واحد. ودوره إنتاج تصنيفات وقرارات محصورة ضمن حدود محددة في سير العمل. يكون الناتج نتيجة محددة النوع مع احتمالات، بدلًا من إجابة حوارية يضطر التطبيق إلى تفسيرها باعتبارها فئة.
صِف الموقف في حالة نصية أو بصيغة JSON وحدّد الأسئلة بصورة منفصلة. يحتاج السؤال إلى اسم ثابت ونوع وتعليمة واضحة؛ كما تحدد أسئلة الفئات أو الدرجات معاييرها المسموح بها. بالنسبة إلى رسالة دعم، يمكن لسؤال أن يصنّف المشكلة، ولآخر أن يقيّم درجة الإلحاح، ولثالث أن يحدد ما إذا كان السجل يفتقر إلى المعلومات اللازمة للخطوة التالية. احتفظ بصياغة العميل الفعلية والسياق السابق ذي الصلة وقواعد التشغيل في الحالة حتى يرتبط القرار بالأدلة.
تلبي أنواع الأسئلة الثلاثة احتياجات مختلفة. نتيجة noul هي احتمال تحقق شرط صواب/خطأ. وتحدد نتيجة choice خيارًا واحدًا مسمى، وتشمل احتمالات البدائل وقيمة ثقة. أما نتيجة score فتقيّم معايير مرتبة وتعيد درجتها المرجّحة بالاحتمالات، ومفتاحها التوضيحي، وتوزيعها. حدّد ترتيب الدرجات عن قصد: فالتدرج من «لا حاجة إلى إجراء» إلى «مراجعة فورية» يختلف عن مجموعة غير مرتبة من تسميات الموضوعات.
للتوجيه السريع، صِف الفئات باستخدام الإجراءات أو حدود المسؤولية التي تميّز بينها فعلًا. ومن الأمثلة المفيدة طلب تتضمن خياراته الوصول إلى الحساب، والعطل التقني، وسؤالًا عن التوثيق، وأخرى، مع شرح كل خيار. يمكن تمرير نتيجة النموذج إلى قاعدة التوجيه في التطبيق. وتقارب توزيع الاحتمالات بين العطل التقني والوصول إلى الحساب دليل مفيد على الالتباس؛ حدّد صراحةً كيفية تعامل سير العمل مع مثل هذه الحالات بدلًا من افتراض أن التسمية المختارة تشخيص مؤكد.
للتصنيف البصري، قدّم صورة قابلة للقراءة وشرطًا يمكن للصورة دعمه. قد تسأل مراجعة إيصال عما إذا كان الإجمالي مقروءًا، وتختار من بين فئات محددة لجودة المستند. ولا ينبغي أن تطلب إجماليًا جديدًا اعتباطيًا كما لو كان النموذج خدمة غير مقيّدة للاستخراج أو الكتابة. تقبل واجهة الجهة المصنّعة ذات الأوزان المفتوحة أيضًا مصفوفات إطارات الفيديو. حافظ على الصلة بين الإطارات والحالة المكتوبة، واسأل عن أحداث أو ظروف مرئية داخل تلك المادة.
يذكر المرجع الحالي للواجهة المستضافة لدى الجهة المصنّعة سياقًا من 24,576 رمزًا، وما يصل إلى 64 سؤالًا وأربع صور مضمنة. وتقتصر صور PNG أو JPEG أو WebP على 4 MiB و16 ميغابكسل لكل صورة، بإجمالي 8 MiB بعد فك الترميز؛ ويقتصر جسم الطلب كاملًا على 13 MiB، ولا تُقبل روابط الصور البعيدة. تستهلك تعريفات الأسئلة والوسائط مساحة من المدخلات، وقد يُقتطع النص الطويل ليتّسع. ضع الأدلة الحاسمة في حالة موجزة. وتوضح Cloudflare في توثيقها أن تقليص السياق المستضاف لم يغيّر الأوزان المنشورة، لذا تظل النافذة المستضافة وإعدادات الأوزان المفتوحة أمرين منفصلين.
يجعل الناتج المقيّد للنموذج منه أداة مفيدة للفحوص المتكررة المتعلقة بالسياسات أو سير العمل. على سبيل المثال، حدّد أسئلة منفصلة تسأل عما إذا كان السجل يستوفي قواعد الاكتمال المعلنة وأي فئة متابعة تنطبق عليه. أبقِ المعايير صريحة وأدرج خيارًا للحالات التي لا تغطيها الفئات عندما يكون ذلك جزءًا من تصميم سير العمل. تقيّم الاحتمالات الخيارات المقدّمة؛ لكنها لا تثبت أن الخيارات تشكّل وصفًا كاملًا لكل موقف واقعي.
احتفظ بالحالة والمخطط والإجابة المُعادة معًا. عندما تكون النتيجة مفاجئة، افحص ما إذا كان أحد المعايير ملتبسًا، أو كانت مدخلات حاسمة مفقودة، أو اقتُطع نص ذو صلة. قارن تقييمات النموذج بحالات راجعها أشخاص من المهمة الفعلية قبل اختيار عتبات الإجراءات الآلية. ولا يغني تقديم Clef Flash بوصفه نموذجًا أصغر لاتخاذ قرارات سريعة عن التحقق من كلفة قرار توجيه خاطئ على سير العمل.
استخدم النتيجة المحددة النوع مدخلًا للخطوة التالية في التطبيق. لا ينفّذ النموذج تلك الخطوة ولا يكتب تفسيرها النهائي. وإذا احتاج المستخدم إلى تقرير، فاحتفظ بالقرار والأدلة المصدرية لتكون متاحة لعملية كتابة منفصلة. الأثر المفيد الناتج من Clef Flash هو إجابة قابلة للفحص لكل سؤال مسمى، مع المعلومات الاحتمالية اللازمة لتطبيق قواعد سير العمل.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef-flash
cloudflare/clef-flashالبداية
Cloudflare Clef Flash هو نموذج Clef الأصغر لاتخاذ القرار، بحجم 9B، والمصمّم للتصنيف السريع واختيار خطوات سير العمل. يقيّم النص والحالة المنظّمة والمدخلات البصرية وفق أسئلة مسماة، ويعيد احتمالات لكل خيار، أو فئة مختارة، أو درجة مرتّبة، دون توليد نص نثري.
- المدخلات المقبولة
- النص · الصور
- النتائج
- decisions
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · System One POST /v1/systemone
- الإدخال
text,image- الإخراج
decisions- صيغة الإخراج
- json
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود cloudflare/clef-flash | القيمة الافتراضية— |
الحقلprovider | النوعschema | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلquestions | النوعobject | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلsession_id | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلstate | النوعschema | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلtrace | النوعschema | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلuser | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلquestions.<id>.type | النوعstring | المتطلبمطلوب | القيم والحدود noul, choice, score | القيمة الافتراضية— |
الحقلquestions.<id>.instructions | النوعstring|object|array | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلquestions.<id>.criteria | النوعobject|array | المتطلباختياري | القيم والحدود الشروط: choice/score: مطلوبان؛ noul: اختياري. معايير choice كائن؛ وscore مصفوفة تتطلب minItems1. | القيمة الافتراضية— |
الحقلquestions.<id>.criteria.true | النوعstring|object|array | المتطلبمطلوب | القيم والحدود ينطبق عندما: تم توفير كائن معايير noul | القيمة الافتراضية— |
الحقلquestions.<id>.criteria.false | النوعstring|object|array | المتطلبمطلوب | القيم والحدود ينطبق عندما: تم توفير كائن معايير noul | القيمة الافتراضية— |
تركيبات مواد الإدخال
noul · مطلوب: state, questions.<id>.type=noul, questions.<id>.instructions
choice · مطلوب: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · مطلوب: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, state, questions |
المعلمةmaterial_types | المواصفاتtext, image |
المعلمةoptional_controls | المواصفاتprovider, session_id, trace, user |
المعلمةmultimodal_input_binding | المواصفاتاستخدم صيغة تمثيل الحالة أو المستند المُعلَنة بدقة فقط. إمكانات الصور لدى الشركة المصنّعة وحدها لا تثبت وجود وسيلة مقبولة خاصة بالنموذج لتمرير الصور. |
دورة الحياة: synchronous
أرسل معرّف النموذج الدقيق واحتفظ بالاستجابة الأصلية كاملة.
الباقات
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات Ailoot
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | رموز السياق، أكثر من | رموز السياق، حتى القيمة شاملةً | الرسوم |
|---|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | رموز السياق، أكثر من— | رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصى | الرسوم الإدخال · رموز الإدخال $0.000076 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
| الإعداداتالشريحة 1 لطول الطلب | جدول التعرفة— | رموز السياق، أكثر من0 | رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصى | الرسوم الإدخال · رموز الإدخال $0.000076 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · System One
{
"model": "cloudflare/clef-flash",
"questions": {
"is_bug": {
"criteria": {
"false": "The customer is asking a question or requesting a feature.",
"true": "The customer describes broken or unexpected product behavior."
},
"instructions": "Is the customer reporting a software defect?",
"type": "noul"
},
"team": {
"criteria": {
"account": "Login, permissions, or profile issues.",
"frontend": "Rendering, layout, or browser compatibility issues.",
"payments": "Checkout, billing, or payment processing issues."
},
"instructions": "Which team should own this ticket?",
"type": "choice"
},
"urgency": {
"criteria": [
"Can wait for the next release",
"Should be fixed this week",
"Blocking revenue right now"
],
"instructions": "How urgent is this ticket?",
"type": "score"
}
},
"state": {
"customer_tier": "enterprise",
"ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='cloudflare/clef-flash'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
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 Ultra · System One
json
الاحتفاظ بكل النتائج المكتملة
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
يُحتفظ بكل إجابة مقدَّمة مرتبطة بمعرّف سؤال، مع نوعها الدقيق وقيمة noul/choice/score والثقة والاحتمالات ودليل تفسير القيم. يُخزَّن JSON الأصلي كاملاً ولا يُعاد إلا بعد التسوية.
عند الحاجة إلى التحقق من الاستجابة الأصلية
احتفظ بالعملية الأصلية وبالرد كاملاً أو جزئياً؛ ولا تعِد تنفيذ POST.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلmodel | النوعstring |
الحقلid | النوعstring |
الحقلprovider | النوعstring |
الحقل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.input_tokens | النوعinteger |
الحقلusage.output_tokens | النوعinteger |
الحقلusage.cost | النوعnumber |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقل مطلوب أو صيغة تمثيل أو قيمة غير صالحة | الخطوة التاليةصحّح حقل الطلب المشار إليه. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra cloudflare/clef-flash
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Cloudflare: Clef Flash
- ما المدخلات والنتائج المتاحة؟
POST /v1/systemone·cloudflare/clef-flash:text,image→decisions- ما الحقول التي يستخدمها الطلب؟
POST /v1/systemone·cloudflare/clef-flash:model,provider,questions,session_id,state,trace,user