Uso de perfiles de puntuación con clasificador semántico en Búsqueda de Azure AI

Puede aplicar un perfil de puntuación sobre los resultados de búsqueda clasificados semánticamente, donde el perfil de puntuación se procesa por última vez.

Para asegurarse de que el perfil de puntuación proporciona la puntuación de determinación, el clasificador semántico agrega un campo de respuesta, @search.rerankerBoostedScore, que aplica la lógica del perfil de puntuación en los resultados clasificados semánticamente. En los resultados de búsqueda que incluyen @search.score de la clasificación de nivel 1, @search.rerankerScore desde el clasificador semántico y @search.rerankerBoostedScore, los resultados se ordenan por @search.rerankerBoostedScore.

Requisitos previos

• Búsqueda de Azure AI en cualquier región que proporcione la clasificación semántica.

• Índice de búsqueda con una configuración semántica que especifica "rankingOrder": "boostedRerankerScore" y un perfil de puntuación que especifica funciones.

Limitaciones

La optimización de los resultados clasificados semánticamente solo se aplica a las funciones de perfil de puntuación. No hay ningún aumento si el perfil de puntuación consta solo de campos de texto ponderados.

Este comportamiento se aplica a las consultas semánticas que se envían directamente a un índice, como /docs/search. La recuperación mediante agente no aplica los perfiles de puntuación del índice, incluidos los defaultScoringProfile del índice subyacente, y las respuestas de recuperación no aparecen @search.rerankerBoostedScore. Para obtener más información, consulte Creación de un origen de conocimiento de índice de búsqueda y Consulta de una base de conocimiento.

¿Cómo funciona la configuración semántica con perfiles de puntuación?

Al ejecutar una consulta semántica asociada a un perfil de puntuación, se genera una tercera puntuación de búsqueda, @search.rerankerBoostedScore valor, para cada documento de los resultados de búsqueda. Esta puntuación mejorada, calculada aplicando el perfil de puntuación a la puntuación del reranker existente, no tiene un intervalo garantizado (0-4) como una puntuación normal del reranker y las puntuaciones pueden ser significativamente mayores que 4.

Los resultados semánticos se ordenan de @search.rerankerBoostedScore forma predeterminada si existe un perfil de puntuación. Si no se especifica la rankingOrder propiedad , es BoostedRerankerScore el valor predeterminado en la configuración semántica.

En este escenario, se usa un perfil de puntuación dos veces.

1. En primer lugar, el perfil de puntuación definido en su índice se utiliza durante la fase inicial de clasificación L1, lo que optimiza los resultados de:

   • Consultas basadas en texto (BM25 o RRF)
   • La parte de texto de las consultas vectoriales
   • Consultas híbridas que combinan ambos tipos

2. A continuación, el clasificador semántico vuelve a puntuar los 50 resultados principales, lo que promueve coincidencias más semánticamente relevantes en la parte superior. Este paso puede borrar la ventaja del perfil de puntuación. Por ejemplo, si ha aplicado un impulso basado en la actualización (freshness), entonces la reordenación semántica sustituye ese impulso con su propia lógica sobre lo que es más relevante.

3. Por último, el perfil de puntuación se vuelve a aplicar, después de la reordenación, lo que restaura la influencia de los aumentos en el orden final de los resultados. Si realiza un impulso por actualización (freshness), los resultados clasificados semánticamente se vuelven a puntuar en función de la actualización (freshness).

Habilitación de perfiles de puntuación en la configuración semántica

Para habilitar los perfiles de puntuación para los resultados clasificados semánticamente, actualice un índice estableciendo la rankingOrder propiedad de su configuración semántica. Use el método PUT para actualizar el índice con las revisiones. No se requiere ninguna recompilación de índices.

PUT https://{service-name}.search.windows.com/indexes/{index-name}?api-version=2026-04-01
{
  "semantic": {
    "configurations": [
      {
        "name": "mySemanticConfig",
        "rankingOrder": "boostedRerankerScore"
      }
    ]
  }
}

Deshabilitación de perfiles de puntuación en la configuración semántica

Para cancelar la ordenación por puntuación aumentada del reclasificador semántico, establezca el campo rankingOrder en el valor reRankerScore en la configuración semántica.

PUT /indexes/{index-name}?api-version=2026-04-01
{
  "semantic": {
    "configurations": [
      {
        "name": "mySemanticConfig",
        "rankingOrder": "reRankerScore"
      }
    ]
  }
}

Incluso si opta por no ordenar por @search.rerankerBoostedScore, el boostedRerankerScore campo todavía se genera en la respuesta, pero ya no se usa para ordenar los resultados.

Consulta y respuesta de ejemplo

Comience con una consulta semántica que especifique un perfil de puntuación. Esta consulta se dirige a un índice de búsqueda que tiene rankingOrder configurado en boostedRerankerScore.

POST /indexes/{index-name}/docs/search?api-version=2026-04-01
{
  "search": "my query to be boosted",
  "scoringProfile": "myScoringProfile",
  "queryType": "semantic"
}

La respuesta incluye el nuevo rerankerBoostedScore, junto con el L1 @search.score y el L2 @search.rerankerScore. Los resultados se ordenan mediante @search.rerankerBoostedScore.

{
  "value": [
    {
      "@search.score": 0.63,
      "@search.rerankerScore": 2.98,
      "@search.rerankerBoostedScore": 7.68,
      "content": "boosted content 2"
    },
    {
      "@search.score": 1.12,
      "@search.rerankerScore": 3.12,
      "@search.rerankerBoostedScore": 5.61,
      "content": "boosted content 1"
    }
  ]
}