Fonction search.score OData dans la Recherche Azure AI

Remarque

Recherche Azure AI est disponible via le portail Azure, les API REST et les SDK Azure. Il sous-tend également Foundry IQ, la couche de connaissances managée qui transforme le contenu d’entreprise en bases de connaissances réutilisables et prenant en charge les autorisations pour les agents dans le portail Microsoft Foundry.

Quand vous envoyez une requête à la Recherche Azure AI sans le paramètre $orderby, les résultats renvoyés sont triés par ordre décroissant du score de pertinence. Même quand vous utilisez $orderby, le score de pertinence sert à rompre les liens par défaut. Toutefois, il est parfois utile d’utiliser le score de pertinence comme critère de tri initial, et d’utiliser d’autres critères pour trancher. L’exemple de cet article illustre l’utilisation de la fonction search.score pour le tri.

Remarque

Le score de pertinence est calculé par l’algorithme de classement par pertinence, et la plage varie en fonction de l’algorithme que vous utilisez. Pour plus d’informations, consultez Pertinence et scoring dans la Recherche Azure AI.

Syntaxe

La syntaxe pour search.score dans $orderby est search.score(). La fonction search.score ne prend aucun paramètre. Pour les requêtes en texte intégral, vous pouvez l’utiliser avec le spécificateur asc ou desc d’ordre de tri, comme toute autre clause du paramètre $orderby. Il peut apparaître n’importe où dans la liste des critères de tri.

Exemple

Triez les hôtels dans l’ordre décroissant, search.scoreratingpuis dans l’ordre croissant par distance par rapport aux coordonnées données afin qu’entre deux hôtels avec des scores et des évaluations de pertinence identiques, le plus proche est répertorié en premier :

    search.score() desc,rating desc,geo.distance(location, geography'POINT(-122.131577 47.678581)') asc

Limitations

Vous ne pouvez pas utiliser search.score() dans $orderby pour les requêtes vectorielles ou hybrides pures. Le service rejette ces requêtes avec une erreur HTTP 400 InvalidRequestParameter . Pour corriger la demande, supprimez search.score() de $orderby.

Étapes suivantes