Source: https://ailoot.ai/models/es/voyageai-rerank-3/ Canonical: https://ailoot.ai/models/es/voyageai-rerank-3/ Language: es # VoyageAI by MongoDB: rerank-3 [Markdown](https://ailoot.ai/models/es/voyageai-rerank-3/index.md) · [JSON](https://ailoot.ai/models/es/voyageai-rerank-3/facts.json) ## [VoyageAI by MongoDB: rerank-3](https://ailoot.ai/models/es/voyageai-rerank-3/) Voyage rerank-3 es la edición de Rerank 3 centrada en calidad para puntuar la relevancia entre consultas y documentos. Reordena candidatos de texto recuperados, admite instrucciones de relevancia en lenguaje natural y trabaja con pares de 32,000 tokens para buscar en documentos extensos, código y bases de conocimiento. - [**Ailoot Ultra · Reordenación por relevancia** `POST /v1/rerank` `voyageai/rerank-3`](https://ailoot.ai/models/es/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 las pruebas recuperadas. 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 manejable; rerank-3 aplica después una evaluación más detallada de la relevancia a esa lista. Su salida son pruebas de búsqueda puntuadas para que una aplicación las muestre o las pase a una etapa separada de generación de respuestas. Rerank 3 centrado en calidad El fabricante sitúa rerank-3 como la edición centrada en precisión y rerank-3-lite como la edición para búsquedas sensibles a la latencia. La tercera generación actualiza la arquitectura principal y la mezcla de entrenamiento, con mejoras particulares en recuperación de documentos extensos y código fuente frente a sus 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 función de recuperación; selecciona la edición utilizando las preguntas y los documentos candidatos que importan para tu propia colección. Documentos extensos con contexto suficiente Un candidato largo puede contener contexto útil mucho más allá del párrafo inicial. Proporciona una sección o un documento coherentes con su título y el material circundante pertinente para que el modelo pueda evaluar la relación de la pregunta real con el contenido. Para buscar políticas de producto, conserva los encabezados y las excepciones que rodean el pasaje de interés. Si varias secciones recuperadas proceden de la misma fuente, conserva sus identificadores de documento y sección; la aplicación podrá mostrar así de dónde proceden las pruebas seleccionadas. 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 tanto, una consulta de 3,000 tokens deja como máximo 29,000 tokens para cada documento. Prepara la entrada para que quepa su contenido esencial, especialmente cuando un preámbulo largo o texto genérico repetido consumirían la ventana. La opción documentada de truncamiento está activada por defecto y puede acortar el texto de consultas o documentos demasiado largos antes de puntuarlos. Examina qué se conserva cuando importe 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» proporciona un comportamiento concreto que buscar. Añade cualquier condición pertinente de lenguaje, plataforma o versión. Tras clasificar, examina el código seleccionado y sus dependencias antes de utilizarlo 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. Añade una instrucción concisa antes o después de la consulta cuando sea necesario aclarar la intención del usuario. Para buscar documentos de investigación, explica si el foco está en el título, un método concreto o un ámbito de aplicación. Para un catálogo interno, especifica si la petición se refiere a instalación, resolución de problemas o compatibilidad. Mantén esa instrucción alineada con la pregunta; las preferencias adicionales que entren en conflicto con la petición principal pueden cambiar lo que la clasificación intenta optimizar. Prepara los documentos candidatos y los presupuestos La entrada es una lista de cadenas de texto. Extrae texto utilizable de los documentos de origen, conserva límites de sección significativos y mantén un mapa ordenado de registros junto con la lista. El fabricante permite hasta 1,000 documentos en una petición. También especifica un máximo 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 los documentos. Esto difiere del límite de contexto por par. Reducir el texto redundante de la consulta puede preservar tanto la capacidad de cada par como el presupuesto total de petición. Cuenta los tokens del modelo pertinente en lugar de asumir que un recuento de palabras o caracteres es un recuento de tokens. Para candidatos grandes, selecciona pasajes coherentes o divide el material por 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 haya encontrado candidatos plausibles: no puede clasificar una fuente ausente que nunca entró en la lista. Resultados clasificados y uso posterior El resultado contiene puntuaciones de relevancia e índices que remiten a los documentos originales de entrada, ordenados por relevancia descendente. La opción top\_k limita el número de resultados clasificados devueltos; en caso contrario, se devuelven todos los candidatos de entrada. La interfaz REST del fabricante también permite incluir el texto del documento. Utiliza cada índice original para recuperar el título, el identificador de fuente y cualquier metadato que necesite tu aplicación, y después presenta los elementos seleccionados o reúne el texto pertinente en el contexto de pruebas de una respuesta. Examina los primeros resultados frente a la pregunta y mantén visible la identidad de las fuentes. Una posición relativa alta no verifica la exactitud factual de un documento, y una lista reducida que solo contenga candidatos deficientes seguirá teniendo un primer elemento. Separa la selección por relevancia de la decisión de si las pruebas seleccionadas bastan para responder al usuario. Migración de edición El fabricante describe rerank-3 como un sucesor de rerank-2.5 que puede sustituirlo directamente, con la misma semántica de API y puntuaciones calibradas según la distribución del predecesor correspondiente. Esa compatibilidad permite conservar una etapa de recuperación y una correspondencia de registros existentes. Compara órdenes de resultados significativos y cualquier umbral de puntuación sobre el corpus actual antes de confiar en la migración. Mantén rerank-3 y rerank-3-lite como opciones distintas: compartir límites y seguimiento de instrucciones no hace 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/#m=voyageai%2Frerank-3&route=Ultra&caller=voyageai%2Frerank-3&fmt=rerank) VoyageAI by MongoDB /`voyageai/rerank-3` ### Primeros pasos Voyage rerank-3 es la edición de Rerank 3 centrada en calidad para puntuar la relevancia entre consultas y documentos. Reordena candidatos de texto recuperados, admite instrucciones de relevancia en lenguaje natural y trabaja con pares de 32,000 tokens para buscar en documentos extensos, 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` Tipos de entrada `text` Tipos de 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. ### Planes Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado. Modo rápido Sin especificar Cuando se selecciona el modo rápido Modo flex Sin especificar Cuando se selecciona el modo flex Esfuerzo máximo de razonamiento Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (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 importe 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/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 conserva cada índice real de resultado, cada relevance\_score finito y cada objeto de documento original. Los índices vinculan la lista original de documentos. El JSON original completo se almacena y solo se devuelve tras la liquidación. ##### 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/#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/#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/billing/subscriptions/) · [Consultar precios de modelos](https://ailoot.ai/models/es/) ## 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) ## 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.