Qwen: Qwen3 Rerank

Qwen3 Rerank evalúa textos candidatos según una consulta y una instrucción de ordenación proporcionadas. El selector exacto configurado es qwen3-rerank. Su función es ordenar los candidatos proporcionados para tareas de recuperación y selección de documentos; la solicitud mantiene juntos la consulta, la instrucción y los pasajes candidatos para que la evaluación de relevancia pueda vincularse a sus entradas.

Prepara documents como un array de cadenas, con un pasaje candidato en cada entrada. Mantén una correspondencia independiente entre cada posición del array y tu propio identificador de documento, título o ubicación de origen. Esto permite a la aplicación volver a relacionar un resultado ordenado con el pasaje original sin añadir objetos identificadores no documentados al array de cadenas. Para una búsqueda de asistencia, los candidatos podrían ser las secciones pertinentes ya recuperadas de una guía de producto; la consulta debe indicar la necesidad real de información del usuario.

La solicitud documentada requiere model, documents, query, top_n e instruct. Los campos query e instruct son cadenas y top_n es un entero que debe proporcionarse explícitamente. El ejemplo publicado utiliza tres textos candidatos, top_n=2 y una instrucción para recuperar pasajes pertinentes que respondan a una consulta de búsqueda web. Utiliza instruct para indicar la relación que importa para la ordenación, manteniendo la pregunta real en query y el material que debe evaluarse en documents.

La guía de la operación indica una longitud máxima de entrada de 30K. Limita los pasajes candidatos al texto necesario para evaluar su relevancia y conserva los títulos o el contexto cercano cuando cambien el significado. Preserva los límites de las fuentes para que un pasaje seleccionado pueda comprobarse en su documento original. El perfil exacto de la solicitud y sus campos obligatorios siguen siendo la base para preparar la entrada.

El resultado estructurado devuelto contiene entradas results con index y relevance_score. El valor index se refiere a la posición del candidato en el array documents original, no a su posición en la lista de resultados ordenados. Conserva el orden devuelto y utiliza cada index para recuperar el texto de entrada correspondiente. Guarda todos los resultados devueltos para que la aplicación pueda examinar juntos los candidatos seleccionados y sus puntuaciones.

Conserva la respuesta JSON completa, incluidos model, el id de respuesta y usage.total_tokens. El texto del documento devuelto puede estar ausente, por lo que debes mantener disponible el array original de candidatos al procesar los índices. Las puntuaciones de relevancia y el uso comunicado tienen funciones distintas: las puntuaciones describen el resultado de la ordenación, mientras que el uso registra la cantidad comunicada para la operación. Ninguno sustituye al pasaje fuente que respalda una respuesta posterior.

Para un flujo de recuperación, utiliza la ordenación para seleccionar los pasajes que el siguiente paso debe examinar o citar. Compara un pasaje seleccionado con la consulta y la instrucción antes de presentar su contenido como prueba. Una posición alta en una lista de resultados identifica un candidato para revisión; la respuesta final de la aplicación debe seguir vinculada al texto real y a su identificador de origen.

Revisa el resultado con consultas representativas y los conjuntos de candidatos utilizados por la aplicación. Comprueba que los índices correspondan a los textos originales previstos, que la ordenación responda a la instrucción proporcionada y que los pasajes elegidos aborden la pregunta. Conserva juntos el selector exacto, la consulta, la instrucción, la correspondencia de candidatos y la respuesta completa para producir un registro reutilizable de selección por relevancia para el siguiente paso de recuperación o de trabajo con documentos.