Respan: Span-01 Lite
Span-01 Lite הוא פרופיל של Respan בעל שם נפרד למתן ציונים להתנהגות בשיחות טקסט ובעקבות הרצה של סוכנים. הוא משתמש בהתנהגויות שמי שמבצע את הקריאה מגדיר ומחזיר לכל אחת הסתברויות לנוכחות, להיעדר ולאי־אפשרות לצפות בה, באותו תהליך הערכה מתועד של Span-01.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Span-01 Lite הוא פרופיל מודל בעל שם נפרד במשפחת Span-01 של Respan למתן ציונים להתנהגות. מדריך ההתחלה המהירה וטבלת המודלים של היצרן מזהים את Lite כאחד משני פרופילים המשתמשים באותו תהליך הערכה. הוא מקבל אינטראקציה טקסטואלית והגדרות התנהגות בשפה פשוטה, ואז מחזיר שלוש הסתברויות לכל הגדרה: נוכחת, נעדרת ולא ניתנת לצפייה. הפלט השימושי של הפרופיל הוא רשומת התנהגות עם אי־ודאות מפורשת, ולא תשובה כתובה לשיחה.
בחרו את התצפית ואת גבולותיה
הגדירו את ההתנהגות במילים שמתאימות למשימה שלכם. בבדיקת העברה לנציג, ציינו אם הכוונה היא שהמשתמש מבקש במפורש אדם, שהעוזר אומר שנדרשת העברה או שמתקיים אחד משני התנאים. אם אכזבה בלבד לא אמורה להיחשב, אמרו זאת. בבדיקת התנצלות, הגדירו איזה ניסוח מהווה התנצלות במקום להסתמך על תווית לא ברורה. לכל הגדרה יש מזהה שהמעריך מחזיר עם ההסתברויות שלה.
קבוצת ההתנהגויות שייכת למי שמבצע את הקריאה. דוגמאות כגון תסכול, הבטחות ללא ביסוס, שימוש שגוי בכלים או פעולות חוזרות של סוכן הן הגדרות שיש לספק, ולא רשימה קבועה של קטגוריות מובנות. ודאו שאפשר לצפות בכל הגדרה באינטראקציה שסופקה. קטע קצר עשוי להכריע אם העוזר התנצל, אך לא לכלול ראיות לכך שבעיה חיצונית אכן נפתרה.
הכינו את קטע השיחה
הקלט המתועד של Respan מציב הודעות קודמות ב־span.input ואת התור המוערך ב־span.output. תוכן ההודעה הוא מחרוזת. שמרו את ההקשר הדרוש להבנת התור, כולל תפקידי הדוברים, בקשת המשתמש הרלוונטית וכל ראיה טקסטואלית שהעוזר השתמש בה. לבדיקת איכות, ספקו את התור המקורי ולא ניסוח מחדש שמסיר את ההתנהגות הנבחנת.
סקירה לדוגמה יכולה להשתמש בהודעת משתמש המתארת קושי חוזר ובתשובת עוזר המציע לחקור. הגדירו תסכול משתמש והבטחה של העוזר כתצפיות נפרדות. אם תוצאת כלי חשובה לקביעה אם טענה הייתה מבוססת, שמרו בהקשר את הטקסט הרלוונטי מאותה תוצאה. הפלט הוא הערכה של ההגדרות האלה בקטע שסופק; המודל אינו מבצע את החקירה שהובטחה ואינו משנה את השיחה עצמה.
נוכחת, נעדרת ולא ניתנת לצפייה
תגובת ההערכה כוללת את מזהה ההתנהגות עם p_present, p_absent ו־p_not_observable, שסכומם בקירוב 1. ״לא ניתנת לצפייה״ פירושו שעקבת ההרצה אינה יכולה לענות על השאלה. מצב זה נבדל מהיעדר. בהגדרה כגון קבלת פתרון בידי הלקוח, קטע שמסתיים לפני תגובת הלקוח הוא ראיה לא שלמה, גם אם תשובת העוזר נשמעת בטוחה.
שמרו את כל שלושת הערכים בעת הכנת תוצאה לסקירה. קטגוריה שנבחרה לפי הערך הגבוה ביותר יכולה להועיל בתצוגה, אבל ההתפלגות משמרת עד כמה התצפית הייתה לא ודאית. אל תשתמשו בערך נוכחות נמוך בלבד כדי להסיק שההתנהגות בוודאות לא התרחשה. כאשר היעדר ראיות הוא הגורם הדומיננטי, פעולה מועילה יכולה להיות השגת ההקשר הרלוונטי או שמירת התוצאה כלא ידועה במקום להמציא הסבר.
כמה הגדרות על אותן ראיות
תהליך ההערכה של היצרן בוחן יחד כמה הגדרות התנהגות על עקבת הרצה אחת ומחזיר תוצאה לכל מזהה לפי סדר הבקשה. התיעוד שלו אינו מציין מגבלה על מספר ההתנהגויות בבקשה. הדבר אינו קובע חלון טוקנים אוניברסלי או גודל עקבה בלתי מוגבל. שמרו על הגדרות תכליתיות ועל ראיות רלוונטיות, ושמרו על השיוך בין כל תוצאה שהוחזרה להגדרה שהפיקה אותה.
תוצאות ההתנהגות הן תצפיות עצמאיות ולא תשובה יחידה של בחירה בלעדית. תסכול, התנצלות והעברה מוצעת יכולים להיות נוכחים באותו חילוף דברים. להתפלגויות התלת־כיווניות האישיות שלהם יש משמעות בתוך כל הגדרה; חיבור ערכי נוכחות על פני התנהגויות שונות אינו יוצר התפלגות קטגוריות מנורמלת או ציון במחוון מסודר.
שמרו את הפרופיל שנבחר עם תוצאותיו
היצרן מתעד את השמות Lite והרגיל עם צורה משותפת של בקשה ותוצאה. החוזה הזה תומך בהכנת עקבות הרצה ובפירוש הסתברויות התנהגות עבור כל אחד מהפרופילים הנקובים. הוא אינו קובע של־Lite יש אותן משקולות, מספר פרמטרים או איכות כמו למהדורה האחרת. שמרו על זיהוי הפרופיל שנבחר בעת סקירת תוצאותיו, במקום להחליף בשקט תוצאות ממהדורות שונות.
השתמשו בשיחות מסומנות מהמשימה המיועדת כדי לבחור ספים לרישום, לניתוב או לסקירה. שמרו תוצאות גבוהות של אי־אפשרות לצפות ותצפיות גבוליות לבדיקה, והשוו כל טעות לכאורה לתור המקורי ולהגדרת ההתנהגות. התוצר הסופי השימושי מכיל את מזהה קטע הטקסט, ההגדרה, הפרופיל שנבחר ואת תוצאת ההסתברות התלת־כיוונית המלאה. שלב מאוחר יותר ביישום מחליט מה לעשות בתצפית הזאת; פלט ההערכה של Lite אינו מבצע העברה, חוסם תשובה או יוצר תיקון בעצמו.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-liteהתחלה
Span-01 Lite הוא פרופיל של Respan בעל שם נפרד למתן ציונים להתנהגות בשיחות טקסט ובעקבות הרצה של סוכנים. הוא משתמש בהתנהגויות שמי שמבצע את הקריאה מגדיר ומחזיר לכל אחת הסתברויות לנוכחות, להיעדר ולאי־אפשרות לצפות בה, באותו תהליך הערכה מתועד של Span-01.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- decisions
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · System One POST /v1/systemone
- סוגי קלט
text- סוגי פלט
decisions- פורמט פלט
- json
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות respan/span-01-lite | ברירת מחדל— |
שדה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 / 1K טוקנים פלט · טוקני פלט $0 / 1K טוקנים קלט · קריאה מהמטמון — / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים |
| תצורהרמת אורך בקשה 1 | טבלת תעריפים— | טוקנים בהקשר, יותר מ-0 | טוקנים בהקשר, עד וכוללללא גבול עליון | חיוב קלט · טוקני קלט $0 / 1K טוקנים פלט · טוקני פלט $0 / 1K טוקנים קלט · קריאה מהמטמון — / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · System One
{
"model": "respan/span-01-lite",
"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']='respan/span-01-lite'
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 respan/span-01-lite
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · Respan: Span-01 Lite
- אילו קלטים ותוצאות זמינים?
POST /v1/systemone·respan/span-01-lite:text→decisions- באילו שדות הבקשה משתמשת?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user