cicora.ai
Spécification de l’APIQualité de la récupération

Reclassement

Réordonnez un petit ensemble de candidats par rapport à une requête afin d’améliorer la précision de la récupération finale.

Référence d’intégration : choisissez les paramètres et les capacités disponibles dans les réglages de l’API de votre compte et dans le catalogue de modèles de votre environnement.

Envoyer la requête et les documents

Obtenez d’abord un ensemble large et peu coûteux par recherche ou embeddings, puis envoyez la requête et les candidats au reclassement. Cela réduit le coût et la latence par rapport au reclassement de tout un corpus.

Les documents doivent conserver votre ID interne afin qu’un résultat puisse être rattaché à l’enregistrement source.

Requête de reclassement
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
  }'

Taille de l’ensemble de candidats

  • Limitez le nombre de documents à une quantité raisonnable avant l’appel.
  • top_n doit correspondre au nombre d’éléments réellement nécessaires à l’étape suivante.
  • Ne regroupez pas dans un même texte des documents assortis de droits d’accès différents.

Utiliser le score

Un résultat de reclassement est un signal d’ordonnancement, et non une vérité absolue. Combinez-le avec les filtres d’accès, la récence et les règles métier.

Consignez la requête et les ID désidentifiés des candidats pour une évaluation hors ligne, sans copier de contenu restreint dans des journaux superflus.