VoyageAI by MongoDB: rerank-2.5-lite
rerank-2.5-lite הוא מודל הדירוג מחדש של Voyage AI הממוקד בהשהיה נמוכה ועוקב אחר הוראות, עבור קבוצת מועמדי טקסט שסופקה. הוא שומר על חלון הקשר שאילתה־מסמך של 32,000 טוקנים ועל תמיכה רב־לשונית, ומחזיר רשימה מסודרת של ציוני רלוונטיות ושל אינדקסי המסמכים המקוריים.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
rerank-2.5-lite הוא החבר הקל במשפחת מודלי הדירוג מחדש 2.5 של Voyage AI. היצרן מתאר אותו כמודל כללי המאזן בין השהיה לאיכות רלוונטיות, עם ביצוע הוראות בשפה טבעית ותמיכה רב־לשונית. הקלט שלו הוא שאילתה וטקסטים מועמדים, והפלט שלו הוא סדר משופר של אותם מועמדים עם ציוני רלוונטיות.
החלטת רלוונטיות קלה בשלב השני
מודל Lite מעבד יחד כל זוג שאילתה־מסמך כמקודד צולב. הוא יכול לבוא לאחר חיפוש בשלב ראשון המבוסס על הטמעות או על חיפוש לקסיקלי, ולחדד את הקטעים שאותו שלב בחר. הדבר שונה מהכנת אינדקס הטמעות לשימוש חוזר: המודל לדירוג מחדש בוחן יחד את השאילתה ואת טקסט המסמך שנשלחו לצורך החלטת הרלוונטיות הנוכחית.
בחיפוש עזרה אינטראקטיבי, שלחו את ההסברים המועמדים שעשויים לענות לשאלת המשתמש. שמרו מספיק מכל קטע כדי להעביר את ההתנהגות ואת הסייגים שלה, ושמרו על השיוך בין אינדקס הקלט לפריט המקור. קבוצת מועמדים ממוקדת מסייעת להבהיר את משימת הדירוג מחדש תוך השארת הראיות שאוחזרו שימושיות להצגה או לתשובה מאוחרת יותר.
הוראות מבטאות מה המשתמש רוצה לתעדף
בדומה ל־rerank-2.5, Lite מקבל הוראות בשפה טבעית לפני השאילתה או אחריה. דוגמאות היצרן משתמשות בהן כדי להדגיש רכיבי מסמך, לבחור סוג מקור מועדף או להוסיף הקשר למילה דו־משמעית. יישום יכול לספק העדפת רלוונטיות קבועה, או שהשאלה הנוכחית יכולה לכלול העדפה מסוימת יותר.
שאילתת תמיכה להמחשה יכולה לשאול איזה קטע מסביר שגיאה, עם הוראה לתעדף שלבי פתרון תקלות על פני תיאורי מוצר כלליים. חיפוש מסמך יכול לבקש את נוסח המדיניות המקורי במקום דיון במדיניות. תארו את הראיות המיועדות ושמרו על הוראה תמציתית. הוראות משפיעות על ציוני רלוונטיות; הכינו מגבלות קשיחות של גרסה, תאריך או הרשאה בשלב בחירת המועמדים, במקום להתייחס להעדפת רלוונטיות כמסנן מובטח.
קראו את הדירוג והחזירו את קטע המקור
הפלט ממוין לפי רלוונטיות יורדת. כל תוצאה כוללת את אינדקס המסמך המקורי וציון נקודה צפה; ההגדרה האופציונלית return-documents מחזירה גם את טקסט הקלט המתאים. האפשרות top-k קובעת את מספר התוצאות המובילות שיוחזרו, ואילו השמטתה מחזירה את הדירוג לכל המועמדים שנשלחו.
השתמשו באינדקסים הללו לשחזור קטע המקור ומזההו. מועמד שדורג מחדש יכול להפוך לתוצאת חיפוש או לראיה לשלב RAG הבא, אך הפלט הוא סדר של טקסט שסופק ולא תשובה משוכתבת. העריכו אם הקטעים המובילים עומדים הן בשאלה והן בהוראת הרלוונטיות, לרבות בשפות ובסוגי המסמכים הנמצאים בפועל באוסף.
מגבלות ותקציב מועמדים מעשי
למהדורת 2.5 Lite יש מקסימום מתועד של 8,000 טוקנים לשאילתה ומגבלה של 32,000 טוקנים לשאילתה יחד עם כל מסמך בודד. היא נפרדת ממודל rerank-2-lite הקודם ומההקשר הקטן יותר שלו. אפשר לשלוח לכל היותר 1,000 מסמכים, והקלט הכולל מוגבל ל־600,000 טוקנים לפי הנוסחה: טוקני השאילתה כפול מספר המועמדים, ועוד סכום הטוקנים במסמכים המועמדים.
לשימוש הרגיש להשהיה, השאלות הנפוצות של היצרן ממליצות על rerank-2.5-lite עם לא יותר מ־200,000 טוקנים בסך הכול לבקשה. זו הנחיה מעשית מתחת למקסימום המוצהר, ולא חלון שונה לכל מסמך. שאילתה או הוראה ארוכה יותר נספרת פעם אחת לכל זוג מועמד, ולכן גם מספר המועמדים וגם אורך השאילתה משפיעים על הסכום.
קיטוע מופעל כברירת מחדל ומקצר קלט שאילתה/מסמך ארוך מדי כדי שיתאים; השבתתו מחזירה שגיאה בשאילתה או בזוג ארוכים מדי. הכינו בכוונה מועמדים תמציתיים הנושאים תשובה, כדי שראיות מועילות לא יישארו מעבר לגבול שנקטע. בחירת פחות תוצאות פלט באמצעות top-k אינה מסירה את יתר המועמדים שסופקו מחישוב הטוקנים. בחנו את קטעי המקור שהוחזרו וחדדו את הכנת הקלט סביב השאלות בפועל שממשק החיפוש צריך לענות עליהן.
Ailoot Ultra · דירוג מחדש POST /v1/rerank voyageai/rerank-2.5-lite
voyageai/rerank-2.5-liteהתחלה
rerank-2.5-lite הוא מודל הדירוג מחדש של Voyage AI הממוקד בהשהיה נמוכה ועוקב אחר הוראות, עבור קבוצת מועמדי טקסט שסופקה. הוא שומר על חלון הקשר שאילתה־מסמך של 32,000 טוקנים ועל תמיכה רב־לשונית, ומחזיר רשימה מסודרת של ציוני רלוונטיות ושל אינדקסי המסמכים המקוריים.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- תוצאות מדורגות
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · דירוג מחדש POST /v1/rerank
- סוגי קלט
text- סוגי פלט
rerank- פורמט פלט
- json
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהdocuments | סוגarray | דרישהחובה | ערכים ומגבלות | ברירת מחדל— |
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות voyageai/rerank-2.5-lite | ברירת מחדל— |
שדהprovider | סוגschema | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהquery | סוגstring | דרישהחובה | ערכים ומגבלות | ברירת מחדל— |
שדהsession_id | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהtop_n | סוגinteger | דרישהרשות | ערכים ומגבלות מינימום: 1 | ברירת מחדל— |
שדהtrace | סוגschema | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהuser | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהdocuments[].text | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהdocuments[].image | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שילובים של חומרי קלט
text_rerank · נדרש: query, documents array with minItems1
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, query, documents |
פרמטרmaterial_types | מפרטtext |
פרמטרoptional_controls | מפרטprovider, session_id, top_n, trace, user |
פרמטרmultimodal_input_binding | מפרטnull |
מחזור חיים: synchronous
יש לשלוח את מזהה המודל המדויק ולשמור את התגובה המלאה בפורמט המקורי.
תעריפים
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפי Ailoot
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | יחידת חיוב | חיוב |
|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | יחידת חיוב— | חיוב קלט · טוקני קלט — / 1K טוקנים פלט · טוקני פלט — / 1K טוקנים קלט · קריאה מהמטמון — / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים |
| תצורהUltra | טבלת תעריפים— | יחידת חיוב/ 1K טוקנים | חיוב קלט $0.00004 / 1K טוקנים |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · דירוג מחדש
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "voyageai/rerank-2.5-lite",
"query": "What is the capital of France?",
"top_n": 3
}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']='voyageai/rerank-2.5-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/rerank \
-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 · דירוג מחדש
json
שמירת כל התוצאות שהושלמו
שמרו כל תגובה מלאה, קובץ ומקטע תוכן שהוחזרו.
נשמרים כל אינדקס תוצאה ממשי, ערך relevance_score סופי ואובייקט מסמך מקורי. האינדקסים מקשרים למערך המסמכים המקורי. כל ה־JSON המקורי מאוחסן ומוחזר רק לאחר השלמת החיוב.
כשצריך לבדוק את התגובה המקורית
יש לשמור את הפעולה המקורית ואת התשובה המלאה או החלקית; אין לשלוח שוב את בקשת ה־POST.
שדות התגובה
| שדה | סוג |
|---|---|
שדהmodel | סוגstring |
שדהid | סוגstring |
שדהprovider | סוגstring |
שדהresults[].index | סוגinteger |
שדהresults[].relevance_score | סוגnumber |
שדהresults[].document.text | סוגstring |
שדהresults[].document.image | סוגstring |
שדהusage.search_units | סוגinteger |
שדהusage.total_tokens | סוגinteger |
שדהusage.cost | סוגnumber |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה400 · invalid_request_error | תנאישדה חובה, ייצוג או ערך לא תקפים | השלב הבאיש לתקן את שדה הבקשה שצוין. |
כינויים
כינויים למודל
Ailoot Ultra voyageai/rerank-2.5-lite
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · VoyageAI by MongoDB: rerank-2.5-lite
- אילו קלטים ותוצאות זמינים?
POST /v1/rerank·voyageai/rerank-2.5-lite:text→rerank- באילו שדות הבקשה משתמשת?
POST /v1/rerank·voyageai/rerank-2.5-lite:documents,model,provider,query,session_id,top_n,trace,user- אילו מגבלות חלות?
POST /v1/rerank·voyageai/rerank-2.5-lite:top_n.minimum:1