bge-reranker-v2-m3
מקודד צולב רב־לשוני של BAAI לדירוג קטעים מועמדים ביחס לשאילתה. הוא קורא יחד כל זוג שאילתה–קטע ומחזיר ציון רלוונטיות, וכך משפר רשימת תוצאות מצומצמת בלי לייצר תשובה או ליצור ייצוגים וקטוריים למסמכים.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
BGE Reranker v2 M3 הוא מודל רלוונטיות רב־לשוני המבוסס על BGE-M3. הוא מקבל יחד שאילתה וקטע מועמד ומחזיר ציון לקשר ביניהם. BAAI מייעדת מהדורה זו לדירוג מחדש רב־לשוני יעיל, לרבות אחזור בסינית ובאנגלית, כאשר יישום חיפוש צריך לשפר רשימת מועמדים קיימת.
רלוונטיות מתוך זוג שאילתה–קטע
מקודד צולב מעבד את שני הטקסטים במשותף, כך שתוכנם יכול להשפיע זה על זה לפני הפקת ציון הרלוונטיות. בכך הוא שונה ממודל ייצוגים וקטוריים, המקודד טקסטים בנפרד לצורך השוואת וקטורים שניתן לחזור ולהשתמש בהם. פלט המדרג מחדש הוא ציון סקלרי לזוג מסוים, ולא וקטור מסמך או תשובה כתובה.
השתמשו במודל לאחר שחיפוש ראשוני בחר קטעים סבירים. חברו את השאלה לכל מועמד וסדרו את המועמדים לפי הציונים שהתקבלו. כך ההשוואה המפורטת יותר מתמקדת ברשימה מצומצמת שניתן לנהל, במקום לבקש ממקודד צולב לבדוק כל קטע באוסף גדול.
מהדורת v2 M3
היצרן מציין את BGE-M3 כמודל הבסיס ומונה תמיכה רב־לשונית כתכונה עיקרית. במשפחת המדרגים מחדש v2, M3 הוא האפשרות הרב־לשונית היעילה; הגרסאות המבוססות על Gemma ואלה בעלות בחירת שכבות הן מודלים נפרדים עם בחירות מימוש שונות. השם M3 כאן אינו אומר שהמדרג מחדש מחזיר את הייצוגים הצפופים, הדלילים ורבי־הווקטורים של מודל הייצוגים המקורי.
ההבחנה חשובה בבחירת התוצאה שהיישום צריך. בחרו מודל ייצוגים וקטוריים כדי לייצג אוסף מסמכים ולחפש בו. בחרו במדרג מחדש הזה כאשר כבר יש טקסט מועמד וצריך לקבוע איזה קטע הוא הרלוונטי ביותר לשאילתה הנוכחית.
הכנת מועמדים לדירוג מועיל
ספקו את השאלה בפועל ואת מלוא הטקסט המועמד הדרוש לפרשנותה. שמרו כותרות או הגדרות סמוכות כאשר הן קובעות את משמעות הקטע. בדוגמת Transformers שפורסמה, השאילתה והקטע עוברים טוקניזציה יחד עם קיטום ו־max_length=512. זו הגדרת דוגמה, ולא מגבלה כללית של המודל. שמרו את השאלה ואת הראיות הנדרשות במסגרת תקציב הזוג שנבחר, ובדקו מה הקיטום מסיר. תוצאה המזכירה את אותו מוצר כמו השאילתה עדיין יכולה להיות בלתי רלוונטית אם היא עוסקת בפעולה או בתנאי הלא נכונים; בהערכת איכות האחזור, הכינו דוגמאות המבחינות בין המקרים האלה.
בעוזר מסמכים, שמרו מזהי מועמדים לצד הטקסט שלהם, חשבו ציונים לזוגות שאלה–קטע והעבירו את הקטעים המקוריים שנבחרו לשלב יצירת התשובה. כך מודל התשובה מקבל את הראיות ולא ציון רלוונטיות ללא מקורו. זהו תהליך אחזור לדוגמה; המדרג מחדש עצמו אינו מחפש באוסף חיצוני ואינו כותב את התשובה.
קריאת ציונים ונרמולם
היצרן מחזיר ציוני רלוונטיות גולמיים, כאשר ערך גבוה יותר מציין התאמה קרובה יותר. הנרמול האופציונלי המתועד שלו מפעיל פונקציית סיגמואיד כדי להציב את הציון בין 0 ל־1. לציון מנורמל יש טווח נוח, אך ההמרה הזאת כשלעצמה אינה מבססת הסתברות מכוילת לכך שהמועמד נכון.
בחרו ספי דירוג או סינון באמצעות זוגות שאילתה–קטע המייצגים את עומס העבודה שלכם. כללו קטעים המשתמשים באותן מילות מפתח אך עונים על שאלה אחרת, וכן קטעים רלוונטיים בניסוח שונה. כך הסף שנבחר מקבל משמעות לאוסף שבו מחפשים.
בפרויקט Ailoot API, הגדירו מה צריך להיכלל בהקשר הסופי וכמה מועמדים אפשר לבדוק ביעילות. התוצאה השימושית היא קבוצת ראיות המסודרת טוב יותר לשלב הבא ביישום. הפרידו בין פלט הרלוונטיות של מהדורה זו לבין ייצוגי מסמכים, טקסט שנוצר ופקדי בחירת שכבות המתועדים למדרגים מחדש אחרים.
Ailoot Ultra · דירוג מחדש POST /v1/rerank bge-reranker-v2-m3
bge-reranker-v2-m3התחלה
מקודד צולב רב־לשוני של BAAI לדירוג קטעים מועמדים ביחס לשאילתה. הוא קורא יחד כל זוג שאילתה–קטע ומחזיר ציון רלוונטיות, וכך משפר רשימת תוצאות מצומצמת בלי לייצר תשובה או ליצור ייצוגים וקטוריים למסמכים.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- תוצאות מדורגות
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · דירוג מחדש POST /v1/rerank
- סוגי קלט
text- סוגי פלט
rerank
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות bge-reranker-v2-m3 | ברירת מחדל— |
שדהquery | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהdocuments | סוגarray | דרישהחובה | ערכים ומגבלות | ברירת מחדל— |
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, documents |
פרמטרmaterial_types | מפרטtext |
פרמטרmaterial_conditions | מפרטהגדירו את השאילתה הממשית שלכם ומערך לא ריק של מסמכי הטקסט המקוריים. האינדקסים בתוצאות מפנים למערך המקורי הזה. |
מחזור חיים: synchronous_result_then_owned_library
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
תעריפים
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפי Ailoot
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | יחידת חיוב | חיוב |
|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | יחידת חיוב— | חיוב קלט · טוקני קלט — / 1K טוקנים פלט · טוקני פלט — / 1K טוקנים קלט · קריאה מהמטמון — / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים |
| תצורהסך הטוקנים | טבלת תעריפים— | יחידת חיוב/ 1K טוקנים | חיוב קלט · סך הטוקנים $0.00004 / 1K טוקנים |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · דירוג מחדש
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_QUERY:?Set the actual documented input value}"
export AILOOT_QUERY
: "${AILOOT_DOCUMENTS_JSON:?Set the actual documented input value}"
export AILOOT_DOCUMENTS_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'bge-reranker-v2-m3', 'query': '${ACTUAL_QUERY}', 'documents': '${ACTUAL_DOCUMENTS}'}
request['query']=os.environ['AILOOT_QUERY']
request['documents']=json.loads(os.environ['AILOOT_DOCUMENTS_JSON'])
Path('request.json').write_text(json.dumps(request,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 response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
קבלה ושמירה של תוצאות
Ailoot Ultra · דירוג מחדש
תוצאת JSON מקורית מלאה בפורמט הממשק המקורי, עם מודל התגובה שהוגדר, אינדקסי המסמכים המקוריים, ציוני הרלוונטיות, מחרוזות המסמכים ונתוני השימוש בטוקנים בממשק המקורי. יש לשמור כל שדה תוצאה ושימוש ממשיים.
GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
שמירת כל התוצאות שהושלמו
שמרו כל תגובה מלאה, קובץ ומקטע תוכן שהוחזרו.
שמרו את התשובה המלאה ואת הכותרות, כל פלט שהתקבל בפועל, את המזהים המקוריים שהוחזרו ואת כל שדות השימוש. שחזרו את הפעולה המקורית בלי לשלוח שוב בקשת יצירה.
כשצריך לבדוק את התגובה המקורית
יש לשמור את X-Client-Request-ID הממשי ואת התגובה המלאה. יש לקרוא את הנכסים המקוריים שבבעלותכם ואת כתובות התוכן החתומות המדויקות שלהם; אין לשלוח שוב בקשת יצירה שתוצאתה אינה ודאית.
שדות התגובה
| שדה | סוג | משמעות |
|---|---|---|
שדהmodel | סוגstring | משמעותמודל התגובה המדויק הנדרש לרכיב צריכת התגובה המוגדר בקוד המקור. |
שדהresults[].index | סוגinteger | משמעותהאינדקס הייחודי של מסמך הקלט המקורי. |
שדהresults[].relevance_score | סוגnumber | משמעותציון רלוונטיות בעל ערך מספרי סופי. |
שדהresults[].document | סוגstring | משמעותמסמך הטקסט המקורי הנדרש לרכיב צריכת התגובה המוגדר הזה. |
שדהusage.total_tokens | סוגinteger | משמעותמספר טוקנים בממשק המקורי, סופי ולא שלילי, הנדרש לפי התעריף הנוכחי שהתקבל. |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה400 · invalid_request_error | תנאיגוף ה־JSON או מזהה המודל הקנוני המפורש אינם תקפים. | השלב הבאיש לשמור את התגובה ולתקן את שדה הבקשה שצוין. |
תגובה401 · authentication_error | תנאימפתח ה־API של Ailoot אינו תקף. | השלב הבאיש להשתמש במפתח ה־API המורשה שלכם של Ailoot. |
תגובה403 · permission_error | תנאיהקבוצה של המפתח אינה מורשית להשתמש בשיטה הזו. | השלב הבאיש לשמור את פרטי השגיאה שהוחזרו. |
תגובה404 · not_found_error | תנאילשיטה שנבחרה אין נתיב מאושר לשימוש. | השלב הבאיש לשמור את פרטי השגיאה שהוחזרו. |
תגובה422 · price_unavailable | תנאילא ניתן להשיג עבור התעריף שהתקבל את כמות הקלט או את הגבול הנדרשים לו. | השלב הבאיש לשמור את התגובה; יש להשתמש בייצוג הקלט הנדרש בתעריף שהתקבל. |
תגובה503 · | תנאיהאחסון, הנתיב, מחיר השיטה או שריון הסכום הנדרשים אינם זמינים. | השלב הבאיש לשמור את התגובה המקורית המלאה. שריון סכום שמצבו אינו ודאי אינו מתיר שליחה חוזרת. |
תגובה502 · billing_requires_check | תנאייש לבדוק את התוצאה המקורית, את נתוני השימוש או את השלמת החיוב. | השלב הבאיש לשמור את מזהה הבקשה הממשי ואת התגובה המקורית. יש לקרוא את הרשומה הקיימת שבבעלותכם; אין לשלוח שוב בקשת יצירה. |
כינויים
כינויים למודל
Ailoot Ultra bge-reranker-v2-m3
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · bge-reranker-v2-m3
- אילו קלטים ותוצאות זמינים?
POST /v1/rerank·bge-reranker-v2-m3:text→rerank- באילו שדות הבקשה משתמשת?
POST /v1/rerank·bge-reranker-v2-m3:model,query,documents