Cohere: Rerank v3.5
Cohere Rerank 3.5 reordena texto candidato e registos semiestruturados pela relevância para uma consulta. Suporta mais de 100 idiomas e um contexto de 4096 tokens para refinar resultados de pesquisa por palavras-chave ou semântica antes de uma resposta ou apresentação de pesquisa.
Sobre o modelo
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
Cohere Rerank 3.5 é um modelo multilingue para ordenação por relevância de documentos candidatos e texto semiestruturado. Avalia cada candidato em relação a uma consulta e devolve uma lista de resultados reordenada com pontuações de relevância. Pode refinar candidatos obtidos através de pesquisa por palavras-chave ou semântica e selecionar passagens para uma resposta aumentada por recuperação. A sua tarefa é melhorar a ordenação dos elementos de prova, em vez de gerar uma resposta livre ou criar um novo índice do corpus.
O identificador exato do fabricante é rerank-v3.5. Utiliza um contexto de 4096 tokens, distinto do contexto de 32K de Rerank 4 Pro e Fast. Os tokens da consulta e do documento contam em conjunto para essa janela por candidato. O guia de preparação específico do modelo trunca uma consulta depois dos primeiros 2048 tokens e descreve blocos de documentos de 4093 tokens antes de ter em conta a consulta. Mantenha a consulta focada e prepare passagens candidatas que contenham a informação necessária para avaliar a relação pedida.
Forneça a consulta e uma lista de cadeias de texto candidatas. Cada resultado contém um índice que aponta para a posição original do documento e uma pontuação de relevância; top_n escolhe quantos resultados ordenados reter. Sem esse parâmetro, o fluxo de trabalho documentado do fabricante devolve todos os resultados. Preserve os identificadores dos documentos independentemente da pontuação para que a passagem principal continue rastreável até à política, registo de produto ou mensagem original.
Rerank 3.5 suporta mais de 100 idiomas, incluindo material em inglês e noutros idiomas. Uma consulta pode conter vários aspetos da necessidade, como o produto, a situação do utilizador e o procedimento pretendido. Para registos estruturados, a versão V2 removeu objetos de documento em bruto e recomenda cadeias YAML. Mantenha os campos úteis numa ordem deliberada, com o conteúdo decisivo antes de metadados menos relevantes, porque cadeias longas podem ser truncadas. Isto funciona para títulos e conteúdo, atributos de produtos ou assunto e corpo de uma mensagem.
A referência V2 do fabricante utiliza max_tokens_per_doc para truncamento dos documentos, com o valor predefinido de 4096. O guia de preparação da Cohere descreve também a divisão de documentos longos em blocos; a entrada efetiva depende do fluxo de trabalho selecionado e das definições dos documentos. Para maior controlo, prepare passagens identificáveis, em vez de presumir que todas as secções de uma fonte longa continuam visíveis. Preserve contexto envolvente suficiente para distinguir uma passagem que contém a resposta de outra que apenas partilha o seu vocabulário.
Para o desempenho dos pedidos, a referência atual recomenda não enviar mais de 1 000 documentos de uma só vez. As pontuações de relevância são normalizadas entre 0 e 1, mas os valores dependem da consulta e dos candidatos e não constituem uma escala linear de correção. Utilize a ordenação para identificar elementos de prova úteis. Se precisar de um limiar de pontuação, escolha consultas representativas do domínio e passagens de relevância limítrofe para que o limiar reflita a tarefa real de recuperação.
Um fluxo de apoio prático pode reordenar secções candidatas da política de devoluções para uma pergunta sobre um artigo danificado e passar depois o texto de origem selecionado para uma etapa de redação da resposta. Uma pesquisa de correio eletrónico pode ordenar mensagens por uma questão específica e conservar o identificador da mensagem original com cada resultado. O resultado útil é a lista ordenada de elementos de prova. Mantenha o contexto mais curto de Rerank 3.5 e a preparação documental V2 associados a esse resultado, em vez de substituir os limites pelos de modelos posteriores.
Ailoot Ultra · Reordenação POST /v1/rerank cohere/rerank-v3.5
cohere/rerank-v3.5Introdução
Cohere Rerank 3.5 reordena texto candidato e registos semiestruturados pela relevância para uma consulta. Suporta mais de 100 idiomas e um contexto de 4096 tokens para refinar resultados de pesquisa por palavras-chave ou semântica antes de uma resposta ou apresentação de pesquisa.
- Entradas aceites
- Texto
- Resultados
- Resultados ordenados
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · Reordenação POST /v1/rerank
- Entrada
text- Saída
rerank- Formato de saída
- json
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campodocuments | Tipoarray | RequisitoObrigatório | Valores e limites | Predefinição— |
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites cohere/rerank-v3.5 | Predefinição— |
Campoprovider | Tiposchema | RequisitoOpcional | Valores e limites | Predefinição— |
Campoquery | Tipostring | RequisitoObrigatório | Valores e limites | Predefinição— |
Camposession_id | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campotop_n | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 1 | Predefinição— |
Campotrace | Tiposchema | RequisitoOpcional | Valores e limites | Predefinição— |
Campouser | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campodocuments[].text | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campodocuments[].image | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Combinações de materiais de entrada
text_rerank · Obrigatório: query, documents array with minItems1
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, query, documents |
Parâmetromaterial_types | Contratotext |
Parâmetrooptional_controls | Contratoprovider, session_id, top_n, trace, user |
Parâmetromultimodal_input_binding | Contratonull |
Ciclo de vida: synchronous
Envie o ID exato do modelo e conserve a resposta nativa completa.
Tarifários
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
- Modo rápido
- Não especificado Quando o modo rápido está selecionado
- Modo flex
- Não especificado Quando o modo flex está selecionado
- Esforço máximo de raciocínio
- Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Tarifas Ailoot
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Tabela de tarifas | Unidade de faturação | Custo |
|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Unidade de faturação— | Custo Entrada · Tokens de entrada — / 1K tokens Saída · Tokens de saída — / 1K tokens Entrada · Leitura da cache — / 1K tokens Entrada · Escrita na cache — / 1K tokens Entrada · Escrita na cache, 1 hora — / 1K tokens |
| ConfiguraçãoUltra | Tabela de tarifas— | Unidade de faturaçãopor unidade de pesquisa | Custo total · unidade de pesquisa $0.002 por unidade de pesquisa |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
Exemplos de pedidos
Ailoot Ultra · Reordenação
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "cohere/rerank-v3.5",
"query": "What is the capital of France?",
"top_n": 3
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='cohere/rerank-v3.5'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
Receber e guardar os resultados
Ailoot Ultra · Reordenação
json
Guardar todos os resultados concluídos
Guarde cada resposta, ficheiro e parte de conteúdo devolvidos na íntegra.
São conservados todos os índices reais dos resultados, os valores finitos de relevance_score e os objetos de documento originais. Os índices correspondem à matriz original de documentos. O JSON original completo é armazenado e devolvido apenas após a liquidação.
Se for necessário verificar a resposta original
Conserve a operação original e a resposta completa/parcial; não repita o POST.
Campos da resposta
| Campo | Tipo |
|---|---|
Campomodel | Tipostring |
Campoid | Tipostring |
Campoprovider | Tipostring |
Camporesults[].index | Tipointeger |
Camporesults[].relevance_score | Tiponumber |
Camporesults[].document.text | Tipostring |
Camporesults[].document.image | Tipostring |
Campousage.search_units | Tipointeger |
Campousage.total_tokens | Tipointeger |
Campousage.cost | Tiponumber |
Erros e passos seguintes
| Resposta | Condição | Passo seguinte |
|---|---|---|
Resposta400 · invalid_request_error | CondiçãoCampo obrigatório, representação ou valor inválido | Passo seguinteCorrija o campo indicado no pedido. |
Aliases
Aliases do modelo
Ailoot Ultra cohere/rerank-v3.5
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · Cohere: Rerank v3.5
- Que entradas e resultados estão disponíveis?
POST /v1/rerank·cohere/rerank-v3.5:text→rerank- Que campos utiliza o pedido?
POST /v1/rerank·cohere/rerank-v3.5:documents,model,provider,query,session_id,top_n,trace,user- Que limites se aplicam?
POST /v1/rerank·cohere/rerank-v3.5:top_n.minimum:1