Source: https://ailoot.ai/models/pt-pt/voyageai-rerank-3-lite/ Canonical: https://ailoot.ai/models/pt-pt/voyageai-rerank-3-lite/ Language: pt-pt # VoyageAI by MongoDB: rerank-3-lite [Markdown](https://ailoot.ai/models/pt-pt/voyageai-rerank-3-lite/index.md) · [JSON](https://ailoot.ai/models/pt-pt/voyageai-rerank-3-lite/facts.json) ## [VoyageAI by MongoDB: rerank-3-lite](https://ailoot.ai/models/pt-pt/voyageai-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. - [**Ailoot Ultra · Reordenação** `POST /v1/rerank` `voyageai/rerank-3-lite`](https://ailoot.ai/models/pt-pt/voyageai-rerank-3-lite/#method-0) 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-lite`](https://ailoot.ai/models/pt-pt/#m=voyageai%2Frerank-3-lite&route=Ultra&caller=voyageai%2Frerank-3-lite&fmt=rerank) VoyageAI by MongoDB /`voyageai/rerank-3-lite` ### Introduçã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 | | --- | --- | --- | --- | --- | | Campo`documents` | Tipo`array` | RequisitoObrigatório | Valores e limites | Predefinição— | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites voyageai/rerank-3-lite | Predefinição— | | Campo`provider` | Tipo`schema` | RequisitoOpcional | Valores e limites | Predefinição— | | Campo`query` | Tipo`string` | RequisitoObrigatório | Valores e limites | Predefinição— | | Campo`session_id` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— | | Campo`top_n` | Tipo`integer` | RequisitoOpcional | Valores e limites Mínimo: 1 | Predefinição— | | Campo`trace` | Tipo`schema` | RequisitoOpcional | Valores e limites | Predefinição— | | Campo`user` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— | | Campo`documents[].text` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— | | Campo`documents[].image` | Tipo`string` | 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âmetro`content_type` | Contratoapplication/json | | Parâmetro`required` | Contratomodel, query, documents | | Parâmetro`material_types` | Contratotext | | Parâmetro`optional_controls` | Contratoprovider, session\_id, top\_n, trace, user | | Parâmetro`multimodal_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 →](https://ailoot.ai/docs/pt-pt/billing/reserve/) ### Exemplos de pedidos #### Ailoot Ultra · Reordenação Estrutura oficial do pedido preservada; exemplo de documentaçãoUse o material real do seu pedido e guarde o resultado completo ```json { "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 } ``` ```bash 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 | | --- | --- | | Campo`model` | Tipostring | | Campo`id` | Tipostring | | Campo`provider` | Tipostring | | Campo`results[].index` | Tipointeger | | Campo`results[].relevance_score` | Tiponumber | | Campo`results[].document.text` | Tipostring | | Campo`results[].document.image` | Tipostring | | Campo`usage.search_units` | Tipointeger | | Campo`usage.total_tokens` | Tipointeger | | Campo`usage.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`](https://ailoot.ai/models/pt-pt/#m=voyageai%2Frerank-3-lite&route=Ultra&caller=voyageai%2Frerank-3-lite&fmt=rerank) #### Aliases dos caminhos dos métodos Use os caminhos dos métodos indicados acima. #### IDs de chamada relacionados [`voyageai/rerank-3-lite`](https://ailoot.ai/models/pt-pt/#m=voyageai%2Frerank-3-lite&route=Ultra&caller=voyageai%2Frerank-3-lite&fmt=rerank) 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` Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação. ## A empresa e a sua carteira de projetos A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. ## Compre tokens com desconto. Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens. Subscrição Escolha um plano com desconto para os pedidos regulares. Código promocional até 50% Introduza o código na compra. O preço é recalculado conforme a campanha em vigor. Custos no histórico O modelo, os tokens e o montante são guardados para cada pedido. [Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/) ## Ligue a API ao produto que vende. SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor. Aplicação comercial Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço. Licença de revendedor Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda. Documentos no site A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação. [Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt) ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.