Envía la consulta y los documentos
Obtén primero un conjunto amplio y económico mediante búsqueda o embeddings; después envía la consulta y los candidatos para su reclasificación. Reduce coste y latencia frente a reordenar todo un corpus.
Los documentos deben conservar tu ID interno para asociar un resultado al registro fuente.
Solicitud de reclasificación
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
}'Tamaño del conjunto candidato
- Limita los documentos a una cantidad razonable antes de la llamada.
- top_n debería reflejar cuántos elementos necesita realmente el paso siguiente.
- No combines en un mismo texto documentos con distintos derechos de acceso.
Usa la puntuación
Un resultado de reclasificación es una señal de ordenación, no una verdad absoluta. Combínalo con filtros de acceso, actualidad y reglas de negocio.
Registra la consulta y los ID de candidatos sin datos identificativos para evaluación fuera de línea, sin copiar contenido restringido en registros innecesarios.