Source: https://ailoot.ai/models/ar/voyageai-rerank-3/
Canonical: https://ailoot.ai/models/ar/voyageai-rerank-3/
Language: ar

# VoyageAI by MongoDB: rerank-3

[Markdown](https://ailoot.ai/models/ar/voyageai-rerank-3/index.md) · [JSON](https://ailoot.ai/models/ar/voyageai-rerank-3/facts.json)

## [VoyageAI by MongoDB: rerank-3](https://ailoot.ai/models/ar/voyageai-rerank-3/)

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

- [**Ailoot Ultra · إعادة الترتيب** `POST /v1/rerank` `voyageai/rerank-3`](https://ailoot.ai/models/ar/voyageai-rerank-3/#method-0)

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في 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`](https://ailoot.ai/models/ar/#m=voyageai%2Frerank-3&route=Ultra&caller=voyageai%2Frerank-3&fmt=rerank)

VoyageAI by MongoDB /`voyageai/rerank-3`

### البداية

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

المدخلات المقبولة

النص

النتائج

النتائج المرتبة

### متاح في 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 مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. [كيفية عمل حجز المبلغ وتسوية الرسوم →](https://ailoot.ai/docs/ar/billing/reserve/)

### أمثلة للطلبات

#### Ailoot Ultra · إعادة الترتيب

بنية الطلب الرسمية المحفوظة؛ مثال توثيقياستخدم مواد طلبك الفعلية واحتفظ بالنتيجة كاملة

```json
{
  "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
}
```

```bash
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`](https://ailoot.ai/models/ar/#m=voyageai%2Frerank-3&route=Ultra&caller=voyageai%2Frerank-3&fmt=rerank)

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

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

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

[`voyageai/rerank-3`](https://ailoot.ai/models/ar/#m=voyageai%2Frerank-3&route=Ultra&caller=voyageai%2Frerank-3&fmt=rerank)

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`

اربط Ailoot بخدمة Claude Code أوOpenCode أوHermes أوتطبيقك.

## الشركة ومحفظة مشاريعها

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

## اشتر الرموز بخصم.

خصم اشتراك للعمل المنتظم. الرموز الترويجية حتى 50% على شراء الرموز.

الاشتراك

اختر خطة بخصم لطلباتك المنتظمة.

رمز خصم حتى 50%

أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري.

المصروفات في السجل

يحفظ النموذج والرموز والمبلغ لكل طلب.

[اختر اشتراكا](https://ailoot.ai/docs/ar/billing/subscriptions/) · [اعرض أسعار النماذج](https://ailoot.ai/models/ar/)

## اربط API بالمنتج الذي تبيعه.

SaaS والتطبيقات والبوتات وفق العرض واتفاقية ترخيص Ailoot. لإعادة البيع، اطلب ترخيص موزع.

تطبيق تجاري

أضف توليد النص والصور والفيديو والصوت إلى ميزات خدمتك المدفوعة.

ترخيص إعادة البيع

أرسل وصف المشروع وطريقة توفير الوصول. اطلب شروط استخدام وإعادة بيع مكتوبة.

المستندات على الموقع

العرض واتفاقية الترخيص وسياسة معالجة البيانات متاحة قبل الربط.

[اطلب ترخيص إعادة بيع](mailto:support@ailoot.ai) · [العرض واتفاقية الترخيص](https://ailoot.ai/legal/offer?lang=ar)

## Ailoot · الشركة ومحفظة مشاريعها





تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.





الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.





توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.