cicora.ai
API-specifikationHämtningskvalitet

Omrankning

Sortera om en liten uppsättning kandidater mot en fråga för att förbättra precisionen i den slutliga hämtningen.

Integrationsreferens: välj parametrar och tillgängliga funktioner från API-inställningarna för ditt konto och modellkatalogen för din miljö.

Skicka fråga och dokument

Hämta först en billig och bred uppsättning genom sökning eller inbäddningar och skicka sedan fråga och kandidater till omrankning. Det minskar kostnad och latens jämfört med att omranka en hel korpus.

Dokument måste behålla ditt interna id så att ett resultat kan mappas tillbaka till källposten.

Begäran om omrankning
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
  }'

Kandidatuppsättningens storlek

  • Begränsa dokumenten till ett rimligt antal före anropet.
  • top_n bör motsvara hur många objekt nästa steg verkligen behöver.
  • Slå inte samman dokument med olika åtkomsträttigheter till en enda text.

Använd poängen

Ett omrankningsresultat är en sorteringssignal, inte en absolut sanning. Kombinera det med åtkomstfilter, aktualitet och affärsregler.

Logga frågan och avidentifierade kandidat-id:n för offlineutvärdering utan att kopiera innehåll med begränsad åtkomst till onödiga loggar.