Utiliser des profils de scoring avec le ranker sémantique dans Recherche Azure AI

Vous pouvez appliquer un profil de scoring sur les résultats de recherche classés sémantiquement, où le profil de scoring est traité en dernier.

Pour garantir que le profil de scoring fournit le score déterminant, le ranker sémantique ajoute un champ de réponse, @search.rerankerBoostedScorequi applique la logique de profil de scoring sur les résultats classés sémantiquement. Dans les résultats de recherche qui incluent @search.score de classement de niveau 1, @search.rerankerScore de classement sémantique et @search.rerankerBoostedScore, les résultats sont triés par @search.rerankerBoostedScore.

Conditions préalables

• Recherche Azure AI dans n’importe quelle region qui fournit un classement sémantique.

• Index de recherche avec une configuration sémantique qui spécifie "rankingOrder": "boostedRerankerScore" et un profil de scoring qui spécifie des fonctions.

Limitations

L’amélioration des résultats classés sémantiquement s’applique uniquement aux fonctions de profil de scoring. Il n’y a aucun renforcement si le profil de scoring se compose uniquement de champs de texte pondérés.

Ce comportement s’applique aux requêtes sémantiques que vous envoyez directement à l’index, par exemple /docs/search. La récupération agentique n’applique pas les profils de score de l’index, y compris defaultScoringProfile sur l’index sous-jacent, et les réponses de récupération n’affichent pas @search.rerankerBoostedScore. Pour plus d’informations, consultez Créer une source de connaissances d’index de recherche et interroger une base de connaissances.

Comment fonctionne la configuration sémantique avec les profils de scoring ?

Lorsque vous exécutez une requête sémantique associée à un profil de scoring, un troisième score de recherche, @search.rerankerBoostedScore une valeur, est généré pour chaque document dans vos résultats de recherche. Ce score amélioré, calculé en appliquant le profil de scoring au score de reclassement existant, n’a pas de plage garantie (0 à 4) comme un score de reclassement normal, et les scores peuvent être nettement supérieurs à 4.

Les résultats sémantiques sont triés par @search.rerankerBoostedScore défaut si un profil de scoring existe. Si la rankingOrder propriété n’est pas spécifiée, BoostedRerankerScore il s’agit de la valeur par défaut dans la configuration sémantique.

Dans ce scénario, un profil de scoring est utilisé deux fois.

1. Tout d’abord, le profil de scoring défini dans votre index est utilisé pendant la phase de classement L1 initiale, ce qui améliore les résultats à partir de :

   • Requêtes textuelles (BM25 ou RRF)
   • Partie texte des requêtes vectorielles
   • Requêtes hybrides qui combinent les deux types

2. Ensuite, le classeur sémantique rescoure les 50 premiers résultats, en favorisant des correspondances plus pertinentes sur le plan sémantique vers le haut. Cette étape peut effacer l’avantage du profil de scoring. Par exemple, si vous avez optimisé en fonction de la fraîcheur, la réorganisation sémantique remplace cela par sa propre logique de pertinence.

3. Enfin, le profil de scoring est réappliqué après le reclassement, rétablissant l'influence des amplifications sur l'ordre final des résultats. Si vous optimisez selon l'actualité, les résultats classés sémantiquement sont rescorés en fonction de leur fraîcheur.

Activer les profils de scoring dans la configuration sémantique

Pour activer les profils de scoring pour les résultats classés sémantiquement, mettez à jour un index en définissant la rankingOrder propriété de sa configuration sémantique. Utilisez la méthode PUT pour mettre à jour l’index avec vos révisions. Aucune reconstruction d’index n’est requise.

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

Désactiver les profils de notation dans la configuration sémantique

Pour désactiver le tri par score optimisé de reclassement sémantique, définissez le champ rankingOrder sur la valeur reRankerScore dans la configuration sémantique.

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

Même si vous désactivez le tri par @search.rerankerBoostedScore, le boostedRerankerScore champ est toujours produit dans la réponse, mais il n’est plus utilisé pour trier les résultats.

Exemple de requête et de réponse

Commencez par une requête sémantique qui spécifie un profil de scoring. Cette requête cible un index de recherche ayant rankingOrder défini à boostedRerankerScore.

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

La réponse inclut le nouveau rerankerBoostedScore, en plus du L1 @search.score et du L2 @search.rerankerScore. Les résultats sont classés par @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"
    }
  ]
}