Cloudflare: Clef
Cloudflare Clef הוא מודל רב־מודאלי לקבלת החלטות בגודל 27B, המיועד לסיווג, לבדיקות מדיניות ולבחירות בתהליכי עבודה של סוכנים. הוא בוחן מצב שסופק ושאלות בעלות טיפוס מוגדר, ומחזיר הסתברויות לחלופות המותרות, קטגוריות שנבחרו וציונים משוקללים. הוא מקבל ראיות טקסטואליות וחזותיות בלי ליצור טקסט.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-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 Clef הוא מודל רב־מודאלי לקבלת החלטות בגודל 27B, המיועד לסיווג, לבדיקות מדיניות ולבחירות בתהליכי עבודה של סוכנים. הוא בוחן מצב שסופק ושאלות בעלות טיפוס מוגדר, ומחזיר הסתברויות לחלופות המותרות, קטגוריות שנבחרו וציונים משוקללים. הוא מקבל ראיות טקסטואליות וחזותיות בלי ליצור טקסט.
- סוגי קלט נתמכים
- טקסט · תמונות
- תוצאות
- 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
- לא צוין כאשר נבחר מצב 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
FAQ · Cloudflare: Clef
- אילו קלטים ותוצאות זמינים?
POST /v1/systemone·cloudflare/clef:text,image→decisions- באילו שדות הבקשה משתמשת?
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user