VoyageAI by MongoDB: rerank-2.5
O rerank-2.5 reordena um conjunto fornecido de candidatos de texto pela relevância para uma consulta e instruções opcionais em linguagem natural. É um reordenador multilingue orientado para a qualidade, com um contexto consulta–documento de 32 000 tokens e pontuações classificadas ligadas aos índices originais dos candidatos.
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.
O rerank-2.5 é o reordenador da Voyage AI com cumprimento de instruções, concebido para aperfeiçoar um conjunto de candidatos de pesquisa. Examina em conjunto a consulta e cada documento como codificador cruzado e devolve depois uma ordenação por relevância. O lançamento do fabricante salienta controlo em linguagem natural sobre o que conta como relevante, recuperação multilingue e um contexto consulta–documento maior do que o da edição rerank-2 anterior.
Dê ao modelo os candidatos a comparar
A entrada é uma consulta e uma lista de documentos de texto candidatos. Podem ser passagens selecionadas por pesquisa de embeddings ou por uma primeira pesquisa léxica. O reordenador avalia o texto fornecido em vez de criar embeddings do corpus, pelo que a sua função prática é aperfeiçoar os candidatos já encontrados pela pesquisa inicial.
Mantenha a ordem original dos candidatos e os identificadores das fontes ao preparar essa lista. Os índices devolvidos referem-se a essas posições de entrada. Para uma tarefa RAG, forneça as passagens que a etapa de resposta pode realmente utilizar, incluindo o título ou as condições necessárias à sua interpretação. Um documento relevante ausente do conjunto de candidatos submetido não pode aparecer como resultado recém-encontrado da reordenação.
Especifique a noção de relevância pretendida
As instruções podem ser acrescentadas antes ou depois da consulta. O lançamento descreve três funções úteis: destacar uma parte específica de um documento, preferir um tipo de fonte e desambiguar a consulta com contexto da aplicação. Estas alteram a tarefa de relevância apresentada ao modelo.
Para uma pesquisa técnica, uma instrução ilustrativa é «Dê prioridade a passagens que expliquem o comportamento de falha e recuperação; as apresentações introdutórias são secundárias.» Para uma coleção de investigação, especifique se o título, o método ou o resultado é mais importante. Para um termo ambíguo, indique a área temática da pesquisa. Mantenha a pergunta e a instrução compatíveis, para que uma não peça um tema amplo enquanto a outra altera silenciosamente a tarefa.
Estas preferências orientam a pontuação de relevância. Se a aplicação tiver requisitos rígidos de elegibilidade — como versão da fonte, data ou âmbito de acesso — prepare separadamente o conjunto de candidatos elegíveis. A instrução de relevância do modelo e uma restrição determinística da coleção servem finalidades diferentes.
Saída classificada e utilização posterior dos resultados
Os resultados são ordenados por relevância decrescente e incluem uma pontuação de relevância de vírgula flutuante e o índice original de entrada do candidato. A opção top-k seleciona quantos primeiros resultados devolver; sem ela, a especificação do fabricante devolve resultados para todos os candidatos submetidos. Uma definição opcional return-documents inclui o texto de origem correspondente; caso contrário, a resposta contém índices e pontuações.
Utilize a ordenação para selecionar passagens para apresentação ou para uma etapa posterior de resposta, mantendo intacta a sua identidade de origem. Inspecione o texto real ao avaliar a classificação: a pontuação mede a relevância para a consulta submetida, não é uma resposta gerada nem uma verificação de que as afirmações do documento são corretas. Isto torna o modelo útil para aperfeiçoar material de pesquisa técnico, jurídico, financeiro, médico, de conversação e multilingue, sem converter a classificação numa conclusão de domínio.
Contexto, orçamento total de tokens e truncagem
O limite documentado da consulta é 8 000 tokens, incluindo instruções colocadas na consulta. A consulta mais qualquer documento candidato individual têm de caber em 32 000 tokens, e a lista de documentos pode conter no máximo 1 000 itens. A atribuição total é de 600 000 tokens, contados como tokens da consulta multiplicados pelo número de documentos, mais todos os tokens dos documentos. Uma instrução longa é, por isso, contada repetidamente ao longo dos pares consulta–documento.
A contagem top-k de saída não altera o número de candidatos nesse cálculo de tokens de entrada. A truncagem predefinida encurta consultas ou documentos excessivos para cumprir o limite de contexto; desativá-la faz com que uma consulta ou par excessivo devolva um erro. Prepare deliberadamente passagens que contenham a resposta e mantenha a condição relevante dentro do texto que o modelo verá. Avalie a ordem aperfeiçoada em perguntas e instruções representativas e passe as passagens originais selecionadas à etapa seguinte.
Ailoot Ultra · Reordenação POST /v1/rerank voyageai/rerank-2.5
voyageai/rerank-2.5Introdução
O rerank-2.5 reordena um conjunto fornecido de candidatos de texto pela relevância para uma consulta e instruções opcionais em linguagem natural. É um reordenador multilingue orientado para a qualidade, com um contexto consulta–documento de 32 000 tokens e pontuações classificadas ligadas aos índices originais dos candidatos.
- 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 voyageai/rerank-2.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ção/ 1K tokens | Custo Entrada $0.0001 / 1K tokens |
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": "voyageai/rerank-2.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']='voyageai/rerank-2.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 voyageai/rerank-2.5
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · VoyageAI by MongoDB: rerank-2.5
- Que entradas e resultados estão disponíveis?
POST /v1/rerank·voyageai/rerank-2.5:text→rerank- Que campos utiliza o pedido?
POST /v1/rerank·voyageai/rerank-2.5:documents,model,provider,query,session_id,top_n,trace,user- Que limites se aplicam?
POST /v1/rerank·voyageai/rerank-2.5:top_n.minimum:1