cicora.ai
Especificação da APIQualidade da recuperação

Reordenação

Reordene um pequeno conjunto de candidatos em função de uma consulta para melhorar a precisão da recuperação final.

Referência de integração: escolha os parâmetros e as capacidades disponíveis nas definições da API da sua conta e no catálogo de modelos do seu ambiente.

Enviar consulta e documentos

Obtenha primeiro um conjunto amplo e económico por pesquisa ou embeddings e depois envie a consulta e os candidatos para reordenação. Isto reduz custos e latência em comparação com a reordenação de todo um corpus.

Os documentos têm de conservar o seu ID interno para que um resultado possa ser associado ao registo de origem.

Pedido de reordenação
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
  }'

Tamanho do conjunto de candidatos

  • Limite os documentos a uma quantidade razoável antes da chamada.
  • top_n deve refletir quantos itens a etapa seguinte realmente necessita.
  • Não combine documentos com direitos de acesso diferentes num único texto.

Usar a pontuação

Um resultado de reordenação é um sinal de ordenação, não uma verdade absoluta. Combine-o com filtros de acesso, atualidade e regras comerciais.

Registe a consulta e os IDs dos candidatos sem elementos identificativos para avaliação offline, sem copiar conteúdo restrito para registos desnecessários.