cicora.ai
Specifica APIQualità del recupero

Riordinamento

Riordina un piccolo insieme di candidati rispetto a una query per migliorare la precisione del recupero finale.

Riferimento per l'integrazione: scegli i parametri e le funzionalità disponibili dalle impostazioni API del tuo account e dal catalogo dei modelli per il tuo ambiente.

Invia query e documenti

Ottieni prima un insieme ampio ed economico tramite ricerca o embedding, quindi invia query e candidati al riordinamento. Ciò riduce costi e latenza rispetto al riordinamento di un intero corpus.

I documenti devono conservare il tuo ID interno, affinché un risultato possa essere ricondotto al record sorgente.

Richiesta di riordinamento
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
  }'

Dimensione dell'insieme di candidati

  • Limita i documenti a un numero ragionevole prima della chiamata.
  • top_n dovrebbe rispecchiare quanti elementi servono davvero al passaggio successivo.
  • Non combinare in un solo testo documenti con diritti di accesso diversi.

Usa il punteggio

Un risultato di riordinamento è un segnale di ordinamento, non una verità assoluta. Combinalo con filtri di accesso, attualità dei contenuti e regole aziendali.

Registra la query e gli ID deidentificati dei candidati per la valutazione offline, senza copiare contenuti riservati in log non necessari.