Rerank

مرتب‌سازی مجدد چند سند بر اساس ارتباط با یک کوئری. برای بهبود کیفیت RAG بسیار مفید است.

اندپوینت

POSThttps://api.darvareh.ir/v1/rerank

پارامترها

پارامترنوعاجباریتوضیح
modelstringبلهمثل rerank-english-v3.0 یا rerank-multilingual-v3.0.
querystringبلهمتن جست‌وجو.
documentsstring[]بلهفهرست اسناد کاندیدا.
top_ninteger—تعداد نتایج بازگشتی.
return_documentsboolean—بازگشت متن سند به‌همراه امتیاز.

نمونۀ درخواست

curl -X POST https://api.darvareh.ir/v1/rerank \
  -H "Authorization: Bearer YOUR_DARVAREH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rerank-multilingual-v3.0",
    "query": "چگونه در درواره کیف پول را شارژ کنم؟",
    "documents": [
      "درواره یک پلتفرم دسترسی به مدل‌های هوش مصنوعی است.",
      "برای شارژ کیف پول به صفحۀ /wallet بروید و از درگاه زرین‌پال استفاده کنید.",
      "برای ساخت کلید API صفحۀ /api-keys را باز کنید."
    ],
    "top_n": 2,
    "return_documents": true
  }'

نمونۀ پاسخ

{
  "id": "rerank_01H...",
  "model": "rerank-multilingual-v3.0",
  "results": [
    { "index": 1, "relevance_score": 0.982, "document": { "text": "برای شارژ کیف پول..." } },
    { "index": 0, "relevance_score": 0.132, "document": { "text": "درواره یک پلتفرم..." } }
  ]
}

الگوی پیشنهادی برای RAG

  1. با /embeddings ۲۰ تا ۵۰ سند نامزد اولیه پیدا کنید.
  2. این نامزدها را با /rerank مجدداً مرتب کنید.
  3. ۳ تا ۵ سند برتر را به /chat/completions بدهید.