VoyageAI by MongoDB: rerank-3

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

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

על המודל

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

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

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

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

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

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

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

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

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

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

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

מעבר בין מהדורות היצרן מתאר את rerank-3 כמחליף ישיר ל־rerank-2.5, עם אותה סמנטיקת API וציונים המכוילים להתפלגות של קודמו המקביל. התאימות הזאת תומכת בשמירת שלב האחזור ומיפוי הרשומות הקיימים. השוו סדרי תוצאות בעלי משמעות וכל סף ניקוד על הקורפוס הנוכחי לפני הסתמכות על המעבר. שמרו את rerank-3 ואת rerank-3-lite כאפשרויות נפרדות: מגבלות משותפות וביצוע הוראות אינם הופכים את עדיפויות האיכות וההשהיה שלהם לזהות.

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

voyageai/rerank-3

VoyageAI by MongoDB /voyageai/rerank-3

התחלה

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

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

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

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

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`documents`	סוג`array`	דרישהחובה	ערכים ומגבלות	ברירת מחדל—
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות voyageai/rerank-3	ברירת מחדל—
שדה`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-3",
  "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-3'
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-3

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

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

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

voyageai/rerank-3

FAQ · VoyageAI by MongoDB: rerank-3

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

VoyageAI by MongoDB: rerank-3