cicora.ai
مواصفات APIجودة الاسترجاع

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

أعد ترتيب مجموعة صغيرة من المرشحين وفق استعلام لتحسين دقة الاسترجاع النهائي.

مرجع التكامل: اختر المعلمات والإمكانات المتاحة من إعدادات API لحسابك ومن كتالوج النماذج لبيئتك.

إرسال الاستعلام والمستندات

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

يجب أن تحتفظ المستندات بمعرّفك الداخلي حتى يمكن ربط النتيجة بالسجل المصدر.

طلب إعادة ترتيب
bash
curl --request POST https://cicora.ai/api/v1/rerank \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "cohere/rerank-v3.5",
    "query": "How do I change a subscription?",
    "documents": ["Billing changes are in Settings.", "Images can be generated from a prompt."],
    "top_n": 1
  }'

حجم مجموعة المرشحين

  • اقصر عدد المستندات على مقدار معقول قبل الاستدعاء.
  • ينبغي أن يعكس top_n عدد العناصر التي تحتاجها الخطوة التالية فعلًا.
  • لا تجمع مستندات ذات حقوق وصول مختلفة في نص واحد.

استخدام الدرجة

نتيجة إعادة الترتيب إشارة ترتيب وليست حقيقة مطلقة. ادمجها مع عوامل تصفية الوصول والحداثة وقواعد الأعمال.

سجّل الاستعلام ومعرّفات المرشحين منزوعة الهوية للتقييم خارج بيئة التشغيل، من دون نسخ المحتوى المقيّد إلى سجلات غير ضرورية.