VoyageAI by MongoDB: rerank-3

Voyage rerank-3 هو إصدار Rerank 3 المركّز على الجودة لتقييم صلة الاستعلام بالمستند. ويعيد ترتيب المرشحين النصيين المسترجعين، ويدعم تعليمات الصلة بلغة طبيعية، ويعالج أزواجًا بسعة 32,000 توكن للبحث في المستندات الطويلة والشيفرة وقواعد المعرفة.

Ailoot Ultra · إعادة الترتيب POST /v1/rerank voyageai/rerank-3

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Voyage rerank-3 هو معيد ترتيب نصي صُمّم لتحسين جودة الأدلة المسترجعة. وعند تقديم استعلام وقائمة مستندات مرشحة، يفحص كل زوج معًا ويُعيد المرشحين مرتّبين بحسب الصلة. ويمكن للتضمينات والبحث بالكلمات المفتاحية أولًا تضييق مجموعة كبيرة إلى قائمة مختصرة قابلة للإدارة؛ ثم يطبّق rerank-3 تقييمًا أدق للصلة على تلك القائمة. ومخرجه أدلة بحث بدرجات ليعرضها التطبيق أو يمرّرها إلى خطوة منفصلة لتوليد الإجابة.

Rerank 3 المركّز على الجودة يقدّم المطوّر rerank-3 بوصفه الإصدار المركّز على الدقة، وrerank-3-lite بوصفه إصدار البحث الحساس لزمن الاستجابة. ويحدّث الجيل الثالث البنية الأساسية ومزيج التدريب، مع تحسّن خاص في استرجاع المستندات الطويلة والشيفرة المصدرية مقارنةً بإصدارات 2.5 السابقة المقابلة. ويقيّمه المطوّر عبر الوثائق التقنية والشيفرة والمواد متعددة اللغات ومجالات مستندات أخرى. وتدعم هذه النتائج دوره في الاسترجاع؛ واختر الإصدار وفق الأسئلة والمستندات المرشحة المهمة لمجموعتك نفسها.

مستندات طويلة بسياق كافٍ قد يحتوي المرشح الطويل على سياق مفيد يتجاوز فقرته الأولى بكثير. قدّم قسمًا أو مستندًا متماسكًا مع عنوانه والمادة المحيطة ذات الصلة، حتى يستطيع النموذج تقييم علاقة السؤال الفعلي بالمحتوى. وللبحث في سياسة منتج، احتفظ بالعناوين والاستثناءات المحيطة بالمقطع محل الاهتمام. وإذا جاءت عدة أقسام مسترجعة من المصدر نفسه، فاحتفظ بمعرّفات مستنداتها وأقسامها؛ ليتمكن التطبيق من إظهار منشأ الأدلة المختارة.

يشترك الاستعلام وكل مرشح في نافذة السياق. ويحدّد دليل المطوّر الحالي 32,000 توكن لهذا الزوج، بما يشمل استعلامًا لا يتجاوز 8,000 توكن. لذا يترك استعلام من 3,000 توكن ما لا يزيد على 29,000 توكن لكل مستند. وأعدّ المدخل بحيث يتسع لمحتواه الأساسي، خصوصًا عندما تستهلك مقدمة طويلة أو نصوص نمطية متكررة النافذة. وخيار الاقتطاع الموثّق مفعّل افتراضيًا، ويمكنه تقصير نص الاستعلام أو المستند المتجاوز للحجم قبل التقييم. وافحص المحتوى المحتفَظ به عندما يهم موضع المقطع.

استرجاع الشيفرة والمحتوى التقني في مرحلة الاسترجاع لمساعد برمجي، يمكن أن تحتوي المرشحات على تنفيذات دوال أو وثائق API أو شروح تقنية كنص. وأدرج الرموز والتوقيعات والسياق اللازمة لتمييز المرشحين المتشابهين. ويوفّر استعلام مثل «اعثر على الدالة التي توحّد المسارات مع الحفاظ على فاصل نهائي» سلوكًا ملموسًا للمطابقة. وأرفق أي قيود ذات صلة باللغة أو المنصة أو الإصدار. وبعد الترتيب، افحص الشيفرة المختارة وتبعياتها قبل استخدامها كسياق؛ فدرجة الصلة لا تثبت تحقيق التنفيذ لكل متطلب مذكور.

التعليمات تحدّد الصلة يحتفظ النموذج بقدرة إعادة الترتيب المتبعة للتعليمات التي قُدّمت في Rerank 2.5. أضف تعليمة مختصرة قبل الاستعلام أو بعده عندما يحتاج قصد المستخدم إلى توضيح. وللبحث في المستندات البحثية، اشرح ما إذا كان التركيز على العنوان أو منهج معين أو مجال تطبيق. ولكتالوج داخلي، حدّد ما إذا كان الطلب يتعلق بالتثبيت أو استكشاف الأخطاء أو التوافق. وأبقِ هذه التعليمة منسجمة مع السؤال؛ فالتفضيلات الإضافية المتعارضة مع الطلب الرئيسي قد تغيّر ما يسعى الترتيب إلى تحسينه.

إعداد المستندات المرشحة والميزانيات المدخل قائمة سلاسل نصية. استخرج نصًا قابلًا للاستخدام من المستندات المصدرية، واحتفظ بحدود الأقسام ذات المعنى، وأبقِ خريطة سجلات مرتّبة إلى جانب القائمة. ويسمح المطوّر بما يصل إلى 1,000 مستند في الطلب الواحد. ويحدّد أيضًا سقفًا إجماليًا للمدخل قدره 600,000 توكن: توكنات الاستعلام مضروبة في عدد المستندات، مضافًا إليها مجموع جميع توكنات المستندات. وهذا يختلف عن حد السياق لكل زوج. ويمكن لتقليل نص الاستعلام الزائد الحفاظ على سعة الزوج وميزانية الطلب الإجمالية معًا.

عدّ التوكنات للنموذج المعني بدلًا من افتراض أن عدد الكلمات أو المحارف هو عدد التوكنات. وللمرشحين الكبار، اختر مقاطع متماسكة أو قسّم المادة وفق عناوين مفيدة مع الاحتفاظ بمعلومات المصدر الأم. وتفيد إعادة الترتيب أكثر بعد أن يكون البحث الأول قد أظهر مرشحين محتملين بالفعل: فلا يمكنها ترتيب مصدر مفقود لم يدخل القائمة.

النتائج المرتّبة واستخدامها لاحقًا تحتوي النتيجة درجات صلة وفهارس تشير إلى مستندات المدخل الأصلية، مرتّبة تنازليًا بحسب الصلة. ويحد خيار top_k عدد النتائج المرتّبة المُعادة؛ وإلا يُعاد جميع مرشحي المدخل. وتسمح واجهة REST لدى المطوّر أيضًا بإدراج نص المستند. واستخدم كل فهرس أصلي لاستعادة العنوان ومعرّف المصدر وأي بيانات وصفية يحتاجها تطبيقك، ثم اعرض العناصر المختارة أو اجمع النص ذا الصلة في سياق أدلة للإجابة.

افحص النتائج العليا بالرجوع إلى السؤال، وأبقِ هوية المصدر ظاهرة. فالترتيب النسبي المرتفع لا يتحقّق من الدقة الواقعية للمستند، والقائمة المختصرة التي لا تضم إلا مرشحين ضعفاء سيظل لها عنصر أول. وافصل اختيار الصلة عن تقرير ما إذا كانت الأدلة المختارة كافية للإجابة عن المستخدم.

الانتقال بين الإصدارات يصف المطوّر rerank-3 بأنه بديل مباشر لـrerank-2.5، بدلالات API نفسها ودرجات مُعايرة وفق توزيع الإصدار السابق المقابل. ويدعم هذا التوافق الاحتفاظ بمرحلة الاسترجاع وربط السجلات الموجودين. وقارن ترتيبات نتائج ذات معنى وأي عتبة درجات على المجموعة الحالية قبل الاعتماد على الانتقال. وأبقِ rerank-3 وrerank-3-lite خيارين مستقلين: فالحدود المشتركة واتباع التعليمات لا يجعلان أولوياتهما في الجودة وزمن الاستجابة متطابقة.

Ailoot Ultra · إعادة الترتيب POST /v1/rerank voyageai/rerank-3

voyageai/rerank-3

VoyageAI by MongoDB /voyageai/rerank-3

البداية

المدخلات المقبولة: النص
النتائج: النتائج المرتبة

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · إعادة الترتيب POST /v1/rerank

الإدخال: text
الإخراج: rerank
صيغة الإخراج: json

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`documents`	النوع`array`	المتطلبمطلوب	القيم والحدود	القيمة الافتراضية—
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود voyageai/rerank-3	القيمة الافتراضية—
الحقل`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-3",
  "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'
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

الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

معرّفات النماذج ذات الصلة IDs

voyageai/rerank-3

FAQ · VoyageAI by MongoDB: rerank-3

ما المدخلات والنتائج المتاحة؟: POST /v1/rerank · voyageai/rerank-3: text → rerank
ما الحقول التي يستخدمها الطلب؟: POST /v1/rerank · voyageai/rerank-3: documents, model, provider, query, session_id, top_n, trace, user
ما الحدود المطبقة؟: POST /v1/rerank · voyageai/rerank-3: top_n.minimum: 1

VoyageAI by MongoDB: rerank-3