Cloudflare: Clef

Cloudflare Clef نموذج متعدد الوسائط لاتخاذ القرار بحجم 27B، مخصص للتصنيف وفحص السياسات واختيار خطوات سير عمل الوكلاء. يقيّم حالة مقدّمة وأسئلة محددة النوع، ويعيد احتمالات للبدائل المسموح بها وفئات مختارة ودرجات مرجّحة. ويقبل أدلة نصية وبصرية دون توليد نص نثري.

Ailoot Ultra · System One POST /v1/systemone cloudflare/clef

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Cloudflare Clef هو النموذج الكثيف الأكبر في عائلة Clef لاتخاذ القرار، وقد خضع لتدريب لاحق انطلاقًا من Qwen3.8-27B مع مشفّره البصري. تجمع Cloudflare تلك البنية الأساسية مع رأس مشترك للمخطط يوجّه الأدلة إلى الأسئلة ويقيّم خياراتها المسموح بها معًا. يقرأ Clef الموقف ويعيد قرارات محصورة ضمن حدود محددة ومصحوبة باحتمالات في مرور أمامي واحد. وناتجه نتيجة تصنيف، بدلًا من نص مولّد أو تقرير مفتوح أو أمر مقترح.

جهّز الحالة ومخطط الأسئلة كمدخلين منفصلين. يمكن أن تكون الحالة سلسلة نصية أو JSON يمثّل سجلًا أو محادثة أو محتوى مستند أو موقفًا داخل التطبيق. تُفهرس الأسئلة بأسماء ثابتة، وتُستخدم الأسماء نفسها لتعريف إجاباتها المُعادة. حدّد ما ينبغي أن يثبته كل سؤال وصِف الخيارات ذات الصلة. يمكن لسجل دعم أن يسأل عن الفريق الذي ينبغي أن يتولى الطلب، وما إذا كان الأثر عاجلًا، وأي معيار للخطورة ينطبق، دون دمج هذه القرارات المختلفة في فئة مبهمة واحدة.

يعيد سؤال noul احتمال صحة شرط ثنائي. ويعيد سؤال choice خيارًا مسمى مختارًا، واحتمالات لكل خيار، وثقة. ويستخدم سؤال score قائمة مرتبة من الأوصاف تبدأ فهرستها من الصفر، ويعيد درجة متوقعة ومفتاحًا توضيحيًا واحتمالات. والدرجة الكسرية ذات معنى لأنها تلخّص عدم اليقين عبر مستويات مرتبة. افحص التوزيع إلى جانب الإجابة المختارة؛ فقد يكشف تقارب خيارين عن فارق لا تحسمه المدخلات.

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

بالنسبة إلى الأدلة البصرية، قدّم صورة قابلة للقراءة وسؤالًا عن حالة مرئية أو فئة محددة. قد يقيّم فحص جودة نموذج مدى الوضوح، ووجود مساحة مطلوبة، وأي مستوى من مستويات الجودة المقدّمة يصفه على أفضل وجه. تقبل واجهة الجهة المصنّعة ذات الأوزان المفتوحة أيضًا مصفوفات إطارات الفيديو. حافظ على ترتيب الإطارات وحدّد الحدث المطلوب تقييمه. يمكن لمخطط قرار محدود تصنيف تلك المادة، بينما ينتمي طلب وصف سردي أو حقول جديدة مولّدة اعتباطيًا إلى نوع مختلف من المخرجات.

يذكر المرجع المستضاف لدى الجهة المصنّعة سياقًا من 65,536 رمزًا، ومن سؤال واحد إلى 64 سؤالًا، وما يصل إلى أربع صور مضمنة. وتقتصر صور PNG أو JPEG أو WebP على 4 MiB و16 ميغابكسل لكل صورة، بإجمالي 8 MiB بعد فك الترميز؛ ويقتصر جسم الطلب كاملًا على 13 MiB، ولا تُقبل روابط الصور البعيدة. تشمل ميزانية المدخلات الأسئلة والوسائط. وقد يُقتطع النص الطويل ليتّسع، لذا حافظ على المقاطع الحاسمة وتسميات المصادر. تصف هذه الحدود واجهة الصور المستضافة لدى المنتج؛ وللمشفّر ذي الأوزان المفتوحة تمثيلاته الخاصة للمدخلات المحلية.

يصف إصدار Cloudflare تدريبًا للتقييم المقيّد بالمخطط ومعايرة الاحتمالات. يستخرج النموذج الأدلة ذات الصلة بكل خيار، ثم ينظر في المعلومات عبر الحقول. يمكن أن يدعم ذلك اتخاذ قرارات لعدة أسئلة مترابطة في سجل واحد، لكنه لا يجعل الاحتمال المرتفع ضمانًا لصحة الواقعة الأساسية. قيّم السجلات الصعبة والناقصة والخارجة عن الفئات إلى جانب الحالات الواضحة. تغطي معايير القرار المفيدة المواقف التي يواجهها سير العمل فعلًا وتجعل الفوارق المهمة صريحة.

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

الأثر النهائي هو كائن الإجابات مع الحالة والمخطط اللذين أنتجاه. استخدم تلك السجلات لفحص التصنيفات غير المتوقعة، وتحديد المعايير الملتبسة، ومقارنة النتائج بأمثلة من المهمة خضعت للمراجعة. وإذا احتاج مستخدم لاحق إلى تفسير مكتوب، فيمكن أن يكون القرار والأدلة الأصلية مدخلات لخطوة منفصلة لكتابة الرد. يقدّم Clef القرار الاحتمالي المحدود اللازم لاختيار تلك المرحلة التالية مع بيان واضح لما جرى تقييمه.

Ailoot Ultra · System One POST /v1/systemone cloudflare/clef

cloudflare/clef

Cloudflare /cloudflare/clef

البداية

المدخلات المقبولة: النص · الصور
النتائج: decisions

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · System One POST /v1/systemone

الإدخال: text, image
الإخراج: decisions
صيغة الإخراج: json

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود cloudflare/clef	القيمة الافتراضية—
الحقل`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.00048 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز
الإعداداتالشريحة 1 لطول الطلب	جدول التعرفة—	رموز السياق، أكثر من⁦0⁩	رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصى	الرسوم الإدخال · رموز الإدخال $0.00048 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

أمثلة للطلبات

Ailoot Ultra · System One

بنية الطلب الرسمية المحفوظة؛ مثال توثيقياستخدم مواد طلبك الفعلية واحتفظ بالنتيجة كاملة

{
  "model": "cloudflare/clef",
  "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'
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

الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

معرّفات النماذج ذات الصلة IDs

cloudflare/clef

FAQ · Cloudflare: Clef

ما المدخلات والنتائج المتاحة؟: POST /v1/systemone · cloudflare/clef: text, image → decisions
ما الحقول التي يستخدمها الطلب؟: POST /v1/systemone · cloudflare/clef: model, provider, questions, session_id, state, trace, user

Cloudflare: Clef

Cloudflare: Clef

البداية

متاح في Ailoot · المدخلات والطرائق

الباقات

تعرفات Ailoot

الأسعار حسب الإعدادات

أمثلة للطلبات

Ailoot Ultra · System One

استلام النتائج وحفظها

Ailoot Ultra · System One

الاحتفاظ بكل النتائج المكتملة

عند الحاجة إلى التحقق من الاستجابة الأصلية

الأسماء البديلة

الأسماء البديلة للنموذج

الأسماء البديلة لمسارات الطرائق

معرّفات النماذج ذات الصلة IDs

الشركة ومحفظة مشاريعها

اشتر الرموز بخصم.

اربط API بالمنتج الذي تبيعه.