Inception: Mercury Decide
Mercury Decide מעריך ראיות משותפות בטקסט או ב־JSON מול שאלות בעלות שמות ומחזיר בחירות בעלות טיפוס מוגדר, הסתברויות כן/לא או ציונים שבריים לפי מחוון. Inception מתעדת תהליך החלטה ייעודי עם עד 255 אפשרויות Choice ועשר רמות Score.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Mercury Decide הוא מודל של Inception להחלטות מובנות על ראיות שסופקו. הוא משלב מצב משותף עם שאלות בעלות שמות ומחזיר תשובות בעלות טיפוס מוגדר עם הסתברויות. התוצאה יכולה להיות קטגוריה שנבחרה, הסתברות כן/לא משוערת או מיקום בסולם מוגדר. הפרופיל הזה משרת החלטה תחומה שתוכנה יכולה לפרש; הממשק המתועד שלו אינו יוצר תשובת צ׳אט חופשית.
מצב משותף ושמות שאלות בעלי משמעות
בקשת היצרן מכילה model, state ומפה לא ריקה של questions. שמות השאלות נשמרים במפת התשובות. ספקו את המידע הדרוש לשיפוט של כל שאלה ותנו לשאלות שמות סביב התוצאות שתהליך העבודה משתמש בהן, כגון category, priority או needs_follow_up. כמה שאלות מעריכות את אותן ראיות באופן עצמאי. המיקום שלהן בבקשה אחת אינו גורם לשאלה מאוחרת להיות תלויה בתשובה קודמת.
הדוגמה של Inception משתמשת באובייקט JSON למצב. המדריך מתיר גם מחרוזות, אובייקטים או מערכים במצב, בהוראות ובתיאורי הקריטריונים, כאשר ההוראות אופציונליות או null. שמרו מבנה שימושי כאשר הראיות כבר מורכבות משדות, ודאגו שאפשר יהיה לזהות מסמך או הודעה בעת אספקת טקסט. במקרה תמיכה, כללו את הבקשה בפועל ואת העובדות הרלוונטיות, במקום בקשה להסיק הקשר חסר.
noul: תשובה חיובית משוערת
שאלת noul מייצגת תנאי כן/לא. הפלט שלה הוא הסתברות מ־0 עד 1 שהתשובה החיובית חלה. תיאורי true ו־false אופציונליים יכולים לציין מה נחשב בכל צד של השאלה. לדוגמה, שאלו אם הודעה מבקשת במפורש החלפה והבחינו בין כך לבין תלונה כללית על הפריט. ההסתברות מספקת שיפוט מספרי; היישום בוחר את הסף ואת הפעולה הנובעת ממנו בתהליך העבודה.
שמרו על תנאי צר מספיק כדי שהראיות יוכלו להכריע בו. אם שאלה אחת מערבבת אם המשתמש רוצה עזרה, אם פריט פגום ואם המקרה דחוף, הפרידו את התנאים האלה. שמרו את ההסתברות שהוחזרה עם הגדרת השאלה, כדי שסוקר בהמשך יוכל לדעת מה המספר מודד בפועל.
Choice: בחירת אפשרות אחת בעלת שם
שאלת Choice משתמשת במפה של שם אפשרות אחד עד 255 שמות ותיאורים; התיאורים יכולים להיות null. הבחירה המוחזרת היא האפשרות שסופקה בעלת ההסתברות הגבוהה ביותר. התוצאה מכילה גם הסתברות לכל אפשרות וביטחון. הגדירו משמעויות נבדלות לקטגוריות וכללו קטגוריית ברירת מחדל כאשר חלק מהקלטים יימצאו מחוץ לאפשרויות המסוימות. מפתחות פלט קצרים יכולים לזהות קטגוריות, ואילו תיאורים מלאים יותר מגדירים את הגבולות ביניהן.
הנחיות לניתוב עשויות להבחין בין בעיית גישה, שאלה על מוצר ופגם שדווח. ציינו את משמעותה של כל אפשרות וספקו את ההודעה שצריך לנתב. הפלט הוא קטגוריה שנבחרה עם התפלגות, ולא הוראה שכבר שינתה תור או יצרה קשר עם מערכת אחרת. בחנו הסתברויות מתחרות כאשר המקרה עמום, במקום לפרש את התווית המנצחת כהוכחה לוודאות.
Score: מיקום צפוי במחוון
שאלת Score משתמשת במערך מסודר של תיאור רמה אחד עד עשרה תיאורים, החל ברמה 0. הציון שלה הוא הממוצע המשוקלל לפי הסתברויות של אינדקסי הרמות ויכול להימצא בין רמות. התשובה מכילה את המקרא, הסתברויות לכל רמה וביטחון. הגדירו את הסדר ואת הקריטריונים לכל רמה, כגון אין השפעה מיידית, בעיה עם חלופה מעשית ומשימה חסומה לחלוטין.
ציון צפוי שברי שימושי לתעדוף או לצבירה. הוא שונה מבחירת הרמה היחידה הסבירה ביותר. שמרו את המקרא עם המספר, כדי שהציון לא יפורש בסולם לא קשור. הביטחון ב־Choice וב־Score מדווח בנפרד בין 0 ל־1; המדריך הרלוונטי אינו מגדיר אותו כזהה להסתברות הגבוהה ביותר מבין האפשרויות ואינו מספק נוסחה אוניברסלית לשחזורו.
הכנת תוצאת החלטה שימושית
פריט ראיה אחד יכול לתמוך בשאלות עצמאיות של קטגוריה, דחיפות ותנאי. משימת סקירת מסמך יכולה לשאול אם נושא נדרש נוכח, לבחור את הקטגוריה שלו ולדרג את הרלוונטיות שלו ברמות מתוארות. השתמשו רק בחומר המקור הזמין במצב, עם קריטריונים הקשורים להחלטה הבאה שתהליך העבודה זקוק לה. אם פעולה מחייבת תוצאה מוקדמת יותר, הפכו את התוצאה הזאת למפורשת בראיות לשלב הבא, במקום להניח שהשאלות יוצרות רצף נסתר.
התגובה מחזירה את שם המודל ומפת answers שהמפתחות שלה הם שמות השאלות שסופקו. הסתברויות Choice משתמשות בשמות האפשרויות; הסתברויות Score משתמשות באינדקסים כמחרוזות, והמקרא מסביר את האינדקסים האלה. שמרו על הקשר בין מזהה המצב, הגדרות השאלות והתשובות בעלות הטיפוס המוגדר. כך נוצר תוצר סיווג או דירוג שניתן לפרש, במקום מספר המנותק מהעובדות שהפיקו אותו.
היקף הממשק ומגבלותיו
Inception מתעדת את Mercury Decide דרך ממשק ההחלטה הייעודי שלו. הוא אינו תומך בממשקי השלמת הצ׳אט, הסטרימינג או הקריאה לכלים של היצרן, ולכן אין להעביר למודל הזה יכולות מפרופילי ההסקה, הקול ויצירת הקוד של Mercury. מדריך ההחלטה מציין את מספרי האפשרויות והרמות, אך אינו נותן מגבלה מספרית לטוקנים במצב או תקרה למספר השאלות; מקדו את הראיות המשותפות בשאלות המוערכות.
העריכו הסתברויות וגבולות קטגוריות על חומר מסומן ומייצג מהמשימה המיועדת. בדקו תשובות גבוליות מול המצב ושמרו מידע חסר כחסר, במקום להחליפו בעובדות מומצאות. תוצאה שימושית של Mercury Decide נותנת החלטה סגורה, את ההסתברויות שלה ואת ההגדרות הדרושות להבנתה; היישום העוטף קובע כיצד התוצאה הזאת הופכת לניתוב, לתעדוף או לתוצאת סקירה.
Ailoot Ultra · System One POST /v1/systemone inception/mercury-decide
inception/mercury-decideהתחלה
Mercury Decide מעריך ראיות משותפות בטקסט או ב־JSON מול שאלות בעלות שמות ומחזיר בחירות בעלות טיפוס מוגדר, הסתברויות כן/לא או ציונים שבריים לפי מחוון. Inception מתעדת תהליך החלטה ייעודי עם עד 255 אפשרויות Choice ועשר רמות Score.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- decisions
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · System One POST /v1/systemone
- סוגי קלט
text- סוגי פלט
decisions- פורמט פלט
- json
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות inception/mercury-decide | ברירת מחדל— |
שדה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 / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים |
| תצורהרמת אורך בקשה 1 | טבלת תעריפים— | טוקנים בהקשר, יותר מ-0 | טוקנים בהקשר, עד וכוללללא גבול עליון | חיוב קלט · טוקני קלט $0.00008 / 1K טוקנים פלט · טוקני פלט $0 / 1K טוקנים קלט · קריאה מהמטמון $0 / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · System One
{
"model": "inception/mercury-decide",
"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']='inception/mercury-decide'
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 inception/mercury-decide
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · Inception: Mercury Decide
- אילו קלטים ותוצאות זמינים?
POST /v1/systemone·inception/mercury-decide:text→decisions- באילו שדות הבקשה משתמשת?
POST /v1/systemone·inception/mercury-decide:model,provider,questions,session_id,state,trace,user