VoyageAI by MongoDB: rerank-2.5-lite
rerank-2.5-lite هو معيد الترتيب المتبع للتعليمات والموجّه لزمن الاستجابة من Voyage AI، لمجموعة مرشحين نصيين مقدّمة. ويحتفظ بسياق استعلام–مستند بسعة 32,000 توكن ودعم متعدد اللغات، ويُعيد قائمة مرتّبة من درجات الصلة وفهارس المستندات الأصلية.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
rerank-2.5-lite هو العضو الخفيف ضمن إصدار معيدات الترتيب 2.5 من Voyage AI. ويصفه المطوّر بأنه نموذج عام يوازن زمن الاستجابة وجودة الصلة، مع اتباع التعليمات بلغة طبيعية ودعم متعدد اللغات. ومدخله استعلام ونصوص مرشحة، ومخرجه ترتيب محسّن لهؤلاء المرشحين مع درجات الصلة.
قرار صلة خفيف في المرحلة الثانية
يعالج نموذج Lite كل زوج استعلام–مستند معًا كمشفّر متقاطع. ويمكن أن يأتي بعد بحث مرحلة أولى بالتضمينات أو بحث معجمي، محسّنًا المقاطع التي اختارتها تلك المرحلة. وهذا يختلف عن إعداد فهرس تضمينات قابل لإعادة الاستخدام: فمعيد الترتيب يفحص الاستعلام ونص المستند المقدّمين معًا لاتخاذ قرار الصلة الحالي.
ولبحث مساعدة تفاعلي، قدّم الشروح المرشحة التي قد تجيب عن سؤال المستخدم. واحتفظ بما يكفي من كل مقطع لنقل السلوك وشروطه، وأبقِ الارتباط بين فهرس المدخل والعنصر المصدري. وتساعد مجموعة مرشحين مركّزة على توضيح مهمة إعادة الترتيب، مع إبقاء الأدلة المسترجعة صالحة للعرض أو لإجابة لاحقة.
تعبّر التعليمات عما يريد المستخدم إعطاءه الأولوية
كما في rerank-2.5، يقبل Lite تعليمات بلغة طبيعية قبل الاستعلام أو بعده. وتستخدمها أمثلة المطوّر للتركيز على مكوّنات مستند أو اختيار نوع مصدر مفضّل أو إضافة سياق لكلمة ملتبسة. ويمكن للتطبيق توفير تفضيل دائم للصلة، أو يمكن للسؤال الحالي تضمين تفضيل أكثر تحديدًا.
ويمكن لاستعلام دعم توضيحي أن يسأل عن المقطع الذي يشرح خطأ، مع تعليمة تعطي الأولوية لخطوات استكشاف الأخطاء على الأوصاف العامة للمنتج. ويمكن لبحث مستندات طلب صياغة السياسة الأصلية بدلًا من نقاش عنها. صِف الأدلة المقصودة وأبقِ التعليمة مختصرة. وتؤثر التعليمات في درجات الصلة؛ وأعدّ أي قيود صارمة للإصدار أو التاريخ أو الصلاحيات ضمن اختيار المرشحين، بدلًا من اعتبار تفضيل الصلة مرشحًا مضمونًا.
اقرأ الترتيب وأعد المقطع المصدري
يُرتَّب المخرج تنازليًا بحسب الصلة. وتشمل كل نتيجة فهرس المستند الأصلي ودرجة بفاصلة عائمة؛ ويُعيد إعداد return-documents الاختياري أيضًا نص المدخل المقابل. ويحدّد خيار top-k عدد النتائج الأولى المُعادة، بينما يؤدي إغفاله إلى إرجاع ترتيب جميع المرشحين المقدّمين.
استخدم تلك الفهارس لاستعادة المقطع المصدري ومعرّفه. ويمكن لمرشح أعيد ترتيبه أن يصبح نتيجة بحث أو دليلًا لخطوة RAG التالية، لكن المخرج ترتيب للنص المقدّم وليس إجابة معاد صياغتها. وقيّم ما إذا كانت المقاطع الأولى تحقق السؤال وتعليمة الصلة معًا، بما في ذلك اللغات وأنواع المستندات الموجودة فعلًا في المجموعة.
الحدود وميزانية عملية للمرشحين
لإصدار 2.5 Lite حد أقصى موثّق للاستعلام يبلغ 8,000 توكن، وحد يبلغ 32,000 توكن للاستعلام مع كل مستند فردي. وهو مستقل عن نموذج rerank-2-lite الأقدم وسياقه الأصغر. ويمكن تقديم ما لا يزيد على 1,000 مستند، ويُحد إجمالي المدخل عند 600,000 توكن وفق الصيغة: توكنات الاستعلام مضروبة في عدد المرشحين، مضافًا إليها مجموع توكنات المستندات المرشحة.
وللاستخدام الحساس لزمن الاستجابة، توصي الأسئلة الشائعة لدى المطوّر باستخدام rerank-2.5-lite مع إجمالي لا يتجاوز 200,000 توكن لكل طلب. وهذه إرشادات عملية دون الحد الأقصى المذكور، وليست نافذة مختلفة لكل مستند. ويُحتسب الاستعلام أو التعليمة الأطول مرة لكل زوج مرشح، لذا يؤثر عدد المرشحين وطول الاستعلام معًا في الإجمالي.
الاقتطاع مفعّل افتراضيًا ويقصّر مدخل الاستعلام/المستند الزائد ليتسع؛ ويؤدي تعطيله إلى خطأ لاستعلام أو زوج متجاوز للطول. وأعدّ مرشحين موجزين يحملون الإجابة عمدًا حتى لا تبقى الأدلة المفيدة وراء حد مقتطع. ولا يزيل اختيار نتائج مخرج أقل عبر top-k المرشحين الآخرين المقدّمين من حساب التوكنات. وافحص المقاطع المصدرية المُعادة وحسّن إعداد المدخل وفق الأسئلة الفعلية التي تحتاج واجهة البحث إلى الإجابة عنها.
Ailoot Ultra · إعادة الترتيب POST /v1/rerank voyageai/rerank-2.5-lite
voyageai/rerank-2.5-liteالبداية
rerank-2.5-lite هو معيد الترتيب المتبع للتعليمات والموجّه لزمن الاستجابة من Voyage AI، لمجموعة مرشحين نصيين مقدّمة. ويحتفظ بسياق استعلام–مستند بسعة 32,000 توكن ودعم متعدد اللغات، ويُعيد قائمة مرتّبة من درجات الصلة وفهارس المستندات الأصلية.
- المدخلات المقبولة
- النص
- النتائج
- النتائج المرتبة
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · إعادة الترتيب POST /v1/rerank
- الإدخال
text- الإخراج
rerank- صيغة الإخراج
- json
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلdocuments | النوعarray | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود voyageai/rerank-2.5-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
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي 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-2.5-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-2.5-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-2.5-lite
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · VoyageAI by MongoDB: rerank-2.5-lite
- ما المدخلات والنتائج المتاحة؟
POST /v1/rerank·voyageai/rerank-2.5-lite:text→rerank- ما الحقول التي يستخدمها الطلب؟
POST /v1/rerank·voyageai/rerank-2.5-lite:documents,model,provider,query,session_id,top_n,trace,user- ما الحدود المطبقة؟
POST /v1/rerank·voyageai/rerank-2.5-lite:top_n.minimum:1