أطلقت Cloudflare خدمة Clef-omni في 9 أكتوبر كنموذج لاتخاذ القرار مستضاف على Workers AI، ويمكنه فحص النص إلى جانب صورة أو مقطع صوتي أو فيديو. الاختبار المفيد لمطوّر التطبيقات محدود: أعطِ النموذج حالة التذكرة ومجموعة ثابتة من الأسئلة، وافحص إجاباته، واترك قرار التوجيه لشخص. يتبع هذا الدليل وثائق النموذج الحالية لدى Cloudflare و مثال الإطلاق. لم تشغّل BIG CHANGE واجهة API ولم تقس دقتها على تذاكر الدعم.

معرّف النموذج هو @cf/cloudflare/clef-omni على Workers AI. إنه نموذج لاتخاذ القرار: يحدد المستدعي أسئلة ذات أنواع محددة وخيارات مسموح بها، ثم يتلقى درجات لتلك الخيارات. لا يكتب رد دعم. كما أصدرت Cloudflare أوزاناً مفتوحة، لكن الخطوات أدناه تستخدم نقطة النهاية المستضافة لديها. أرقام السرعة والمعايير التي تذكرها Cloudflare هي ادعاءاتها؛ ولا تثبت مدى نجاح هذا المسار على تذاكرك.

جهّز الوصول ومجموعة أسئلة محدودة

تحتاج إلى حساب Cloudflare يتيح Workers AI، ومعرّف الحساب، ورمز API لـ Workers AI، وإما Python مع requests مثبتة أو أداة تستطيع إرسال طلب HTTP نفسه. يوضح دليل إعداد REST من Cloudflare أين تنسخ معرّف الحساب وكيف تنشئ الرمز في لوحة التحكم. يحتاج الرمز الذي تنشئه يدوياً إلى صلاحيتَي Workers AI - Read و Workers AI - Edit . أبقِ الرمز خارج التذكرة ونظام إدارة الشيفرة المصدرية.

إرسال تذكرة حقيقية أو مرفق ينقل محتوى العميل إلى Cloudflare لمعالجته. تقول صفحة Cloudflare لاستخدام بيانات Workers AI إنها لا تستخدم هذا المحتوى لتدريب النماذج المقدمة على Workers AI أو لتحسين الخدمات من دون موافقة صريحة؛ وتقول أيضاً إن المحتوى قد يُخزّن عند استخدام Workers AI مع خدمة تخزين مثل R2 أو KV. قبل إرسال تذاكر العملاء، تحقّق من اتفاقية Cloudflare المنطبقة وقواعد مؤسستك لبيانات العملاء، وقلّل المعلومات الشخصية أو احجبها حيثما أمكن. لا يكفي بيان Cloudflare بعدم التدريب لإثبات الإذن بإرسال بيانات عميل بعينه.

ابدأ بالنص كي تفحص الاستجابة قبل إضافة الوسائط. يستخدم مثال الدعم الخاص بـ Cloudflare الحالة Checkout has been failing for every customer for the last hour ويطرح ثلاثة أسئلة: هل الأمر عاجل (noul، من النوع نعم/لا)، وأي فريق ينبغي أن يتولاه (choice)، وما مدى شدة الأثر (score)؟ هذا مثال موثق وليس حادثة مرصودة. تقبل واجهة API سلسلة نصية أو كائناً/مصفوفة منظّمة بوصفها state. يجب أن تتضمن خريطة questions من 1 إلى 64 معرّفاً للأسئلة؛ ولكل منها نوع وتعليمات، بينما تستخدم choice و score معايير لتحديد الردود المسموح بها.

أرسل طلب النص

اضبط CLOUDFLARE_AUTH_TOKEN في بيئتك واستبدل معرّف الحساب أدناه. يكيّف طلب Python هذا نقطة النهاية والحقول نفسها الواردة في مثال نموذج Cloudflare:

Python
import os
import requests

account_id = "your-account-id"
token = os.environ["CLOUDFLARE_AUTH_TOKEN"]

payload = {
    "model": "clef-omni",
    "state": "Checkout has been failing for every customer for the last hour.",
    "questions": {
        "urgent": {
            "type": "noul",
            "instructions": "Is this support request urgent?",
        },
        "team": {
            "type": "choice",
            "instructions": "Which team should handle this request?",
            "criteria": {
                "billing": "Payments, invoices, and refunds",
                "technical": "Outages, errors, and configuration",
                "sales": "Plans and upgrades",
            },
        },
        "severity": {
            "type": "score",
            "instructions": "How severe is the customer impact?",
            "criteria": ["No impact", "Minor", "Major", "Critical"],
        },
    },
}

response = requests.post(
    f"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/run/@cf/cloudflare/clef-omni",
    headers={"Authorization": f"Bearer {token}"},
    json=payload,
    timeout=60,
)
response.raise_for_status()
print(response.json())

للتحقق من النجاح، ابحث عن إدخالات answers في الاستجابة تحت المعرّفات نفسها: urgent و team و severity . تصف Cloudflare الأول بأنه احتمال العجلة، والثاني بأنه الفريق المحدد مع احتمالات خياراته، والثالث بأنه درجة موزونة بالاحتمال يكون أدنى مستوى فيها صفراً. توثق واجهة API أيضاً حقلي الاستجابة model و usage . افحص JSON كاملاً الذي يعيده حسابك قبل ربطه بتطبيق. الاحتمال هو ناتج النموذج للسؤال والحالة المقدمين، وليس ضماناً بأن التذكرة الحقيقية تنتمي إلى ذلك الصف. اطلب من شخص مقارنة التذكرة وأي مرفق بالمسار المقترح قبل اتخاذ إجراء.

أضف صورة أو تسجيلاً أو فيديو

من Cloudflare طلب الإطلاق يضع الوسائط الاختيارية في مصفوفات منفصلة images, audio و videos مصفوفات، على هيئة عناوين base64 data: عناوين URL مضمنة. مثلاً يستخدم النموذج data:image/png;base64,..., data:audio/mpeg;base64,... و data:video/mp4;base64,.... لإضافة ملف محلي إلى حمولة Python قبل requests.post, شفّره وأضف عنوان البيانات إلى المصفوفة المناسبة:

Python
import base64
from pathlib import Path

def add_media(payload, field, file_path, mime_type):
    raw = Path(file_path).read_bytes()
    encoded = base64.b64encode(raw).decode("ascii")
    payload.setdefault(field, []).append(f"data:{mime_type};base64,{encoded}")

# Examples: use only the files present in the ticket, with their real MIME types.
# add_media(payload, "images", "photo.png", "image/png")
# add_media(payload, "audio", "recording.mp3", "audio/mpeg")
# add_media(payload, "videos", "clip.mp4", "video/mp4")

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

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

تحقق من التكلفة والسياق وحالات الإخفاق

تسعّر Cloudflare حالياً Clef-omni بمبلغ $0.15 لكل مليون رمز إدخال وتقول إنها لا تفرض رسوماً على رموز الإخراج. تُحوّل الوسائط إلى رموز إدخال وفق ذلك السعر. تذكر صفحة النموذج نحو 780 رمزاً لكل دقيقة صوت، وما يصل إلى نحو 15,400 رمز لكل دقيقة فيديو بأقصى دقة، إضافة إلى رموز الصوت عندما يحتوي الفيديو على صوت. تعتمد تكلفة الصورة على حجمها بعد تغيير المقاس، وتُحد عند 1,024 رمزاً للصورة. هذه قواعد فوترة وليست سعراً ثابتاً لكل مرفق.

للنموذج المستضاف سياق بسعة 64,000 رمز. وتُحتسب الوسائط والأسئلة ضمنه. إذا تجاوزت النافذة، تقول Cloudflare إن الطلب يفشل؛ وإلا فقد يُقتطع النص الطويل في state ليتسع. لذلك لا تثبت الإجابة المستلمة أن النموذج أخذ كل سطر من تذكرة طويلة في الحسبان. عند فشل الطلب، افحص خطأ HTTP وقلّل المرفقات أو أزلها ضمن الحدود الموثقة قبل إعادة المحاولة. وعند نجاحه، تحقق من وجود معرّفات الأسئلة المتوقعة، واحتفظ بالتذكرة الأصلية للمراجعة، وقارن المسار المقترح بالأدلة. قد تساعد احتمالات النموذج المراجع على تركيز الانتباه، لكن ضمان الخدمة أو تحديد عتبة آلية آمنة يتطلب تقييماً على تذاكرك المصنفة أنت.

التغيير الكبير

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

المصادر ومزيد من القراءة

  • وثائق نموذج Cloudflare Clef-omni، روجعت في 10 أكتوبر 2026. المرجع الأساسي لمعرّف النموذج المستضاف وحقول API والمثال وحدود الوسائط والسياق وشكل الاستجابة وسعر الرمز المدرج. تصف الوثائق سلوك الخدمة؛ ولم تنفذ BIG CHANGE الطلب.
  • منشور إطلاق Clef-omni من Cloudflare، 9 أكتوبر 2026. يثبت تاريخ الإطلاق ويقدم مثال طلب الوسائط المضمنة. أرقام الأداء والمعايير هي ادعاءات Cloudflare نفسها.
  • إعداد REST لـ Cloudflare Workers AI، آخر تحديث في 15 سبتمبر 2026 ومراجعة في 10 أكتوبر. يوضح كيفية الحصول على معرّف الحساب ورمز API ويحدد الصلاحيات المطلوبة للرمز المنشأ يدوياً.
  • استخدام بيانات Cloudflare Workers AI، آخر تحديث في 21 أبريل 2026 ومراجعة في 10 أكتوبر. يشرح معالجة Cloudflare لمحتوى العملاء، والقيود التي تعلنها على التدريب وتحسين الخدمة دون موافقة صريحة، والتخزين المحتمل عند استخدام خدمة تخزين منفصلة، وحدود الاتفاقية المنطبقة. ولا يحدد ما إذا كان يجوز للمطور إرسال تذكرة أو تسجيل بعينه.