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
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي 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