Respan: Span-01

Span-01 הוא מסווג ההתנהגות הטקסטואלית של Respan לשיחות ולעקבות הרצה של סוכנים. הגדירו את ההתנהגויות בשפה פשוטה, והוא יחזיר שלוש הסתברויות לכל אחת: נוכחת, נעדרת ולא ניתנת לצפייה, תוך שימור אי־ודאות כאשר העקבה שסופקה אינה יכולה להכריע בשאלה.

Ailoot Ultra · System One POST /v1/systemone respan/span-01

על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

Span-01 הוא מודל של Respan למתן ציונים להתנהגות בשיחות ובעקבות הרצה של סוכנים. הוא קורא אינטראקציה טקסטואלית יחד עם הגדרות התנהגות הכתובות בשפה פשוטה ומחזיר הסתברויות לכל הגדרה. הפלט מבחין בין התנהגות נוכחת, נעדרת או לא ניתנת לצפייה בעקבות ההרצה שסופקו. כך תהליך הערכה מקבל אות מספרי עם דרך מפורשת לייצג ראיות חסרות, במקום הסבר שנוצר וצריך לפענח.

הגדירו את ההתנהגות שברצונכם לצפות בה

ההתנהגויות מסופקות בידי הגורם הקורא למודל. הזרקת פרומפט, טענות ללא ביסוס, חשיפת סודות, לולאות חוזרות, שימוש שגוי בכלים ותסכול משתמש הן הגדרות אפשריות, ולא טקסונומיה קבועה המובנית במודל. ציינו מה נחשב להתנהגות ומה לא. הגדרה צרה יכולה להבחין בין משתמש המבקש העברה לאדם לבין הבעת אכזבה בלבד. הגדרה אחרת יכולה להבחין בין עוזר שמכיר בקיומה של בעיה לבין הבטחה לבצע פעולה שאינו יכול לבצע.

השתמשו במזהים קבועים עם ההגדרות כדי שהתוצאות יישארו קשורות להתנהגות המוערכת. מקדו את הקריטריון בדבר שעקבת ההרצה יכולה להראות. אם ההתנהגות מחייבת מסמך מקור, תוצאת כלי או תגובת לקוח מאוחרת יותר, כללו את הראיה הזאת במקום המתאים באינטראקציה הטקסטואלית. הגדרה לבדה אינה יכולה לקבוע עובדה שנעדרת מהעקבה.

הכינו את ההקשר הקודם ואת תור היעד

הקלט המתועד מפריד בין הודעות קודמות ב־span.input לבין תור היעד ב־span.output. תוכן כל הודעה הוא מחרוזת. ספקו את הקשר השיחה בפועל ואת התור שברצונכם להעריך, תוך שמירה על תפקידי הדוברים ועל הסדר הדרוש לפירושו. זהו פרופיל להערכת טקסט; טקסט מוכן של מסמך או תמליל יכולים לשמש ראיה, ואילו המדיה שממנה הושג הטקסט אינה בעצמה הקלט המתועד.

באינטראקציית תמיכה, שמרו את בקשת הלקוח עם התשובה המוצעת של העוזר. בסוכן המשתמש בכלים, שמרו את התצפית הרלוונטית מהכלי ואת התשובה שהסתמכה עליה. הגדרה לדוגמה לבדיקת ביסוס יכולה לשאול אם העוזר טוען למסקנה שהתצפית שסופקה אינה תומכת בה. התוצאה השימושית נוגעת להתנהגות שהוגדרה באותו קטע, ולא לאבחון מלא של היישום כולו.

קראו שלוש הסתברויות לכל הגדרה

כל תוצאה כוללת את מזהה ההתנהגות ואת p_present,‏ p_absent ו־p_not_observable. שלוש ההסתברויות מסתכמות בקירוב ב־1. ״נוכחת״ מעריכה שההתנהגות התרחשה; ״נעדרת״ מעריכה שלא התרחשה; ״לא ניתנת לצפייה״ מעריכה שבקטע שסופק חסרות הראיות הדרושות להכרעה. אלה משמעויות נפרדות, ועליהן להישאר נפרדות בעת פירוש התוצאות.

לדוגמה, קטע שמסתיים באמירה של העוזר שיפתור בעיה עשוי להראות הבטחה. הוא עדיין אינו יכול להראות שהלקוח קיבל את הפתרון שיינתן בהמשך אם אין תגובת לקוח. התייחסו לתוצאת הראיות החסרות הזאת כלא ידועה, במקום להפוך אותה להיעדר. הסתברות נמוכה לנוכחות אינה אוטומטית ראיה חזקה להיעדר כאשר חלק משמעותי מההתפלגות אינו ניתן לצפייה.

הערכת הגדרות התנהגות במעבר אחד

Respan מתארת את Span-01 כמסווג הסקה שאומן תחילה לסיווג כללי באמצעות RLAIF ולאחר מכן התמחה בזיהוי התנהגות. כל הגדרה פועלת כענף מקביל על אותה עקבת הרצה, והמודל מחזיר את הסתברויות ההתנהגות במעבר קדימה יחיד. קשב היברידי תומך בטיפול שלו בעקבות ארוכות ומורכבות. הוא אינו מייצר טוקנים, כותב שיפוט סיפורי או מפיק הסבר חופשי לסיווג שלו.

מדריך המושגים ומסמך הייחוס להערכה אינם מתעדים מגבלה על מספר ההתנהגויות בבקשה. כל הגדרה עדיין שייכת להערכה שסופקה, ולכן שמרו על כל אחת ברורה ורלוונטית, במקום לראות בהיעדר מגבלת מספר ראיה לקיבולת קלט בלתי מוגבלת. התוצאה מכילה רשומה אחת לכל התנהגות לפי סדר הבקשה, המזוהה באמצעות ה־id שלה. הגדרות מרובות מתארות תצפיות עצמאיות מרובות; הן אינן בחירות בקטגוריות הסותרות זו את זו וחייבות להסתכם באחת על פני התנהגויות.

הכנת תוצר הערכה שימושי

שלבו את ההסתברויות שהוחזרו עם ספים ייעודיים למשימה ועם כללי סקירה מחוץ למודל. היצרן ממליץ להשתמש בשיחות מסומנות לבחירת הספים האלה ולבדוק תוצאות נוכחות גבוליות או תוצאות גבוהות של אי־אפשרות לצפות. תהליך תמיכה יכול לרשום תסכול, הסלמה מוצעת והבטחה ללא ביסוס בנפרד. תהליך לבדיקת איכות סוכן יכול לעקוב אחר פעולות חוזרות או אחר השאלה אם תשובה השתמשה בראיות שעמדו לרשותה.

שמרו יחד את קטע הטקסט, הגדרת ההתנהגות, מזהה התוצאה וההתפלגות התלת־כיוונית המלאה. כאשר ההגדרה משתנה, הכירו בכך שהיא משנה את מה שההסתברות מודדת. בדקו טעויות לכאורה מול השיחה בפועל, במקום לראות בתוצאה מספרית הוכחה לאירוע שלא נצפה. תוצר שימושי הוא רשומת התנהגות הקשורה לעקבת ההרצה ולקריטריון, עם אי־ודאות שנשמרה לבדיקה מאוחרת או להחלטה הבאה של היישום.

Ailoot Ultra · System One POST /v1/systemone respan/span-01

respan/span-01

Respan /respan/span-01

התחלה

סוגי קלט נתמכים: טקסט
תוצאות: decisions

זמין ב-Ailoot · קלט ושיטות

Ailoot Ultra · System One POST /v1/systemone

סוגי קלט: text
סוגי פלט: decisions
פורמט פלט: json

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות respan/span-01	ברירת מחדל—
שדה`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.00004 / 1K טוקנים פלט · טוקני פלט $0 / 1K טוקנים קלט · קריאה מהמטמון — / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים
תצורהרמת אורך בקשה 1	טבלת תעריפים—	טוקנים בהקשר, יותר מ-⁦0⁩	טוקנים בהקשר, עד וכוללללא גבול עליון	חיוב קלט · טוקני קלט $0.00004 / 1K טוקנים פלט · טוקני פלט $0 / 1K טוקנים קלט · קריאה מהמטמון — / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים

לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →

דוגמאות לבקשות

Ailoot Ultra · System One

מבנה הבקשה הרשמי נשמר; דוגמה תיעודיתהשתמשו בחומרי הבקשה האמיתיים שלכם ושמרו את התוצאה המלאה

{
  "model": "respan/span-01",
  "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'
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

כינויים לנתיבי שיטות

השתמשו בנתיבי השיטות המוצגים למעלה.

מזהי מודלים קשורים IDs

respan/span-01

FAQ · Respan: Span-01

אילו קלטים ותוצאות זמינים?: POST /v1/systemone · respan/span-01: text → decisions
באילו שדות הבקשה משתמשת?: POST /v1/systemone · respan/span-01: model, provider, questions, session_id, state, trace, user

Respan: Span-01

Respan: Span-01

הגדירו את ההתנהגות שברצונכם לצפות בה

הכינו את ההקשר הקודם ואת תור היעד

קראו שלוש הסתברויות לכל הגדרה

הערכת הגדרות התנהגות במעבר אחד

הכנת תוצר הערכה שימושי

התחלה

זמין ב-Ailoot · קלט ושיטות

תעריפים

תעריפי Ailoot

מחירים לפי תצורה

דוגמאות לבקשות

Ailoot Ultra · System One

קבלה ושמירה של תוצאות

Ailoot Ultra · System One

שמירת כל התוצאות שהושלמו

כשצריך לבדוק את התגובה המקורית

כינויים

כינויים למודל

כינויים לנתיבי שיטות

מזהי מודלים קשורים IDs

החברה ופורטפוליו הפרויקטים שלה

קנו אסימונים בהנחה.

חברו API למוצר שאתם מוכרים.