Source: https://ailoot.ai/models/pt-pt/voyageai-rerank-2-5/ Canonical: https://ailoot.ai/models/pt-pt/voyageai-rerank-2-5/ Language: pt-pt # VoyageAI by MongoDB: rerank-2.5 [Markdown](https://ailoot.ai/models/pt-pt/voyageai-rerank-2-5/index.md) · [JSON](https://ailoot.ai/models/pt-pt/voyageai-rerank-2-5/facts.json) ## [VoyageAI by MongoDB: rerank-2.5](https://ailoot.ai/models/pt-pt/voyageai-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. - [**Ailoot Ultra · Reordenação** `POST /v1/rerank` `voyageai/rerank-2.5`](https://ailoot.ai/models/pt-pt/voyageai-rerank-2-5/#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 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.5`](https://ailoot.ai/models/pt-pt/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) VoyageAI by MongoDB /`voyageai/rerank-2.5` ### Introduçã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 | | --- | --- | --- | --- | --- | | Campo`documents` | Tipo`array` | RequisitoObrigatório | Valores e limites | Predefinição— | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites voyageai/rerank-2.5 | 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.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 →](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-2.5", "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-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 | | --- | --- | | 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-2.5`](https://ailoot.ai/models/pt-pt/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) #### Aliases dos caminhos dos métodos Use os caminhos dos métodos indicados acima. #### IDs de chamada relacionados [`voyageai/rerank-2.5`](https://ailoot.ai/models/pt-pt/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) 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` 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.