cicora.ai
API-specificatieKwaliteit van ophalen

Herordenen

Herorden een kleine kandidatenverzameling ten opzichte van een query om de precisie van het uiteindelijke ophalen te verbeteren.

Integratiereferentie: kies parameters en beschikbare mogelijkheden uit de API-instellingen van uw account en de modelcatalogus voor uw omgeving.

Query en documenten versturen

Verkrijg eerst een goedkope, brede verzameling via zoeken of embeddings en stuur daarna query en kandidaten naar rerank. Dit verlaagt kosten en latentie vergeleken met het herordenen van een volledig corpus.

Documenten moeten uw interne ID behouden, zodat een resultaat naar de bronregistratie kan verwijzen.

Rerank-aanvraag
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
  }'

Omvang van kandidatenverzameling

  • Beperk het aantal documenten vóór de aanroep tot een redelijk aantal.
  • top_n moet weerspiegelen hoeveel items de volgende stap werkelijk nodig heeft.
  • Voeg documenten met verschillende toegangsrechten niet samen tot één tekst.

De score gebruiken

Een herordeningsresultaat is een rangschikkingssignaal, geen absolute waarheid. Combineer het met toegangsfilters, actualiteit en bedrijfsregels.

Log de query en gedeïdentificeerde kandidaten-ID's voor offline-evaluatie zonder inhoud met beperkte toegang naar onnodige logboeken te kopiëren.