Cohere: Rerank v3.5
يعيد Cohere Rerank 3.5 ترتيب النصوص المرشّحة والسجلات شبه المنظمة بحسب صلتها باستعلام. يدعم أكثر من 100 لغة وسياقًا من 4096 رمزًا لتحسين نتائج البحث بالكلمات المفتاحية أو الدلالي قبل صياغة إجابة أو عرض نتائج البحث.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Cohere Rerank 3.5 نموذج متعدد اللغات لترتيب صلة المستندات المرشّحة والنصوص شبه المنظمة. يقيّم كل مرشّح بالنسبة إلى استعلام ويُرجع قائمة نتائج معاد ترتيبها مع درجات صلة. يمكنه تحسين مرشّحين جرى الحصول عليهم بالبحث بالكلمات المفتاحية أو البحث الدلالي، واختيار مقاطع لإجابة معزّزة بالاسترجاع. مهمته تحسين ترتيب الأدلة، وليس توليد إجابة حرة أو إنشاء فهرس جديد لمجموعة نصوص.
معرّف الشركة الدقيق هو rerank-v3.5. يستخدم سياقًا من 4096 رمزًا، مستقلًا عن سياق 32K في Rerank 4 Pro وFast. تُحتسب رموز الاستعلام والمستند معًا ضمن تلك النافذة لكل مرشّح. يقتطع دليل الإعداد الخاص بالنموذج ما يتجاوز أول 2048 رمزًا من الاستعلام، ويصف أجزاء مستندات من 4093 رمزًا قبل أخذ الاستعلام في الحسبان. أبقِ الاستعلام مركّزًا وجهّز مقاطع مرشّحة تحتوي المعلومات اللازمة لتقدير العلاقة المطلوبة.
قدّم الاستعلام وقائمة سلاسل نصوص المرشّحين. تحمل كل نتيجة فهرسًا يشير إلى موضع المستند الأصلي ودرجة صلة؛ ويختار top_n عدد النتائج المرتّبة المطلوب الاحتفاظ بها. دون هذا الخيار، يُرجع مسار الشركة الموثّق جميع النتائج. احتفظ بمعرّفات المستندات مستقلةً عن الدرجة، حتى يمكن تتبّع المقطع الأعلى إلى السياسة أو سجل المنتج أو الرسالة الأصلية.
يدعم Rerank 3.5 أكثر من 100 لغة، بما يشمل المواد الإنجليزية وغير الإنجليزية. يمكن للاستعلام تضمين عدة جوانب للحاجة، مثل المنتج ووضع المستخدم والإجراء المرغوب. في السجلات المنظمة، أزال الإصدار V2 كائنات المستندات الخام ويوصي بسلاسل YAML. رتّب الحقول المفيدة عمدًا، مع المحتوى الحاسم قبل البيانات الوصفية الأقل صلة، لأن السلاسل الطويلة قد تُقتطع. ينطبق ذلك على العناوين والمحتوى وسمات المنتجات أو موضوع الرسالة ومتنها.
يستخدم مرجع الشركة V2 الخيار max_tokens_per_doc لاقتطاع المستندات، بقيمة افتراضية 4096. ويصف دليل إعداد Cohere أيضًا تقسيم المستندات الطويلة؛ وتعتمد المدخلات الفعلية على المسار المختار وإعدادات مستنداته. لمزيد من التحكم، جهّز بنفسك مقاطع ذات معرّفات بدل افتراض بقاء كل قسم من مصدر طويل ظاهرًا. احتفظ بسياق محيط كافٍ لتمييز المقطع الحامل للإجابة من مقطع يشترك في مفرداتها فقط.
لأداء الطلبات، يوصي المرجع الحالي بعدم إرسال أكثر من 1,000 مستند دفعة واحدة. تُطبَّع درجات الصلة بين 0 و1، لكن قيمها تعتمد على الاستعلام والمرشّحين وليست مقياسًا خطيًا للصحة. استخدم الترتيب لتحديد الأدلة المفيدة. إذا احتجت إلى عتبة درجات، فاختر استعلامات مجال ممثّلة ومقاطع ذات صلة حدّية حتى تعكس العتبة مهمة الاسترجاع الفعلية.
يمكن لمسار دعم عملي إعادة ترتيب أقسام مرشّحة لسياسة الإرجاع للإجابة عن سؤال حول منتج تالف، ثم تمرير النص المصدري المختار إلى مرحلة كتابة الإجابة. ويمكن لبحث بريد إلكتروني ترتيب الرسائل وفق مشكلة محدّدة والاحتفاظ بمعرّف الرسالة الأصلي مع كل نتيجة. المخرج المفيد قائمة الأدلة المرتّبة. أبقِ سياق Rerank 3.5 الأقصر وإعداد مستندات V2 مرتبطين بتلك النتيجة بدل استبدالهما بحدود نماذج لاحقة.
Ailoot Ultra · إعادة الترتيب POST /v1/rerank cohere/rerank-v3.5
cohere/rerank-v3.5البداية
يعيد Cohere Rerank 3.5 ترتيب النصوص المرشّحة والسجلات شبه المنظمة بحسب صلتها باستعلام. يدعم أكثر من 100 لغة وسياقًا من 4096 رمزًا لتحسين نتائج البحث بالكلمات المفتاحية أو الدلالي قبل صياغة إجابة أو عرض نتائج البحث.
- المدخلات المقبولة
- النص
- النتائج
- النتائج المرتبة
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · إعادة الترتيب POST /v1/rerank
- الإدخال
text- الإخراج
rerank- صيغة الإخراج
- json
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلdocuments | النوعarray | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود cohere/rerank-v3.5 | القيمة الافتراضية— |
الحقل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 | جدول التعرفة— | وحدة الفوترةلكل وحدة بحث | الرسوم total · وحدة بحث $0.002 لكل وحدة بحث |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · إعادة الترتيب
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "cohere/rerank-v3.5",
"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']='cohere/rerank-v3.5'
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 cohere/rerank-v3.5
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Cohere: Rerank v3.5
- ما المدخلات والنتائج المتاحة؟
POST /v1/rerank·cohere/rerank-v3.5:text→rerank- ما الحقول التي يستخدمها الطلب؟
POST /v1/rerank·cohere/rerank-v3.5:documents,model,provider,query,session_id,top_n,trace,user- ما الحدود المطبقة؟
POST /v1/rerank·cohere/rerank-v3.5:top_n.minimum:1