Rerank

Bir sorgu ile bir doküman listesi alır ve dokümanları alaka düzeyine göre yeniden sıralar. RAG sistemlerinde, aramadan dönen aday dokümanları en iyiden en kötüye sıralamak için kullanılır.

POST/v1/rerank

İstek parametreleri

Alan	Tip	Zorunlu	Açıklama
model	string	✓	Rerank modeli (örn. verirerag)
query	string	✓	Arama sorgusu
documents	dizi	✓	Sıralanacak metin listesi
top_n	integer		Yalnızca en iyi N sonucu döndür
return_documents	boolean		Sonuçta doküman metnini de döndür
max_chunks_per_doc	integer		Doküman başına azami parça

Örnek

curl

curl https://app.qevron.ai/v1/rerank \
  -H "Authorization: Bearer $QEVRON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "verirerag",
    "query": "Qevron nasıl kimlik doğrular?",
    "documents": [
      "Qevron istekleri Bearer token ile doğrular.",
      "Hava bugün İstanbul'\''da yağmurlu.",
      "Embedding metni vektöre çevirir."
    ],
    "top_n": 2,
    "return_documents": true
  }'

Python

import httpx

resp = httpx.post(
    "https://app.qevron.ai/v1/rerank",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "verirerag",
        "query": "Qevron nasıl kimlik doğrular?",
        "documents": [
            "Qevron istekleri Bearer token ile doğrular.",
            "Hava bugün İstanbul'da yağmurlu.",
            "Embedding metni vektöre çevirir.",
        ],
        "top_n": 2,
        "return_documents": True,
    },
)
print(resp.json())

Yanıt

{
  "id": "rerank-...",
  "results": [
    {
      "index": 0,
      "relevance_score": 0.987,
      "document": { "text": "Qevron istekleri Bearer token ile doğrular." }
    },
    {
      "index": 2,
      "relevance_score": 0.142,
      "document": { "text": "Embedding metni vektöre çevirir." }
    }
  ],
  "meta": { "tokens": { "input_tokens": 48 } }
}

Alan	Açıklama
results[].index	Girdideki orijinal sıra
results[].relevance_score	Alaka skoru (yüksek = daha alakalı)
results[].document	return_documents: true ise doküman metni

Sonuçlar skora göre azalan sırada döner.