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
- לא צוין כאשר נבחר מצב 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