OData-Funktion search.score in Azure KI-Suche

Hinweis

Azure KI-Suche ist über das Azure Portal, REST-APIs und Azure SDKs verfügbar. Es unterstützt auch Foundry IQ, die verwaltete Wissensschicht, die Unternehmensinhalte in wiederverwendbare, berechtigungsfähige Wissensbasen für Agenten im Microsoft Foundry-Portal transformiert.

Wenn Sie eine Abfrage an Azure KI Search ohne den Parameter $orderby senden, werden die zurückgegebenen Ergebnisse in absteigender Reihenfolge nach Relevanz sortiert. Selbst wenn Sie $orderby verwenden, wird der Relevanzscore standardmäßig verwendet, um Gleichstände aufzulösen. Manchmal ist es jedoch sinnvoll, die Relevanzbewertung als erstes Sortierkriterium und einige andere Kriterien als Entscheidungshilfe zu verwenden. Das Beispiel in diesem Artikel veranschaulicht die Verwendung der search.score Funktion zum Sortieren.

Hinweis

Die Relevanzbewertung wird vom Relevanzbewertungsalgorithmus berechnet, und der Bereich variiert je nach verwendetem Algorithmus. Weitere Informationen finden Sie unter Relevanz und Bewertung in Azure KI Search.

Syntax

Die Syntax für search.score in $orderby ist search.score(). Die Funktion search.score akzeptiert keine Parameter. Bei Volltextabfragen können Sie diese mit dem asc- oder desc-Spezifizierer für die Sortierreihenfolge verwenden, genau wie jede andere Klausel im Parameter $orderby. Sie kann an einer beliebigen Stelle in der Liste der Sortierkriterien platziert werden.

Beispiel

Sortieren Sie Hotels in absteigender Reihenfolge nach search.score und ratingund dann in aufsteigender Reihenfolge nach Entfernung von den angegebenen Koordinaten, sodass zwischen zwei Hotels mit identischen Relevanzbewertungen und Bewertungen zuerst die nächstgelegene aufgeführt wird:

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

Einschränkungen

Sie können search.score() nicht in $orderby für reine Vektor- oder Hybridabfragen verwenden. Der Dienst lehnt diese Anfragen mit dem Fehler HTTP 400 InvalidRequestParameter ab. Um die Anforderung zu korrigieren, entfernen Sie search.score() aus $orderby.

Nächste Schritte