VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite נותן ציונים למסמכי טקסט מועמדים ומסדר אותם מחדש עבור שאילתה, בדגש על חיפוש מגיב ומהיר. הוא תומך בהוראות רלוונטיות ובחלון שאילתה־מסמך של 32,000 טוקנים, ולכן מועיל לאחר אחזור וקטורי או לפי מילות מפתח בתהליכי חיפוש ו־RAG.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Voyage rerank-3-lite הוא המהדורה הממוקדת בהשהיה נמוכה בסדרת Rerank 3 של Voyage. הוא מקבל שאילתת טקסט ומסמכים מועמדים, מעריך כל זוג שאילתה־מסמך יחד ומחזיר ציוני רלוונטיות בסדר מדורג. הוא משרת את השלב השני של החיפוש: מאחזר המבוסס על הטמעות או על מילות מפתח מוצא את המועמדים, ואז Lite מחדד את סדרם. התוצאה היא דירוג לשימוש בחיפוש או בתהליך יצירה מועשר באחזור.
מה משתנה ב־Rerank 3 Lite היצרן מדגיש אחזור חזק יותר במסמכים ארוכים ובקוד בהשוואה ל־rerank-2.5-lite. שתי מהדורות Rerank 3 שומרות על היכולת לבצע הוראות ועל אותה קטגוריית הקשר של 32K, ואילו Lite מיועד ליישומים הרגישים להשהיה. כך הוא מועמד מעשי לחיפוש אינטראקטיבי במאגר ידע, לאחזור מסמכי תמיכה ולחיפוש קוד כאשר משתמשים זקוקים לתוצאות רלוונטיות במהירות. בחרו בו לפי דרישות האיכות וזמן התגובה של האוסף בפועל, במקום להניח שמהדורה קטנה יותר פירושה חלון הקשר קטן יותר.
הנחו את הרלוונטיות באמצעות השאילתה הוראות בשפה טבעית יכולות להתלוות לשאילתה כדי להסביר מה נחשב רלוונטי. שמרו על שאלה ועל העדפת רלוונטיות תמציתיות ועקביות. בחיפוש תמיכה בתוכנה, השתמשו ב״מצאו את ההליך לאיפוס התקן; תנו עדיפות להוראות לגרסת החומרה שצוינה.״ בשם מוצר דו־משמעי, כללו את קטגוריית המוצר כדי שמשמעויות שאינן קשורות לא ישתלטו על התוצאות. העדפה בשאילתה מנחה את הניקוד הסמנטי; השתמשו במטא־נתונים מפורשים של האוסף כדי לבחור את המוצר, את גרסת המסמך או את היקף הגישה הנכונים לפני בניית רשימת המועמדים.
הכינו רשימה מצומצמת של מועמדי טקסט מסמכי הקלט הם מחרוזות. חלצו טקסט קריא מחומר המקור ושמרו כותרות, כותרות סעיפים, מזהים והקשר מסביב שיש בהם תועלת. שמרו מיפוי יציב מכל מיקום בקלט לרשומה המקורית. במאמר לפתרון תקלות, כללו את התסמין ואת ההליך הרלוונטי, ולא רק משפט מנותק. בחיפוש קוד מקור, כללו את הפונקציה ואת המידע הסמוך הדרוש להבחנה בינה לבין פונקציות בעלות שמות דומים. הסירו ניווט חוזר או טקסט תבניתי כאשר הם דוחקים את הקטע המועיל.
המודל לדירוג מחדש יכול לשנות רק את סדר המסמכים שהוא מקבל. אם החיפוש הראשון כלל אינו מאחזר את המאמר הרלוונטי, שלב זה אינו יכול לשחזר את המועמד החסר. בחנו גם את הרשימה המצומצמת וגם את הסדר הסופי כאשר תוצאה נראית שגויה. כאשר מסמך ארוך מכסה נושאים רבים, הפרידו סעיפים שלמים מבחינת תוכנם ושמרו את ההפניות למסמך האב, כדי שניתן יהיה לבחור סעיף רלוונטי בלי לאבד את מקורו.
מגבלות הקשר ובקשה המדריך הנוכחי של היצרן מציין מקסימום של 8,000 טוקנים לשאילתה ומקסימום משולב של 32,000 טוקנים לשאילתה יחד עם כל מסמך בודד. הוא מאפשר עד 1,000 מסמכים מועמדים ותקציב בקשה כולל של 600,000 טוקנים, המחושב כמספר טוקני השאילתה כפול מספר המסמכים, ועוד כל טוקני המסמכים. לכן שאילתה ארוכה צורכת מקום בכל זוג ותורמת שוב ושוב לתקציב המצטבר. ספרו את הטקסט שנשלח באמצעות הטוקנייזר של המודל המתאים, במקום להתייחס לתווים, למילים ולטוקנים כיחידות הניתנות להחלפה.
למשל, שאילתה של 500 טוקנים עם 100 מסמכים בני 4,000 טוקנים כל אחד מסתכמת ב־450,000 טוקני קלט לפי נוסחה זו. הדבר ממחיש תכנון תקציב, ולא גודל מומלץ לרשימה מצומצמת או תוצאת מהירות שנמדדה. אפשרות הקיטוע המתועדת מופעלת כברירת מחדל; אפשר לקצר טקסט גדול מדי לפני הניקוד. הכינו בכוונה את הסעיפים החשובים כדי שהקיטוע לא יסיר דווקא את הקטע שצריך להתאים.
קראו את התוצאה והשתמשו בה התוצאות ממוינות מציון הרלוונטיות הגבוה ביותר ומטה. כל תוצאה מזהה את מיקומו המקורי של המסמך בקלט, ומאפשרת ליישום לצרף כותרת, מזהה רשומה ומקור משלו. ההגדרה top_k שולטת בכמה מועמדים מדורגים יוחזרו; בלעדיה מוחזרים כל המועמדים. ממשק REST של היצרן יכול להחזיר גם את טקסט המסמך. שמרו את המזהים המקוריים לצד התוצאות שנבחרו בעת הצגת עמוד חיפוש או העברת ראיות לשלב יצירת תשובה.
ציון רלוונטיות מבטא עד כמה מועמד מתאים לשאילתה; הוא אינו מבסס את נכונות הטענות של המועמד. השוו את הפריטים המדורגים בראש לשאלה האמיתית של המשתמש, לרבות החרגות והבדלים בין גרסאות מסמכים. אם כל המועמדים אינם רלוונטיים, עדיין קיים פריט המדורג ראשון. החליטו כיצד היישום שלכם מטפל במקרה הזה באמצעות שאילתות מייצגות מהאוסף.
שדרוג ובחירת המהדורה היצרן מתאר את rerank-3-lite כשדרוג ל־rerank-2.5-lite עם סמנטיקת API ללא שינוי וציונים המכוילים להתפלגות של קודמו המקביל. שמרו את מיפוי הרשומות ואת שלב האחזור הקיימים, ואז השוו את הסדר המתקבל בשאילתות בעלות משמעות לפני הסתמכות על סף ניקוד קיים. השתמשו ב־Lite לחוויית חיפוש שבה זמן התגובה חשוב; השתמשו במהדורת rerank-3 הממוקדת באיכות להשוואה כאשר רלוונטיות במועמדים קשים היא העדיפות הגבוהה יותר.
Ailoot Ultra · דירוג מחדש POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteהתחלה
Voyage rerank-3-lite נותן ציונים למסמכי טקסט מועמדים ומסדר אותם מחדש עבור שאילתה, בדגש על חיפוש מגיב ומהיר. הוא תומך בהוראות רלוונטיות ובחלון שאילתה־מסמך של 32,000 טוקנים, ולכן מועיל לאחר אחזור וקטורי או לפי מילות מפתח בתהליכי חיפוש ו־RAG.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- תוצאות מדורגות
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · דירוג מחדש POST /v1/rerank
- סוגי קלט
text- סוגי פלט
rerank- פורמט פלט
- json
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהdocuments | סוגarray | דרישהחובה | ערכים ומגבלות | ברירת מחדל— |
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות voyageai/rerank-3-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-3-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-3-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-3-lite
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · VoyageAI by MongoDB: rerank-3-lite
- אילו קלטים ותוצאות זמינים?
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- באילו שדות הבקשה משתמשת?
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- אילו מגבלות חלות?
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1