moreLikeThis (anteprima) in Ricerca di intelligenza artificiale di Azure

moreLikeThis=[key]è un parametro di query nell'API Cerca documenti che trova documenti simili al documento specificato dalla chiave del documento. Quando viene effettuata una richiesta di ricerca con moreLikeThis, viene generata una query con i termini di ricerca estratti dal documento specificato che lo descrivono al meglio. La query generata viene quindi usata per eseguire la richiesta di ricerca. Il moreLikeThis parametro non può essere usato con il parametro di ricerca , search=[string].

Per impostazione predefinita, vengono considerati i contenuti di tutti i campi ricercabili di primo livello. Se invece si desidera specificare campi specifici, è possibile usare il searchFields parametro .

Il moreLikeThis parametro non è supportato per i tipi complessi e la presenza di tipi complessi influirà sulla logica di query. Se l'indice è un tipo complesso, è necessario impostare searchFields sui campi ricercabili di primo livello su cui moreLikeThis eseguire l'iterazione. Se, ad esempio, l'indice ha un tipo ricercabile field1 di tipo Edm.Stringed field2 è un tipo complesso con sottocampi ricercabili, il valore di searchFields deve essere impostato su per field1 escludere field2.

Esempi

Tutti gli esempi seguenti usano l'esempio di hotel di Avvio rapido: Creare un indice di ricerca nella portale di Azure.

Query semplice

La query seguente trova documenti i cui campi di descrizione sono più simili al campo del documento di origine come specificato dal moreLikeThis parametro :

GET /indexes/hotels-sample-index/docs?moreLikeThis=29&searchFields=Description&api-version=2024-05-01-preview

In questo esempio la richiesta cerca hotel simili a quella con HotelId 29. Invece di usare HTTP GET, è anche possibile richiamare MoreLikeThis tramite HTTP POST:

POST /indexes/hotels-sample-index/docs/search?api-version=2024-05-01-preview
    {
      "moreLikeThis": "29",
      "searchFields": "Description"
    }

Applica filtri

MoreLikeThis può essere combinato con altri parametri di query comuni, ad $filteresempio . Ad esempio, la query può essere limitata solo agli alberghi la cui categoria è "Budget" e dove la classificazione è superiore a 3,5:

GET /indexes/hotels-sample-index/docs?moreLikeThis=20&searchFields=Description&$filter=(Category eq 'Budget' and Rating gt 3.5)&api-version=2024-05-01-preview

Selezionare i campi e limitare i risultati

Il $top selettore può essere usato per limitare il numero di risultati da restituire in una MoreLikeThis query. È anche possibile selezionare i campi con $select. Qui vengono selezionati i primi tre hotel insieme al relativo ID, Nome e Classificazione:

GET /indexes/hotels-sample-index/docs?moreLikeThis=20&searchFields=Description&$filter=(Category eq 'Budget' and Rating gt 3.5)&$top=3&$select=HotelId,HotelName,Rating&api-version=2024-05-01-preview

Passaggi successivi

È possibile usare qualsiasi client REST per questo esercizio.