Nace.AI: Drex v1.5

Drex 1.5 מעריך טקסט או JSON שסופקו מול שאלות בעלות טיפוס מוגדר ומחזיר הסתברויות, תווית שנבחרה או ציון שברי לפי מחוון. Nace.AI מתעדת החלטות מטקסט בלבד לסיווג, לניתוב ולתעדוף, עם מגבלות מצב ובקשה הייחודיות לגרסה.

Ailoot Ultra · System One POST /v1/systemone nace-ai/drex-v1.5

על המודל

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

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

הכנת המצב

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

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

הסתברות כן/לא, בחירה או ציון

שאלת noul שואלת אם תנאי מתקיים ומחזירה מספר מ־0 עד 1 המייצג את ההסתברות המשוערת לכן. הגדירו את השאלה באמצעות הוראות לא ריקות או לפחות קריטריון true/false אחד שאינו ריק. לדוגמה, שאלו אם הודעה מדווחת על תכונה תקולה והגדירו אם התנהגות איטית נחשבת לתקלה. Drex אינו קובע סף כן/לא מובנה; תהליך העבודה הצורך את התוצאה בוחר כיצד לפרש את ההסתברות.

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

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

ראיות משותפות וקריאת התוצאה

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

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

גרסה ומגבלות גודל

Drex 1.5 מתעד הקצאה של 131,072 טוקנים למצב והקצאה של 139,264 טוקנים לשורה. הקצאת השורה נוגעת למצב יחד עם השאלה היחידה הארוכה ביותר, כולל הוראותיה ואפשרויותיה; היא אינה סכום כל השאלות בבקשה. המצב והשאלות לאחר סריאליזציה חייבים יחד להיכנס גם ל־1,048,576 בתים ב־UTF-8. בקשה יכולה לעמוד במגבלת הבתים ועדיין לחרוג ממגבלת טוקנים. מהדורת 1.0 הישנה יותר מציינת בנפרד 32,768 טוקנים הן למצב והן לשורה, ולכן אין להעביר את מגבלותיה ל־1.5.

Nace מתעדת את drex-v1.5 כמזהה יצרן הכולל גרסה, ואילו drex-latest הוא כינוי משתנה. ציינו במפורש את המהדורה המיועדת כאשר תהליך עבודה תלוי במגבלותיה. שאלה בעלת מבנה שגוי, מצב חסר או קלט גדול מדי הם בעיית אימות שדורשת קלט מתוקן, ולא קטגוריה אחרת או תשובה מנוחשת. הכינו את הקריטריונים סביב ראיות שניתן לצפות בהן ושמרו יחד את התוצאה בעלת הטיפוס המוגדר, את העובדות המקוריות ואת הגדרת השאלה. כך ההחלטה נעשית שימושית לניתוב, לתעדוף או לסקירה בלי לטעות ולראות בהסתברות פסק דין מובטח.

Ailoot Ultra · System One POST /v1/systemone nace-ai/drex-v1.5

nace-ai/drex-v1.5

Nace.AI /nace-ai/drex-v1.5

התחלה

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

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

Ailoot Ultra · System One POST /v1/systemone

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

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

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

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

Ailoot Ultra · System One

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

{
  "model": "nace-ai/drex-v1.5",
  "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']='nace-ai/drex-v1.5'
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 nace-ai/drex-v1.5

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

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

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

nace-ai/drex-v1.5

FAQ · Nace.AI: Drex v1.5

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

Nace.AI: Drex v1.5

Nace.AI: Drex v1.5

הכנת המצב

הסתברות כן/לא, בחירה או ציון

ראיות משותפות וקריאת התוצאה

גרסה ומגבלות גודל

התחלה

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

תעריפים

תעריפי Ailoot

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

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

Ailoot Ultra · System One

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

Ailoot Ultra · System One

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

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

כינויים

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

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

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

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

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

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