LiquidAI: d1
תהליך ההחלטות הטקסטואלי של Liquid AI d1 מעריך ראיות שסופקו מול תוצאות קבועות ומחזיר הסתברויות, בחירת קטגוריה או ציון לפי מחוון. הוא תומך בסיווג, בניתוב, בסינון לפי רלוונטיות ובתעדוף בלי ליצור תשובה כתובה.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
d1 הוא מודל ההחלטה המתארח של Liquid AI למשימות סיווג, ניתוב ומתן ציונים תחומות. הפרופיל הזה מכסה את תהליך ההחלטות הטקסטואלי שלו: מספקים את הראיות כמצב, מגדירים שאלה אחת או יותר ומקבלים תשובות מספריות בעלות טיפוס מוגדר על תוצאות ידועות. Liquid מתארת את ההחלטות האלה כהערכות שמחזירות הסתברויות ישירות, עם אפס טוקני פלט שנוצרו. התוצאה השימושית היא החלטה מוגדרת ואי־הוודאות שלה, ולא קטע טקסט שחובר מחדש.
הכינו יחד את הראיות ואת השאלה
ספקו את הטקסט שמאפשר את ההחלטה, כולל ההקשר הדרוש לפירושו. שמרו את המצב בנפרד מההוראות שמתארות מה להעריך. הודעת תמיכה עשויה להזדקק לתיאור מוצר או בעיה; קטע ממסמך עשוי להזדקק לשאלת החיפוש של המשתמש. הגדירו את קבוצת התשובות לפני השאלה ותנו לכל אפשרות משמעות המתאימה לתהליך העבודה המיועד. תוויות קצרות יכולות לשמש מפתחות פלט קבועים, ואילו תיאורים מסבירים את הגבולות ביניהן.
השתמשו בשאלות בעלות שמות על מצב משותף. שם ברור כגון intent, urgency או relevant שומר על הקשר בין הפלט להחלטה שהוא מייצג. לדוגמה, הודעה שמדווחת שדף אינו עובד יכולה לתמוך בבחירת כוונה, במחוון דחיפות ובבדיקת כן/לא על פגם שדווח. כל שאלה צריכה לשמור על הקריטריון שלה במקום לשלב את כל שלושת השיפוטים בתווית עמומה אחת.
choice לקטגוריות ולניתוב
שאלת choice בוחרת תווית אחת מקבוצה לא מסודרת ומחזירה את ההתפלגות על פני האפשרויות בעלות השמות. הגדירו את האפשרויות באמצעות תיאורי קריטריונים; התוצאה כוללת את הבחירה שנבחרה, הסתברויות וביטחון. לארגון מסמכים, הגדירו את התיקיות או הנושאים האפשריים וציינו איזה תוכן שייך לכל אחד. לניתוב בקשות, תארו את היעדים הקיימים בפועל. יישום יכול להשתמש בתווית שהתקבלה לבחירת הצעד הבא ולשמור את ההסתברויות המתחרות לסקירה.
משימת תיוק לדוגמה יכולה להפריד בין שאלה על מוצר, בעיית אינטגרציה ובעיית גישה, עם אפשרות other לחומר שנמצא מחוץ להגדרות האלה. שמרו על גבולות מוחשיים: הודעה על חוסר יכולת לבצע אימות שונה מהודעה ששואלת איך להגדיר תכונה. התווית שהוחזרה בוחרת בין משמעויות שסופקו; היא אינה יוצרת יעד חסר או מבצעת שינוי במערכת אחרת.
noul לבדיקת תנאים ורלוונטיות
שאלת noul מחזירה הסתברות מ־0 עד 1 שתנאי כן/לא מוגדר מתקיים. Liquid מדגימה בדיקות בינאריות לסקירת תוכן ולרלוונטיות של קטעים. הגדירו את התנאי במדויק ובחרו כיצד תשתמשו בהסתברות המתקבלת: סימון התאמה סבירה, סינון קטע או שליחת מקרה לא ודאי לסקירה. הסף שייך למשימה הצורכת את התוצאה, ואין לראות בהסתברות פסק דין עובדתי מובטח.
לסינון לפי רלוונטיות, ספקו הן את השאילתה והן את הקטע המועמד. שאלו אם הקטע עוזר לענות על השאילתה, ואז שמרו את הקטע המקורי עם ההסתברות שלו. הדבר יכול לתמוך בבחירת חומר מקור לתשובה מאוחרת יותר בלי לבקש מ־d1 לחבר בעצמו את התשובה הזאת. אם רלוונטיות דורשת כמה דרגות ולא תנאי כן/לא, הגדירו מחוון מסודר והשתמשו בשאלת score.
score לרמות מסודרות
שאלת score ממקמת את המצב במחוון עם רמות מסודרות ומתוארות. אינדקסי הרמות מתחילים ב־0, והציון הוא המיקום שלהן המשוקלל לפי הסתברויות, שיכול להימצא בין רמות. התוצאה כוללת גם את התפלגות הרמות ואת הביטחון. לדחיפות, הגדירו מה מבדיל בין בעיה ללא השפעה מיידית, אי־נוחות משמעותית ומשימה חסומה. לכן למחוון בן ארבע רמות יש אינדקסים מ־0 עד 3; הציון הצפוי שלו אינו אוטומטית קטגוריה שמספרה מ־1 עד 4.
השתמשו בציון השברי למיון או לצבירה כאשר זו התוצאה המיועדת, ושמרו את ההתפלגות המלאה כאשר העמימות חשובה. לקטגוריות כגון מחלקות אין סדר טבעי, והן שייכות לשאלת choice. הביטחון מסכם עד כמה התשובה המדווחת חד־משמעית בממשק המתועד; הוא צריך להישאר נפרד מהציון הרצוי למשימה ומהנחה של ערובה לכך שההחלטה נכונה.
שאלות מרובות ויישומי היצרן
כמה שאלות יכולות להעריך אותו מצב בקריאה אחת ליצרן, כאשר כל אחת שומרת על הטיפוס וההסתברויות שלה. דוגמאות הטקסט של Liquid כוללות סינון פניות תמיכה, תיוק מסמכים בטקסונומיית תיקיות, בחירת נתיבי חיפוש בקוד, בחירה בין פעולות סוכן זמינות והחלטה איזה חומר מפלט כלי לשמור. לכל תהליכי העבודה האלה יש החלטת המשך תחומה. שלב חיפוש בקוד יכול לבחור תיקייה מבטיחה מתוך התיאורים שלה; שלב בחירת תוכן יכול לבחור keep, trim או drop לחומר שסופק. היישום העוטף עדיין משיג את נתוני המקור ומבצע את הפעולה שנבחרה.
היקף ותוצר החלטה שימושי
אבני הבניין המתועדות מתאימות לתוצאות ידועות, לדירוגים לפי מחוון ולבדיקות תנאים. טקסט חדש, סיכומים, קוד ושיחה פתוחה דורשים תהליך יצירה, ואינם משתמעים מתוצאת ההחלטה של d1. הכינו שאלה סביב ראיות שניתן לצפות בהן ושמרו את הגדרות השאלה עם הפלט, כדי שאפשר יהיה לפרש מאוחר יותר תווית או ציון.
מקדו כל מצב בראיות שעונות על השאלות שהוגדרו עבורו והפרידו משימות החלטה לא קשורות, כדי שהקריטריונים שלהן יישארו ברורים. שמרו על חומר מקור רלוונטי, הגדירו משמעויות חלופיות למקרים שבהם כיסוי הקטגוריות אינו מלא והעריכו ספי הסתברות באמצעות דוגמאות מסומנות מהמשימה. תוצר שימושי מתעד את הקטגוריה שנבחרה או את הציון הצפוי לצד ההתפלגות, זהות השאלה והראיות המקוריות.
Ailoot Ultra · System One POST /v1/systemone liquid/d1
liquid/d1התחלה
תהליך ההחלטות הטקסטואלי של Liquid AI d1 מעריך ראיות שסופקו מול תוצאות קבועות ומחזיר הסתברויות, בחירת קטגוריה או ציון לפי מחוון. הוא תומך בסיווג, בניתוב, בסינון לפי רלוונטיות ובתעדוף בלי ליצור תשובה כתובה.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- decisions
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · System One POST /v1/systemone
- סוגי קלט
text- סוגי פלט
decisions- פורמט פלט
- json
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות liquid/d1 | ברירת מחדל— |
שדה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 |
פרמטרoptional_controls | מפרטprovider, session_id, trace, user |
פרמטרmultimodal_input_binding | מפרטnull |
מחזור חיים: synchronous
יש לשלוח את מזהה המודל המדויק ולשמור את התגובה המלאה בפורמט המקורי.
תעריפים
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפי Ailoot
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | טוקנים בהקשר, יותר מ- | טוקנים בהקשר, עד וכולל | חיוב |
|---|---|---|---|---|
| תצורהתעריפי הבסיס לטוקנים | טבלת תעריפיםתעריף בסיס | טוקנים בהקשר, יותר מ-— | טוקנים בהקשר, עד וכוללללא גבול עליון | חיוב קלט · טוקני קלט $0.00008 / 1K טוקנים פלט · טוקני פלט $0 / 1K טוקנים קלט · קריאה מהמטמון $0.00008 / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים |
| תצורהרמת אורך בקשה 1 | טבלת תעריפים— | טוקנים בהקשר, יותר מ-0 | טוקנים בהקשר, עד וכוללללא גבול עליון | חיוב קלט · טוקני קלט $0.00008 / 1K טוקנים פלט · טוקני פלט $0 / 1K טוקנים קלט · קריאה מהמטמון $0.00008 / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · System One
{
"model": "liquid/d1",
"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']='liquid/d1'
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 liquid/d1
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · LiquidAI: d1
- אילו קלטים ותוצאות זמינים?
POST /v1/systemone·liquid/d1:text→decisions- באילו שדות הבקשה משתמשת?
POST /v1/systemone·liquid/d1:model,provider,questions,session_id,state,trace,user