bge-reranker-v2-m3
مُرمِّز تقاطعي متعدد اللغات من BAAI لترتيب المقاطع المرشحة مقابل استعلام. يقرأ كل زوج من الاستعلام والمقطع معًا ويعيد درجة صلة، لتنقيح قائمة البحث المختصرة من دون توليد إجابة أو إنشاء تضمينات للمستندات.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
BGE Reranker v2 M3 نموذج متعدد اللغات لتقدير الصلة، مبني على BGE-M3. يتلقى استعلامًا ومقطعًا مرشّحًا معًا ويُرجع درجة للعلاقة بينهما. تقدّم BAAI هذا الإصدار بوصفه نموذجًا كفؤًا متعدد اللغات لإعادة الترتيب، بما يشمل الاسترجاع بالصينية والإنجليزية حين يحتاج تطبيق البحث إلى تحسين قائمة مرشحين موجودة.
الصلة من زوج استعلام ومقطع
يعالج المُرمِّز المتقاطع النصين معًا، مما يسمح بتفاعل محتواهما قبل إنتاج درجة الصلة. يختلف ذلك عن نموذج التضمين، الذي يرمّز النصوص بصورة مستقلة لمقارنة متجهات قابلة لإعادة الاستخدام. ناتج معيد الترتيب درجة عددية مفردة لزوج بعينه، وليس متجه مستند أو إجابة مكتوبة.
استخدم النموذج بعد أن يختار البحث الأولي مقاطع يُحتمل أن تكون مناسبة. اقرن السؤال بكل مرشّح ورتّب المرشحين وفق الدرجات الناتجة. يركّز ذلك المقارنة الأكثر تفصيلًا على قائمة مختصرة يسهل التعامل معها، بدل تكليف مُرمِّز متقاطع بفحص كل مقطع في مجموعة كبيرة.
إصدار v2 M3
تحدّد الشركة BGE-M3 بوصفه النموذج الأساسي، وتذكر الدعم متعدد اللغات كميزة رئيسية. ضمن عائلة معيدات الترتيب v2، يُعد M3 الخيار الكفء متعدد اللغات؛ أما الإصدارات المبنية على Gemma وإصدارات اختيار الطبقات فهي نماذج مستقلة ذات خيارات تنفيذ مختلفة. ولا يعني اسم M3 هنا أن معيد الترتيب يُرجع التضمينات الكثيفة والمتناثرة ومتعددة المتجهات الخاصة بنموذج التضمين الأصلي.
يهم هذا الفرق عند اختيار النتيجة التي يحتاجها تطبيقك. اختر نموذج تضمين لتمثيل مجموعة مستندات والبحث فيها. واختر معيد الترتيب هذا عندما يكون لديك نصوص مرشّحة وتحتاج إلى تحديد المقطع الأكثر صلة بالاستعلام الحالي.
إعداد مرشحين يمكن ترتيبهم بصورة مفيدة
قدّم السؤال الفعلي والنص الكامل للمرشّح اللازم لتفسيره. احتفظ بالعناوين أو التعريفات القريبة حين تحدّد معنى المقطع. في مثال Transformers المنشور، يُحوَّل الاستعلام والمقطع معًا إلى رموز مع الاقتطاع وmax_length=512. هذا إعداد للمثال وليس حدًا عامًا للنموذج. أبقِ السؤال والأدلة المطلوبة ضمن الميزانية المختارة للزوج، وتحقّق مما يزيله الاقتطاع. قد تذكر نتيجة المنتج نفسه الوارد في الاستعلام وتظل غير ذات صلة إذا تناولت عملية أو شرطًا غير المطلوب؛ جهّز أمثلة تميّز هذه الحالات عند تقييم جودة الاسترجاع.
في مساعد للمستندات، احتفظ بمعرّفات المرشحين إلى جانب نصوصهم، وقيّم أزواج السؤال والمقطع، ثم مرّر المقاطع الأصلية المختارة إلى خطوة الإجابة. يتلقى نموذج الإجابة حينئذ الأدلة بدل درجة صلة بلا مصدر. هذا مثال توضيحي لمسار استرجاع؛ أما معيد الترتيب نفسه فلا يبحث في مجموعة خارجية ولا يكتب الإجابة.
قراءة الدرجات وتطبيعها
تُرجع الشركة درجات صلة خامًا، وتشير القيمة الأعلى إلى تطابق أقرب. ويطبّق التطبيع الاختياري الموثّق دالة سيغمويد لجعل الدرجة بين 0 و1. يوفّر التطبيع نطاقًا ملائمًا، لكن هذا التحويل وحده لا يثبت احتمالًا معايرًا لصحة المرشّح.
اختر عتبات الترتيب أو التصفية باستخدام أزواج استعلام ومقطع ممثّلة لأعباء عملك. أدرج مقاطع تشترك في الكلمات المفتاحية لكنها تجيب عن سؤال مختلف، وكذلك مقاطع ذات صلة تستخدم صياغة مختلفة. يمنح ذلك العتبة المختارة معنىً للمجموعة التي يجري البحث فيها.
في مشروع يستخدم Ailoot API، حدّد ما ينبغي أن يتضمنه السياق النهائي وعدد المرشحين الذين يمكن فحصهم بكفاءة. النتيجة المفيدة مجموعة أدلة أفضل ترتيبًا لخطوة التطبيق التالية. افصل مخرجات الصلة في هذا الإصدار عن تضمينات المستندات والنصوص المولّدة وعناصر التحكم في اختيار الطبقات الموثّقة لمعِيدات ترتيب أخرى.
Ailoot Ultra · إعادة الترتيب POST /v1/rerank bge-reranker-v2-m3
bge-reranker-v2-m3البداية
مُرمِّز تقاطعي متعدد اللغات من BAAI لترتيب المقاطع المرشحة مقابل استعلام. يقرأ كل زوج من الاستعلام والمقطع معًا ويعيد درجة صلة، لتنقيح قائمة البحث المختصرة من دون توليد إجابة أو إنشاء تضمينات للمستندات.
- المدخلات المقبولة
- النص
- النتائج
- النتائج المرتبة
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · إعادة الترتيب POST /v1/rerank
- الإدخال
text- الإخراج
rerank
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود bge-reranker-v2-m3 | القيمة الافتراضية— |
الحقلquery | النوعstring | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
الحقلdocuments | النوعarray | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, documents |
المعلمةmaterial_types | المواصفاتtext |
المعلمةmaterial_conditions | المواصفاتحدّد استعلامك الفعلي ومصفوفة غير فارغة من المستندات النصية الأصلية. تشير فهارس النتائج إلى تلك المصفوفة الأصلية. |
دورة الحياة: synchronous_result_then_owned_library
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
الباقات
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات Ailoot
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | وحدة الفوترة | الرسوم |
|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | وحدة الفوترة— | الرسوم الإدخال · رموز الإدخال — / 1K من الرموز الإخراج · رموز الإخراج — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
| الإعداداترمز إجمالي | جدول التعرفة— | وحدة الفوترة/ 1K من الرموز | الرسوم الإدخال · رمز إجمالي $0.00004 / 1K من الرموز |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · إعادة الترتيب
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_QUERY:?Set the actual documented input value}"
export AILOOT_QUERY
: "${AILOOT_DOCUMENTS_JSON:?Set the actual documented input value}"
export AILOOT_DOCUMENTS_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'bge-reranker-v2-m3', 'query': '${ACTUAL_QUERY}', 'documents': '${ACTUAL_DOCUMENTS}'}
request['query']=os.environ['AILOOT_QUERY']
request['documents']=json.loads(os.environ['AILOOT_DOCUMENTS_JSON'])
Path('request.json').write_text(json.dumps(request,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 response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
استلام النتائج وحفظها
Ailoot Ultra · إعادة الترتيب
نتيجة JSON الأصلية كاملة بصيغتها الأصلية، مع نموذج الاستجابة المهيّأ، وفهارس المستندات الأصلية، ودرجات الصلة، والسلاسل النصية للمستندات، واستخدام التوكنات الأصلي. احتفظ بكل حقل نتيجة واستخدام فعلي.
GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
الاحتفاظ بكل النتائج المكتملة
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.
عند الحاجة إلى التحقق من الاستجابة الأصلية
احتفظ بقيمة X-Client-Request-ID الفعلية وبالاستجابة كاملة. اقرأ الأصول الأصلية المملوكة لك وعناوين URL الدقيقة الموقّعة لمحتواها؛ ولا تعِد إرسال طلب إنشاء غير مؤكد النتيجة مطلقاً.
حقول الاستجابة
| الحقل | النوع | المعنى |
|---|---|---|
الحقلmodel | النوعstring | المعنىنموذج الاستجابة الدقيق الذي يتطلبه مستهلك Source المهيّأ. |
الحقلresults[].index | النوعinteger | المعنىالفهرس الفريد لمستند الإدخال الأصلي. |
الحقلresults[].relevance_score | النوعnumber | المعنىدرجة صلة ذات قيمة منتهية. |
الحقلresults[].document | النوعstring | المعنىالمستند النصي الأصلي الذي يتطلبه مستهلك الاستجابة المهيّأ هذا. |
الحقلusage.total_tokens | النوعinteger | المعنىعدد توكنات أصلي ذو قيمة منتهية وغير سالبة، تتطلبه التعرفة المقبولة الحالية. |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطمتن JSON أو معرّف النموذج المعتمد الصريح غير صالح. | الخطوة التاليةاحتفظ بالاستجابة وصحّح حقل الطلب المشار إليه. |
الاستجابة401 · authentication_error | الشرطمفتاح API الخاص بـAiloot غير صالح. | الخطوة التاليةاستخدم مفتاح API المخوَّل لك في Ailoot. |
الاستجابة403 · permission_error | الشرطمجموعة المفتاح غير مخوّلة لاستخدام هذه الطريقة. | الخطوة التاليةاحتفظ بتفاصيل الخطأ المُعادة. |
الاستجابة404 · not_found_error | الشرطلا يوجد مسار مسموح به للطريقة المختارة. | الخطوة التاليةاحتفظ بتفاصيل الخطأ المُعادة. |
الاستجابة422 · price_unavailable | الشرطيتعذر على التعرفة المقبولة الحصول على كمية الإدخال المطلوبة أو حدّها. | الخطوة التاليةاحتفظ بالاستجابة؛ واستخدم صيغة تمثيل الإدخال التي تتطلبها التعرفة المقبولة. |
الاستجابة503 · | الشرطالتخزين المطلوب أو المسار أو سعر الطريقة أو حجز الرصيد غير متاح. | الخطوة التاليةاحتفظ بالاستجابة الأصلية كاملة. حجز الرصيد غير المؤكد لا يمنح الإذن بإعادة الإرسال. |
الاستجابة502 · billing_requires_check | الشرطتتطلب النتيجة الأصلية أو الاستخدام أو التسوية التحقق. | الخطوة التاليةاحتفظ بمعرّف الطلب الفعلي وبالاستجابة الأصلية. اقرأ السجل الموجود المملوك لك؛ ولا تعِد إرسال طلب الإنشاء. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra bge-reranker-v2-m3
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · bge-reranker-v2-m3
- ما المدخلات والنتائج المتاحة؟
POST /v1/rerank·bge-reranker-v2-m3:text→rerank- ما الحقول التي يستخدمها الطلب؟
POST /v1/rerank·bge-reranker-v2-m3:model,query,documents