VoyageAI by MongoDB: rerank-2.5

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

Ailoot Ultra · דירוג מחדש POST /v1/rerank voyageai/rerank-2.5

על המודל

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

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

תנו למודל את המועמדים להשוואה

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

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

הגדירו את מושג הרלוונטיות הרצוי

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

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

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

פלט מדורג ושימוש מאוחר יותר בתוצאה

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

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

הקשר, תקציב טוקנים כולל וקיטוע

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

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

Ailoot Ultra · דירוג מחדש POST /v1/rerank voyageai/rerank-2.5

voyageai/rerank-2.5

VoyageAI by MongoDB /voyageai/rerank-2.5

התחלה

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

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

Ailoot Ultra · דירוג מחדש POST /v1/rerank

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

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`documents`	סוג`array`	דרישהחובה	ערכים ומגבלות	ברירת מחדל—
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות voyageai/rerank-2.5	ברירת מחדל—
שדה`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.0001 / 1K טוקנים

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

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

Ailoot Ultra · דירוג מחדש

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

{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "voyageai/rerank-2.5",
  "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'
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

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

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

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

voyageai/rerank-2.5

FAQ · VoyageAI by MongoDB: rerank-2.5

אילו קלטים ותוצאות זמינים?: POST /v1/rerank · voyageai/rerank-2.5: text → rerank
באילו שדות הבקשה משתמשת?: POST /v1/rerank · voyageai/rerank-2.5: documents, model, provider, query, session_id, top_n, trace, user
אילו מגבלות חלות?: POST /v1/rerank · voyageai/rerank-2.5: top_n.minimum: 1

VoyageAI by MongoDB: rerank-2.5