VoyageAI by MongoDB: rerank-3-lite
O Voyage rerank-3-lite pontua e reordena documentos de texto candidatos para uma consulta, com foco em pesquisa rápida. Suporta instruções de relevância e uma janela de 32 000 tokens por par consulta-documento, sendo útil após recuperação vetorial ou por palavras-chave em fluxos de pesquisa e RAG.
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 Voyage rerank-3-lite é a edição centrada na latência da série Rerank 3 da Voyage. Recebe uma consulta de texto e documentos candidatos, avalia em conjunto cada par consulta-documento e devolve pontuações de relevância por ordem de classificação. Serve a segunda etapa da pesquisa: um mecanismo de recuperação por embeddings ou palavras-chave encontra os candidatos, e Lite aperfeiçoa a sua ordem. O resultado é uma classificação para usar em pesquisa ou num fluxo de geração aumentada por recuperação.
O que muda no Rerank 3 Lite O produtor salienta uma recuperação mais forte em documentos longos e código face ao rerank-2.5-lite. Ambas as edições Rerank 3 conservam o cumprimento de instruções e a mesma classe de contexto de 32K, enquanto Lite foi concebido para aplicações sensíveis à latência. Isto torna-o um candidato prático para pesquisa interativa em bases de conhecimento, recuperação de documentos de apoio e consulta de código quando os utilizadores precisam de resultados relevantes rapidamente. Escolha-o de acordo com os requisitos de qualidade e tempo de resposta da coleção real, em vez de assumir que uma edição menor implica uma janela de contexto menor.
Oriente a relevância com a consulta Instruções em linguagem natural podem acompanhar a consulta para explicar o que conta como relevante. Mantenha a pergunta e a preferência de relevância concisas e coerentes. Para pesquisa de apoio de software, use «Encontre o procedimento para repor um dispositivo; dê prioridade às instruções para a revisão de hardware indicada.» Para um nome de produto ambíguo, inclua a categoria do produto para evitar o predomínio de significados sem relação. Uma preferência na consulta orienta a pontuação semântica; utilize metadados explícitos da coleção para selecionar o produto, a versão documental ou o âmbito de acesso corretos antes de construir a lista de candidatos.
Prepare uma lista restrita de candidatos de texto Os documentos de entrada são cadeias de texto. Extraia texto legível do material de origem e conserve títulos, cabeçalhos, identificadores e contexto envolvente úteis. Mantenha uma correspondência estável entre cada posição de entrada e o registo original. Para um artigo de resolução de problemas, inclua o sintoma e o procedimento relevante, não apenas uma frase isolada. Para pesquisa de código-fonte, inclua a função e a informação próxima necessária para a distinguir de funções com nomes semelhantes. Elimine navegação repetitiva ou texto padronizado quando ocupa o espaço da passagem útil.
O reordenador só pode reordenar os documentos que recebe. Se a primeira pesquisa nunca recuperar o artigo relevante, esta etapa não consegue recuperar esse candidato em falta. Inspecione tanto a lista restrita como a ordem final quando um resultado parecer errado. Quando um documento longo cobre muitos temas, separe secções coerentes e conserve as referências ao documento principal, para permitir selecionar uma secção relevante sem perder a sua fonte.
Contexto e limites de pedido O guia atual do fabricante especifica um máximo de consulta de 8 000 tokens e um máximo combinado de 32 000 tokens para a consulta mais cada documento individual. Permite até 1 000 documentos candidatos e um orçamento total de pedido de 600 000 tokens, calculado como tokens da consulta multiplicados pelo número de documentos, mais todos os tokens dos documentos. Uma consulta longa consome, por isso, espaço em cada par e contribui repetidamente para o orçamento agregado. Conte o texto submetido com o tokenizador adequado ao modelo, em vez de tratar caracteres, palavras e tokens como intercambiáveis.
Por exemplo, uma consulta de 500 tokens com 100 documentos de 4 000 tokens cada corresponde a 450 000 tokens de entrada segundo essa fórmula. Isto ilustra a gestão do orçamento, não uma dimensão recomendada da lista restrita nem um resultado medido de velocidade. A opção documentada de truncagem está ativada por predefinição; texto demasiado grande pode ser encurtado antes da pontuação. Prepare deliberadamente as secções importantes para que a truncagem não elimine precisamente a passagem de que precisa para a correspondência.
Leia e utilize o resultado Os resultados são ordenados da maior pontuação de relevância para a menor. Cada resultado identifica a posição original de entrada do documento, permitindo à aplicação associar o seu próprio título, identificador de registo e fonte. A definição top_k controla quantos candidatos classificados são devolvidos; sem ela, são devolvidos todos os candidatos. A interface REST do fabricante também pode devolver o texto do documento. Conserve os identificadores originais junto dos resultados selecionados ao apresentar uma página de pesquisa ou passar elementos de apoio a uma etapa de geração de resposta.
Uma pontuação de relevância exprime até que ponto um candidato corresponde à consulta; não estabelece que as suas afirmações são corretas. Compare os itens mais bem classificados com a pergunta real do utilizador, incluindo exclusões e diferenças de versão documental. Se todos os candidatos forem irrelevantes, continua a existir um item em primeiro lugar. Decida como a aplicação trata esse caso usando consultas representativas da coleção.
Atualização e escolha da edição O fabricante descreve o rerank-3-lite como uma atualização do rerank-2.5-lite com semântica da API inalterada e pontuações calibradas para a distribuição do antecessor correspondente. Preserve a correspondência de registos e a etapa de recuperação existentes e compare a ordem resultante em consultas significativas antes de confiar num limiar de pontuação estabelecido. Utilize Lite numa experiência de pesquisa em que o tempo de resposta importa; utilize a edição rerank-3 centrada na qualidade como comparação quando a relevância em candidatos difíceis é a prioridade maior.
Ailoot Ultra · Reordenação POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteIntrodução
O Voyage rerank-3-lite pontua e reordena documentos de texto candidatos para uma consulta, com foco em pesquisa rápida. Suporta instruções de relevância e uma janela de 32 000 tokens por par consulta-documento, sendo útil após recuperação vetorial ou por palavras-chave em fluxos de pesquisa e RAG.
- 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-3-lite | 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.00004 / 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-3-lite",
"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-3-lite'
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-3-lite
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · VoyageAI by MongoDB: rerank-3-lite
- Que entradas e resultados estão disponíveis?
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- Que campos utiliza o pedido?
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- Que limites se aplicam?
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1