نسخة Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# كيفية فحص تذكرة دعم باستخدام Cloudflare Clef-omni

> يقبل Clef-omni من Cloudflare حالة التذكرة والأسئلة المحددة النوع ومدخلات اختيارية من الصور أو الصوت أو الفيديو. يغطي هذا الدليل المستند إلى الوثائق فقط طلب Workers AI والاستجابة والسعر والحدود.

By BIG CHANGE Editorial

Published: 2026-10-10T13:09:00.735Z
Updated: 2026-10-10T13:09:00.735Z
Canonical: https://bigchange.ai/blog/cloudflare-clef-omni-support-ticket-guide

![A hand rests on a mouse beside a monitor showing an unlabeled ticket and attachment list, with a printed equipment image in the foreground.](https://bigchange.ai/api/media/file/clef-omni-ticket-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

أطلقت Cloudflare خدمة Clef-omni في 9 أكتوبر كنموذج لاتخاذ القرار مستضاف على Workers AI، ويمكنه فحص النص إلى جانب صورة أو مقطع صوتي أو فيديو. الاختبار المفيد لمطوّر التطبيقات محدود: أعطِ النموذج حالة التذكرة ومجموعة ثابتة من الأسئلة، وافحص إجاباته، واترك قرار التوجيه لشخص. يتبع هذا الدليل [وثائق النموذج الحالية لدى Cloudflare](https://developers.cloudflare.com/workers-ai/models/clef-omni/) و [مثال الإطلاق](https://blog.cloudflare.com/clef-faster-cheaper-multimodal/). لم تشغّل BIG CHANGE واجهة API ولم تقس دقتها على تذاكر الدعم.

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

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

تحتاج إلى حساب Cloudflare يتيح Workers AI، ومعرّف الحساب، ورمز API لـ Workers AI، وإما Python مع `requests` مثبتة أو أداة تستطيع إرسال طلب HTTP نفسه. [يوضح دليل إعداد REST من Cloudflare](https://developers.cloudflare.com/workers-ai/get-started/rest-api/) أين تنسخ معرّف الحساب وكيف تنشئ الرمز في لوحة التحكم. يحتاج الرمز الذي تنشئه يدوياً إلى صلاحيتَي `Workers AI - Read` و `Workers AI - Edit` . أبقِ الرمز خارج التذكرة ونظام إدارة الشيفرة المصدرية.

إرسال تذكرة حقيقية أو مرفق ينقل محتوى العميل إلى Cloudflare لمعالجته. [تقول صفحة Cloudflare لاستخدام بيانات Workers AI](https://developers.cloudflare.com/workers-ai/platform/data-usage/) إنها لا تستخدم هذا المحتوى لتدريب النماذج المقدمة على 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](https://developers.cloudflare.com/workers-ai/models/clef-omni/):

```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 [طلب الإطلاق](https://blog.cloudflare.com/clef-faster-cheaper-multimodal/) يضع الوسائط الاختيارية في مصفوفات منفصلة `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 لوسائط بعيدة.

تحقق من الحدود قبل الترميز. تسمح [صفحة النموذج](https://developers.cloudflare.com/workers-ai/models/clef-omni/) بما يصل إلى أربع صور 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](https://developers.cloudflare.com/workers-ai/models/clef-omni/)، روجعت في 10 أكتوبر 2026. المرجع الأساسي لمعرّف النموذج المستضاف وحقول API والمثال وحدود الوسائط والسياق وشكل الاستجابة وسعر الرمز المدرج. تصف الوثائق سلوك الخدمة؛ ولم تنفذ BIG CHANGE الطلب.
- [منشور إطلاق Clef-omni من Cloudflare](https://blog.cloudflare.com/clef-faster-cheaper-multimodal/)، 9 أكتوبر 2026. يثبت تاريخ الإطلاق ويقدم مثال طلب الوسائط المضمنة. أرقام الأداء والمعايير هي ادعاءات Cloudflare نفسها.
- [إعداد REST لـ Cloudflare Workers AI](https://developers.cloudflare.com/workers-ai/get-started/rest-api/)، آخر تحديث في 15 سبتمبر 2026 ومراجعة في 10 أكتوبر. يوضح كيفية الحصول على معرّف الحساب ورمز API ويحدد الصلاحيات المطلوبة للرمز المنشأ يدوياً.
- [استخدام بيانات Cloudflare Workers AI](https://developers.cloudflare.com/workers-ai/platform/data-usage/)، آخر تحديث في 21 أبريل 2026 ومراجعة في 10 أكتوبر. يشرح معالجة Cloudflare لمحتوى العملاء، والقيود التي تعلنها على التدريب وتحسين الخدمة دون موافقة صريحة، والتخزين المحتمل عند استخدام خدمة تخزين منفصلة، وحدود الاتفاقية المنطبقة. ولا يحدد ما إذا كان يجوز للمطور إرسال تذكرة أو تسجيل بعينه.

## Sources

- [وثائق نموذج Cloudflare Clef-omni](https://developers.cloudflare.com/workers-ai/models/clef-omni/) — معرّف النموذج المستضاف ومخطط الطلب والمخرجات وحدود الوسائط وفوترة الرموز والسعر والسياق؛ وثائق وليست اختباراً أجرته BIG CHANGE.
- [تقديم Clef-omni](https://blog.cloudflare.com/clef-faster-cheaper-multimodal/) — تاريخ الإطلاق ومثال طلب الوسائط المضمنة؛ ادعاءات المورّد عن الأداء والمعايير ليست أدلة مستقلة.
- [البدء: REST API لـ Workers AI](https://developers.cloudflare.com/workers-ai/get-started/rest-api/) — معرّف الحساب وإعداد رمز Workers AI وصلاحيات الرمز المنشأ يدوياً.
- [استخدام بيانات Workers AI](https://developers.cloudflare.com/workers-ai/platform/data-usage/) — آخر تحديث في 21 أبريل 2026؛ تقول Cloudflare إنها تعالج المدخلات لتوفير Workers AI ولا تستخدمها للتدريب أو تحسين الخدمة دون موافقة صريحة؛ وقد تخزنها عند استخدام خدمة تخزين. تحقّق من الاتفاقيات وقواعد البيانات المنطبقة.