Source: https://ailoot.ai/models/es-mx/voyageai-rerank-3/ Canonical: https://ailoot.ai/models/es-mx/voyageai-rerank-3/ Language: es-mx # VoyageAI by MongoDB: rerank-3 [Markdown](https://ailoot.ai/models/es-mx/voyageai-rerank-3/index.md) · [JSON](https://ailoot.ai/models/es-mx/voyageai-rerank-3/facts.json) ## [VoyageAI by MongoDB: rerank-3](https://ailoot.ai/models/es-mx/voyageai-rerank-3/) Voyage rerank-3 es la edición Rerank 3 centrada en calidad para puntuar la relevancia entre consulta y documento. Reordena candidatos de texto recuperados, admite instrucciones de relevancia en lenguaje natural y maneja pares de 32,000 tokens para búsquedas en documentos largos, código y bases de conocimiento. - [**Ailoot Ultra · Reordenación por relevancia** `POST /v1/rerank` `voyageai/rerank-3`](https://ailoot.ai/models/es-mx/voyageai-rerank-3/#method-0) Sobre el modelo Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado. Voyage rerank-3 es un reclasificador de texto diseñado para mejorar la calidad de la evidencia recuperada. Dada una consulta y una lista de documentos candidatos, examina conjuntamente cada par y devuelve los candidatos ordenados por relevancia. Los embeddings y la búsqueda por palabras clave pueden reducir primero una colección grande a una lista corta manejable; después rerank-3 aplica una evaluación de relevancia más detallada a esa lista. Su salida es evidencia de búsqueda puntuada para que una aplicación la muestre o la pase a un paso separado de generación de respuestas. Rerank 3 centrado en calidad El fabricante posiciona rerank-3 como la edición centrada en precisión y rerank-3-lite como la edición para búsqueda sensible a la latencia. La tercera generación actualiza la estructura principal y la mezcla de entrenamiento, con mejoras particulares en recuperación de documentos largos y código fuente frente a los predecesores 2.5 correspondientes. El productor lo evalúa en documentación técnica, código, material multilingüe y otros ámbitos documentales. Esos resultados respaldan su papel en recuperación; selecciona la edición usando las preguntas y los documentos candidatos que importan en tu propia colección. Documentos largos con suficiente contexto Un candidato largo puede contener contexto útil mucho más allá de su primer párrafo. Proporciona una sección o documento coherente con su título y el material circundante pertinente para que el modelo evalúe cómo se relaciona la pregunta real con el contenido. Para una búsqueda de políticas de producto, conserva los encabezados y las excepciones alrededor del pasaje de interés. Si varias secciones recuperadas vienen de la misma fuente, conserva sus identificadores de documento y sección; así la aplicación puede mostrar de dónde provino la evidencia seleccionada. La ventana de contexto se comparte entre la consulta y cada candidato. La guía actual del fabricante especifica 32,000 tokens para ese par, incluida una consulta de como máximo 8,000 tokens. Por lo tanto, una consulta de 3,000 tokens deja como máximo 29,000 tokens para cada documento. Prepara la entrada para que su contenido esencial quepa, en especial cuando un preámbulo largo o texto de plantilla repetido consumiría la ventana. La opción documentada de truncamiento está habilitada por defecto y puede acortar una consulta o un documento demasiado largos antes de puntuarlos. Inspecciona lo que se conserva cuando importa la ubicación del pasaje. Recuperación de código y material técnico Para la etapa de recuperación de un asistente de programación, los candidatos pueden contener implementaciones de funciones, documentación de API o explicaciones técnicas como texto. Incluye los símbolos, las firmas y el contexto necesarios para distinguir candidatos similares. Una consulta como «Encuentra la función que normaliza rutas conservando un separador al final» aporta un comportamiento concreto que se debe encontrar. Agrega las restricciones pertinentes de lenguaje, plataforma o versión. Después de clasificar, examina el código seleccionado y sus dependencias antes de usarlo como contexto; una puntuación de relevancia no demuestra que una implementación cumpla todos los requisitos indicados. Las instrucciones definen la relevancia El modelo conserva la capacidad de reclasificación con seguimiento de instrucciones introducida en Rerank 2.5. Agrega una instrucción breve antes o después de la consulta cuando la intención del usuario necesite aclararse. Para búsqueda de documentos de investigación, explica si el foco es el título, un método particular o un ámbito de aplicación. Para un catálogo interno, especifica si la solicitud trata instalación, solución de problemas o compatibilidad. Mantén esa instrucción alineada con la pregunta; las preferencias adicionales que entren en conflicto con la solicitud principal pueden cambiar lo que intenta optimizar la clasificación. Prepara documentos candidatos y presupuestos La entrada es una lista de cadenas de texto. Extrae texto utilizable de los documentos de origen, conserva los límites significativos entre secciones y mantén un mapeo ordenado de registros junto con la lista. El fabricante permite hasta 1,000 documentos en una solicitud. También especifica un límite agregado de entrada de 600,000 tokens: tokens de consulta multiplicados por el número de documentos, más la suma de todos los tokens de documentos. Esto difiere del límite de contexto por par. Reducir el texto redundante de la consulta puede conservar tanto la capacidad del par como el presupuesto general de la solicitud. Cuenta los tokens del modelo pertinente en lugar de suponer que una cantidad de palabras o caracteres equivale a una cantidad de tokens. Para candidatos grandes, selecciona pasajes coherentes o divide el material según encabezados útiles, conservando la información de la fuente principal. La reclasificación es más útil después de que la primera búsqueda ya haya encontrado candidatos plausibles: no puede clasificar una fuente faltante que nunca entró en la lista. Resultados clasificados y uso posterior El resultado contiene puntuaciones de relevancia e índices que se refieren a los documentos originales de entrada, ordenados por relevancia descendente. La opción top\_k limita la cantidad de resultados clasificados devueltos; de lo contrario, se devuelven todos los candidatos de entrada. La interfaz REST del fabricante también permite incluir el texto del documento. Usa cada índice original para recuperar el título, el identificador de fuente y los metadatos que necesite tu aplicación; después presenta los elementos seleccionados o incorpora el texto pertinente al contexto de evidencia de una respuesta. Inspecciona los primeros resultados contra la pregunta y mantén visible la identidad de la fuente. Una clasificación relativa alta no verifica la exactitud factual de un documento, y una lista corta que contenga solo candidatos malos seguirá teniendo un primer elemento. Separa la selección por relevancia de la decisión sobre si la evidencia seleccionada basta para responder al usuario. Migración de edición El fabricante describe rerank-3 como un sucesor de rerank-2.5 que se puede sustituir directamente, con la misma semántica de API y puntuaciones calibradas con la distribución de su predecesor correspondiente. Esa compatibilidad permite conservar una etapa de recuperación y un mapeo de registros existentes. Compara órdenes de resultados significativos y cualquier umbral de puntuación en el corpus actual antes de confiar en la migración. Mantén rerank-3 y rerank-3-lite como opciones distintas: los límites compartidos y el seguimiento de instrucciones no hacen idénticas sus prioridades de calidad y latencia. **Ailoot Ultra · Reordenación por relevancia** `POST /v1/rerank` `voyageai/rerank-3` [`voyageai/rerank-3`](https://ailoot.ai/models/es-mx/#m=voyageai%2Frerank-3&route=Ultra&caller=voyageai%2Frerank-3&fmt=rerank) VoyageAI by MongoDB /`voyageai/rerank-3` ### Inicio Voyage rerank-3 es la edición Rerank 3 centrada en calidad para puntuar la relevancia entre consulta y documento. Reordena candidatos de texto recuperados, admite instrucciones de relevancia en lenguaje natural y maneja pares de 32,000 tokens para búsquedas en documentos largos, código y bases de conocimiento. Entradas aceptadas Texto Resultados Resultados ordenados por relevancia ### Disponible en Ailoot · entradas y métodos **Ailoot Ultra · Reordenación por relevancia** `POST /v1/rerank` Entrada `text` Salida `rerank` Formato de salida json | Campo | Tipo | Requisito | Valores y límites | Predeterminado | | --- | --- | --- | --- | --- | | Campo`documents` | Tipo`array` | RequisitoObligatorio | Valores y límites | Predeterminado— | | Campo`model` | Tipo`string` | RequisitoObligatorio | Valores y límites voyageai/rerank-3 | Predeterminado— | | Campo`provider` | Tipo`schema` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`query` | Tipo`string` | RequisitoObligatorio | Valores y límites | Predeterminado— | | Campo`session_id` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`top_n` | Tipo`integer` | RequisitoOpcional | Valores y límites Mínimo: 1 | Predeterminado— | | Campo`trace` | Tipo`schema` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`user` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`documents[].text` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`documents[].image` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— | Combinaciones de materiales de entrada **text\_rerank** · Obligatorio: query, documents array with minItems1 Parámetros del método y ciclo de vida | 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` Envía el ID exacto del modelo y conserva la respuesta nativa completa. ### Tarifas Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado. Modo fast Sin especificar Cuando se selecciona el modo fast Modo flex Sin especificar Cuando se selecciona el modo flex Esfuerzo máximo de razonamiento Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste default #### Tarifas de Ailoot #### Precios por configuración Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas. | Configuración | Tabla de tarifas | Unidad de facturación | Cargo | | --- | --- | --- | --- | | ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Unidad de facturación— | Cargo Entrada · Tokens de entrada **—** / 1K tokens Salida · Tokens de salida **—** / 1K tokens Entrada · Lectura de caché **—** / 1K tokens Entrada · Escritura en caché **—** / 1K tokens Entrada · Escritura en caché, 1 hora **—** / 1K tokens | | ConfiguraciónUltra | Tabla de tarifas— | Unidad de facturación/ 1K tokens | Cargo Entrada **$0.0001** / 1K tokens | Ailoot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. [Cómo funcionan la reserva y la liquidación →](https://ailoot.ai/docs/es-mx/billing/reserve/) ### Solicitudes de ejemplo #### Ailoot Ultra · Reordenación por relevancia Estructura oficial de solicitud conservada; ejemplo de documentaciónUsa el material real de tu solicitud y conserva el resultado completo ```json { "documents": [ "Paris is the capital of France.", "Berlin is the capital of Germany." ], "model": "voyageai/rerank-3", "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' 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 ``` ### Recibir y guardar resultados #### Ailoot Ultra · Reordenación por relevancia json ##### Conserva todos los resultados completados Conserva todas las respuestas, archivos y partes de contenido completos recibidos. Se conservan todos los índices reales del resultado, cada relevance\_score finito y el objeto del documento original. Los índices vinculan el arreglo original de documentos. El JSON original completo se almacena y devuelve únicamente después de liquidar el cargo. ##### Si es necesario revisar la respuesta original Conserva la operación original y la respuesta completa o parcial; no repitas el POST. Campos de respuesta | 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 | Errores y siguientes pasos | Respuesta | Condición | Siguiente paso | | --- | --- | --- | | Respuesta400 · `invalid_request_error` | CondiciónCampo obligatorio, representación o valor no válido | Siguiente pasoCorrige el campo indicado de la solicitud. | ### Alias #### Alias del modelo **Ailoot Ultra** [`voyageai/rerank-3`](https://ailoot.ai/models/es-mx/#m=voyageai%2Frerank-3&route=Ultra&caller=voyageai%2Frerank-3&fmt=rerank) #### Alias de rutas de métodos Usa las rutas de método indicadas arriba. #### ID de modelo relacionados [`voyageai/rerank-3`](https://ailoot.ai/models/es-mx/#m=voyageai%2Frerank-3&route=Ultra&caller=voyageai%2Frerank-3&fmt=rerank) FAQ · VoyageAI by MongoDB: rerank-3 ¿Qué entradas y resultados están disponibles? `POST /v1/rerank` · `voyageai/rerank-3`: `text` → `rerank` ¿Qué campos utiliza la solicitud? `POST /v1/rerank` · `voyageai/rerank-3`: `documents`, `model`, `provider`, `query`, `session_id`, `top_n`, `trace`, `user` ¿Qué límites se aplican? `POST /v1/rerank` · `voyageai/rerank-3`: `top_n.minimum`: `1` Conecta Ailoot a Claude Code, OpenCode, Hermes o tu aplicación. ## La empresa y su cartera de proyectos La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. ## Compra tokens con descuento. Ahorro por suscripción para trabajo habitual. Códigos promocionales: hasta el 50% al comprar tokens. Suscripción Elige un plan con descuento para tus peticiones habituales. Código de hasta el 50% Introduce el código al comprar. El precio se recalcula según la promoción vigente. Gasto en el historial Modelo, tokens e importe quedan guardados por cada petición. [Elegir suscripción](https://ailoot.ai/docs/es-mx/billing/subscriptions/) · [Consultar precios de modelos](https://ailoot.ai/models/es-mx/) ## Conecta la API al producto que vendes. SaaS, aplicaciones y bots bajo la oferta y el acuerdo de licencia Ailoot. Solicita una licencia de reventa para redistribuir el acceso. Aplicación comercial Integra generación de texto, imágenes, vídeo y sonido en funciones de pago de tu servicio. Licencia para revendedores Envía descripción del proyecto y esquema de acceso. Solicita condiciones escritas de uso y reventa. Documentos en la web La oferta, el acuerdo de licencia y la política de datos están disponibles antes de conectar. [Solicitar licencia de reventa](mailto:support@ailoot.ai) · [Oferta y acuerdo de licencia](https://ailoot.ai/legal/offer?lang=es-mx) ## Ailoot · La empresa y su cartera de proyectos Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI. La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.