BAAI: bge-m3
يدعم BAAI BGE-M3 الاسترجاع الكثيف، والاسترجاع المعجمي المتناثر، والاسترجاع متعدد المتجهات عبر أكثر من 100 لغة. يتكون إخراجه الكثيف من 1024 بُعدًا، وتستوعب نافذته ذات 8192 رمزًا الجمل وحتى المستندات الأطول، دون اشتراط توجيه للاستعلام.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
BGE-M3 هو نموذج BAAI متعدد اللغات للاسترجاع، والمصمّم حول ثلاثة أوجه للتنوع: وظائف استرجاع متعددة، ولغات متعددة، وأطوال مدخلات مختلفة. توثّق الجهة المصنّعة دعم أكثر من مئة لغة ومدخلات تصل إلى 8192 رمزًا. يستطيع نموذجه الموحّد توفير متجهات كثيفة وأوزان معجمية متناثرة وتمثيلات متعددة المتجهات، بحيث يمكن لتصميم الاسترجاع اختيار أكثر من نوع من الأدلة أو الجمع بينها.
ثلاثة تمثيلات للاسترجاع
يحوّل النمط الكثيف النص إلى متجه واحد ذي 1024 بُعدًا. ويدعم مقارنة المعنى الذي يمثّله استعلام ومقطع. يسنِد النمط المتناثر أوزانًا إلى الرموز الموجودة في النص للمطابقة المعجمية. ويمثّل نمط المتجهات المتعددة النص بعدة متجهات ويستخدم تفاعلًا على طريقة ColBERT لمقارنة الاستعلام والمستند على مستوى أدق.
تؤدي هذه المخرجات أدوارًا مختلفة في فهرس البحث. يوفّر المتجه الكثيف تمثيلًا واحدًا للمقطع؛ وتحتفظ خريطة أوزان الرموز المتناثرة بالإشارات المعجمية؛ وتوفّر المتجهات المتعددة بنية مقارنة مختلفة. تعرض أمثلة الجهة المنتجة إعادة التمثيلات المختارة وحساب درجات لأزواج نصوص. تعامل مع التمثيل وطريقة التقييم المختارين بوصفهما جزءًا مقصودًا من مهمة الاسترجاع.
النص متعدد اللغات وإعداد المدخلات
لا يتطلب BGE-M3 إضافة تعليمة الاسترجاع التي تستخدمها نماذج BGE الأقدم. جهّز الاستعلام والمقاطع المصدرية الفعلية مباشرةً. يمكن لمجموعة معرفة متعددة اللغات الاحتفاظ بكل مقطع بلغته الأصلية، مع معرّف مستنده وإعداد لغته المحلي. استخدم أسئلة مستخدمين حقيقية من مزيج اللغات المقصود عند فحص النتائج.
من المهام العملية البحث في شروحات السياسات أو مساعدة المنتجات أو التوثيق التقني المحفوظ بعدة لغات. احتفظ بالأسماء وأرقام النماذج والمصطلحات المهمة للسؤال. يمكن للتمثيل المعجمي المساعدة في الحفاظ على المطابقة مع تلك المصطلحات، بينما يوفّر التمثيل الكثيف أدلة دلالية. ينبغي أن يتضمن المقطع المسترجع النص وموضع المصدر اللذين يستطيع القارئ فحصهما.
المستندات الأطول ومستوى التفصيل
تتيح نافذة المدخلات البالغة 8192 رمزًا للنموذج تمثيل مادة تتراوح من الجمل القصيرة إلى المستندات الأطول. اختر مستوى تفصيل المقاطع وفق الإجابة التي ينبغي أن يعيدها البحث. قد يحافظ قسم كامل على تعريف واستثناءاته؛ وقد يسهّل مقطع أصغر العثور على تعليمة محددة. تتيح النافذة الطويلة هذه الخيارات، لكن المتجه يظل مرتبطًا بالمادة التي رُمّزت فعلًا.
احتفظ بربط كل مقطع بمستنده الأصل وإصداره. بالنسبة إلى تقرير طويل، حافظ على العنوان والشرح المحيط بالشكل أو الاستنتاج ذي الصلة. لا تعتمد على عنوان نتيجة البحث وحده عندما تكون الأدلة في المتن. وإذا تغيّر المصدر، فاحتفظ ببيانات وصفية كافية لتحديث تمثيلات الاسترجاع المقابلة.
الدرجات الهجينة والاستخدام اللاحق
توصي الجهة المصنّعة بالاسترجاع الهجين، يليه طور منفصل لإعادة الترتيب. تحسب أمثلتها درجات كثيفة ومتناثرة ومتعددة المتجهات وتكوّن تركيبات موزونة. اختر التركيبة وفق أسئلة المجموعة ومفرداتها؛ فالوزن المعروض في مثال ليس إعدادًا عامًا لكل متن.
النتيجة المفيدة مجموعة مرشحين تبقى مقاطعها المصدرية متاحة، مع تسجيل التمثيل وطريقة الترتيب. يستطيع معيد ترتيب منفصل تنقيح تلك المجموعة، وتستطيع مرحلة منفصلة لتوليد النص استخدام محتوى المقاطع. قدرات BGE-M3 المتناثرة ومتعددة المتجهات أنماط في نموذج الجهة المنتجة؛ أما التضمين الكثيف والمخرج المعجمي ودرجة الزوج فهي آثار مختلفة وليست مصفوفات قابلة للاستبدال.
Ailoot Ultra · التضمينات POST /v1/embeddings baai/bge-m3
baai/bge-m3البداية
يدعم BAAI BGE-M3 الاسترجاع الكثيف، والاسترجاع المعجمي المتناثر، والاسترجاع متعدد المتجهات عبر أكثر من 100 لغة. يتكون إخراجه الكثيف من 1024 بُعدًا، وتستوعب نافذته ذات 8192 رمزًا الجمل وحتى المستندات الأطول، دون اشتراط توجيه للاستعلام.
- المدخلات المقبولة
- النص · token_ids
- النتائج
- embedding
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · التضمينات POST /v1/embeddings
- الإدخال
text,token_ids- الإخراج
embedding- السياق
- 8,194 tokens
- صيغة الإخراج
- json
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود baai/bge-m3 | القيمة الافتراضية— |
الحقلinput | النوعstring|string[]|integer[]|integer[][] | المتطلبمطلوب | القيم والحدود الحد الأدنى للعناصر: 1 الشروط: دفعة متجانسة غير فارغة. معرّفات التوكنات أعداد صحيحة غير سالبة. سعة الإدخال: الحد الأقصى: 8,194 · وحدة النص: بايتات UTF8 · وحدة الرموز: عناصر مصفوفة الرموز | القيمة الافتراضية— |
الحقلencoding_format | النوعstring | المتطلباختياري | القيم والحدود float | القيمة الافتراضيةfloat |
الحقلdimensions | النوعinteger | المتطلبغير مدعوم | القيم والحدود الحد الأدنى: 1 | القيمة الافتراضية— |
الحقلuser | النوعjson_value | المتطلباختياري | القيم والحدود الشروط: يسمح المصدر بحقل البيانات الوصفية هذا بصيغة JSON؛ ويعتمد المعنى الدقيق لدى المزوّد الأصلي على النموذج. | القيمة الافتراضية— |
الحقلsession_id | النوعjson_value | المتطلباختياري | القيم والحدود الشروط: يسمح المصدر بحقل البيانات الوصفية هذا بصيغة JSON؛ ويعتمد المعنى الدقيق لدى المزوّد الأصلي على النموذج. | القيمة الافتراضية— |
الحقلtrace | النوعjson_value | المتطلباختياري | القيم والحدود الشروط: يسمح المصدر بحقل البيانات الوصفية هذا بصيغة JSON؛ ويعتمد المعنى الدقيق لدى المزوّد الأصلي على النموذج. | القيمة الافتراضية— |
الحقلprovider | النوعobject | المتطلباختياري | القيم والحدود الشروط: تم رفض provider.options | القيمة الافتراضية— |
تركيبات مواد الإدخال
text_to_embedding
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, input |
المعلمةinput_shapes | المواصفاتstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
المعلمةencoding_format | المواصفاتfloat |
المعلمةdimensions_override | المواصفاتfalse |
المعلمةmax_input_budget_units | المواصفات8194 |
المعلمةmultimodal_objects | المواصفاتfalse |
المعلمةmaterial_types | المواصفاتtext, token_ids |
دورة الحياة: synchronous_json
احتفظ بفهرس كل متجه وبُعده.
اسم النموذج متعدد الوسائط لا يتيح استخدام كائنات الصور على هذا المسار المحدد.
الباقات
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- التعرفة القياسية عند اختيار الوضع السريع
- الوضع المرن
- التعرفة القياسية عند اختيار وضع flex
- أقصى جهد للاستدلال
- التعرفة القياسية عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات Ailoot
الأسعار حسب الإعدادات
| الإعدادات | جدول التعرفة | الرسوم |
|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الرسوم الإدخال · رموز الإدخال $0.00004 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · التضمينات
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "baai/bge-m3", "input": ["First document", "Second document"]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
-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
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
from openai import OpenAI
import os
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='baai/bge-m3',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
استلام النتائج وحفظها
Ailoot Ultra · التضمينات
json
الاحتفاظ بكل النتائج المكتملة
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
احتفظ بكل متجه مع فهرسه. يجب أن يساوي عدد المتجهات عدد المدخلات، وأن تكون الأبعاد متسقة.
عند الحاجة إلى التحقق من الاستجابة الأصلية
لا تُستحدث نقطة نهاية لمهام التضمين.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلobject | النوعstring |
الحقلmodel | النوعstring |
الحقلdata[].index | النوعinteger |
الحقلdata[].embedding | النوعfinite float[] |
الحقلusage | النوعobject |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة | الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra baai/bge-m3
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · BAAI: bge-m3
- ما المدخلات والنتائج المتاحة؟
POST /v1/embeddings·baai/bge-m3:text,token_ids→embedding- ما الحقول التي يستخدمها الطلب؟
POST /v1/embeddings·baai/bge-m3:model,input,encoding_format,provider- ما الحدود المطبقة؟
POST /v1/embeddings·baai/bge-m3:ctx:8194;input.budget.maximum:8194(بايتات UTF8);input.min_items:1