Funzione OData search.score in Ricerca di intelligenza artificiale di Azure

Nota

Azure AI Search è disponibile tramite il portale di Azure, le API REST e Azure SDK. È inoltre alla base di Foundry IQ, il livello di conoscenza gestito che trasforma il contenuto aziendale in knowledge base riutilizzabili e con riconoscimento delle autorizzazioni per gli agenti nel portale di Microsoft Foundry.

Quando si invia una query a Ricerca di intelligenza artificiale di Azure senza il parametro $orderby, i risultati restituiti verranno ordinati in ordine decrescente in base al punteggio di pertinenza. Anche quando si usa $orderby, il punteggio di pertinenza viene usato per interrompere i legami per impostazione predefinita. Tuttavia, a volte è utile usare il punteggio di pertinenza come criterio di ordinamento iniziale e altri criteri come criterio di spareggio. Nell'esempio riportato in questo articolo viene illustrato l'uso della funzione per l'ordinamento search.score .

Nota

Il punteggio di pertinenza viene calcolato dall'algoritmo di classificazione della pertinenza e l'intervallo varia a seconda dell'algoritmo usato. Per altre informazioni, vedere Pertinenza e assegnazione dei punteggi in Ricerca di intelligenza artificiale di Azure.

Sintassi

La sintassi per search.score in $orderby è search.score(). La funzione search.score non accetta parametri. Per le query full-text, è possibile usare gli identificatori di ordinamento asc o desc, proprio come qualsiasi altra clausola nel parametro $orderby. Può essere visualizzato ovunque nell'elenco dei criteri di ordinamento.

Esempio

Ordinare gli hotel in ordine decrescente in search.score base a e rating, quindi in ordine crescente in base alla distanza dalle coordinate specificate in modo che tra due hotel con punteggi di pertinenza e classificazioni identici, quello più vicino viene elencato per primo:

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

Limitazioni

Non è possibile usare search.score() in $orderby per query ibride o vettoriali pure. Il servizio rifiuta queste richieste con un errore HTTP 400 InvalidRequestParameter . Per correggere la richiesta, rimuovere search.score() da $orderby.

Passaggi successivi