OData-Funktion search.score in Foundry IQ (Azure KI-Suche)

Hinweis

Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.

Wenn Sie eine Abfrage an Foundry IQ (Azure KI-Suche) ohne den $orderby Parameter senden, werden die ergebnisse, die zurückgegeben werden, nach Relevanzbewertung in absteigender Reihenfolge 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 Foundry IQ.

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