VoyageAI by MongoDB: rerank-2.5
يعيد rerank-2.5 ترتيب مجموعة مرشحين نصيين مقدّمة بحسب صلتهم باستعلام وتعليمات اختيارية بلغة طبيعية. وهو معيد ترتيب متعدد اللغات وموجّه للجودة، بسياق استعلام–مستند بسعة 32,000 توكن ودرجات مرتّبة مرتبطة بفهارس المرشحين الأصلية.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في 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البداية
يعيد rerank-2.5 ترتيب مجموعة مرشحين نصيين مقدّمة بحسب صلتهم باستعلام وتعليمات اختيارية بلغة طبيعية. وهو معيد ترتيب متعدد اللغات وموجّه للجودة، بسياق استعلام–مستند بسعة 32,000 توكن ودرجات مرتّبة مرتبطة بفهارس المرشحين الأصلية.
- المدخلات المقبولة
- النص
- النتائج
- النتائج المرتبة
متاح في 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
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي 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
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