Guida introduttiva: Usare Esplora ricerca per eseguire query nel portale di Azure

Note

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.

In questa guida introduttiva si apprenderà come usare Search Explorer, uno strumento di query predefinito nel portale di Azure per l'esecuzione di query su un indice Azure AI Search. Usare questo strumento per testare una query o un'espressione di filtro o per verificare se il contenuto esiste nell'indice.

Questo argomento di avvio rapido prevede l'uso di un indice esistente per illustrare il funzionamento di Esplora ricerche.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare gratuitamente un account.

• Un servizio Azure AI Search. Creare un servizio o trova un servizio esistente nella sottoscrizione corrente. Per questa guida introduttiva, è possibile usare un servizio gratuito.

• Questa guida introduttiva usa l'indice hotels-sample. Seguire le istruzioni riportate in questa guida introduttiva per creare l'indice.

Avvia Esplora risorse di ricerca

1. Passare al servizio di ricerca nel portale Azure.

2. Nel riquadro sinistro selezionare Panoramica.

3. Sulla barra dei comandi selezionare Esplora ricerche.

   

   In alternativa, selezionare la scheda Esplora ricerche nella pagina indice.

Eseguire query in tre modi

Esistono tre approcci per eseguire query in Esplora ricerca.

• La visualizzazione query fornisce una barra di ricerca predefinita. Accetta una query vuota o una query senza testo con valori booleani, ad esempio ocean view + parking.

• La visualizzazione immagine fornisce una finestra per esplorare o trascinare i file PNG, JPG o JPEG. A meno che l'indice non abbia un vettore di immagine e una competenza equivalente, questa vista non è disponibile.

• La vista JSON supporta query con parametri. I filtri, orderby, select, count, searchFields e tutti gli altri parametri devono essere impostati nella visualizzazione JSON.

  

Esempio: query tramite immagine

Esplora ricerca accetta immagini come input di query tramite la visualizzazione immagine, che richiede l'uso di una coppia vettorializzatore-abilità supportata. Per altre informazioni, vedere Configurare un vettore in un indice di ricerca.

L'indice hotels-sample non è configurato per la vettorializzazione delle immagini. Per eseguire query di immagine, creare un indice come descritto in Quickstart: Ricerca vettoriale nel portale di Azure. La guida introduttiva si basa sui dati di esempio basati su testo, quindi è necessario usare documenti che contengono immagini.

Per eseguire una query di immagine, selezionare o trascinare un'immagine nell'area di ricerca e quindi selezionare Cerca. Esploratore di ricerca vettorizza l'immagine e invia il vettore al motore di ricerca per l'esecuzione delle query. Il motore di ricerca restituisce documenti sufficientemente simili all'immagine di input, fino al numero specificato k di risultati.

Esempi: query JSON

Di seguito sono riportati esempi di query JSON che è possibile eseguire usando Esplora ricerche. Per seguire questi esempi, passare alla visualizzazione JSON. È possibile incollare ogni esempio JSON nell'area di testo.

Suggerimento

La visualizzazione JSON supporta intellisense per il completamento del nome del parametro. Posizionare il cursore all'interno della visualizzazione JSON e immettere uno spazio per visualizzare un elenco di tutti i parametri di query. È anche possibile immettere una lettera, ad esempio s, per visualizzare solo i parametri di query che iniziano con tale lettera.

IntelliSense non esclude parametri non validi, quindi usa il tuo giudizio migliore.

Eseguire una query non specificata

In Esploratore di ricerca, le richieste POST vengono formulate internamente usando Documenti - Ricerca Post (API REST), con le risposte restituite come documenti JSON dettagliati.

Per un primo sguardo al contenuto, eseguire una ricerca vuota selezionando Cerca senza termini specificati. Una ricerca vuota è utile come prima query perché restituisce interi documenti in modo da poter esaminare la composizione dei documenti. In una ricerca vuota non esiste alcun punteggio di ricerca e i documenti vengono restituiti in ordine arbitrario ("@search.score": 1 per tutti i documenti). Per impostazione predefinita, vengono restituiti 50 documenti per ogni richiesta di ricerca.

Aggiungere "count": true per ottenere il numero di corrispondenze trovate in un indice. In una ricerca vuota, il conteggio è il numero totale di documenti nell'indice. In una ricerca qualificata è il numero di documenti corrispondenti all'input della query. Tenere presente che il servizio restituisce le prime 50 corrispondenze per impostazione predefinita, pertanto il conteggio potrebbe indicare più corrispondenze nell'indice rispetto a quanto restituito nei risultati.

La sintassi equivalente per una ricerca vuota è * o "search": "*".

{
   "search": "*",
   "count": true
}

Risultati

Eseguire una query a testo libero

La ricerca in formato libero, con o senza operatori, è utile per simulare query definite dall'utente inviate da un'app personalizzata a Azure AI Search. Solo i campi attribuiti come ricercabili nell'indice vengono analizzati per individuare le corrispondenze.

Non è necessaria la visualizzazione JSON per una query senza testo, ma viene fornito in JSON per coerenza con altri esempi in questo articolo.

Si noti che quando si forniscono criteri di ricerca, ad esempio termini di query o espressioni, viene eseguita la classificazione della ricerca. Nell'esempio seguente viene illustrata una ricerca di testo libero. @search.score è un punteggio di pertinenza calcolato per la corrispondenza usando l'algoritmo di assegnazione dei punteggi predefinito.

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast"
}

Risultati

È possibile usare Ctrl-F per cercare all'interno dei risultati specifici termini di interesse.

Limitare i campi nei risultati della ricerca

Aggiungere "select" per limitare i risultati ai campi denominati in modo esplicito per un output più leggibile in Esplora ricerche. Solo i campi attribuiti come recuperabili nell'indice possono essere visualizzati nei risultati.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description"
}

Risultati

Restituisci il lotto successivo di risultati

Azure AI Search restituisce le prime 50 corrispondenze in base alla classificazione di ricerca. L'indice hotels-sample ha solo 50 hotel, quindi usiamo un numero più piccolo per illustrare la paginazione. Per ottenere il set successivo di documenti corrispondenti, accodare "top": 20 e "skip": 10 aumentare il set di risultati su 20 documenti (il valore predefinito è 50, il valore massimo è 1000), ignorando i primi 10 documenti. È possibile controllare la chiave del documento (HotelId) per identificare un documento.

Tenere presente che è necessario fornire criteri di ricerca, ad esempio un termine di query o un'espressione, per ottenere risultati classificati. I punteggi di ricerca diminuiscono man mano che si procede nei risultati della ricerca.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description",
   "top": 20,
   "skip": 10
}

Risultati

Espressioni di filtro (maggiore di, minore di, uguale a)

Usare il filter parametro per specificare criteri di inclusione o esclusione. Il campo deve essere attribuito come filtrabile nell'indice. Questo esempio cerca valutazioni maggiori di quattro:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating",
    "filter": "Rating gt 4"
}

Risultati

Ordinare i risultati

Aggiungere orderby per ordinare i risultati in base a un altro campo oltre al punteggio di ricerca. Il campo deve essere attribuito come ordinabile nell'indice. In situazioni in cui il valore filtrato è identico (ad esempio, lo stesso prezzo), l'ordine è arbitrario, ma è possibile aggiungere altri criteri per l'ordinamento più approfondito. Ecco un'espressione di esempio che è possibile usare per testare questo risultato:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating, LastRenovationDate",
    "filter": "Rating gt 4",
    "orderby": "LastRenovationDate desc"
}

Risultati

Punti chiave

In questa guida introduttiva, hai utilizzato Esplora ricerche per interrogare un indice usando l'API REST.

• I risultati vengono restituiti come documenti JSON dettagliato in modo da poter visualizzare la costruzione e il contenuto di ogni documento nel suo insieme. Il select parametro in un'espressione di query limita i campi restituiti.

• I risultati della ricerca sono costituiti da tutti i campi attribuiti come recuperabili nell'indice. Selezionare la scheda Campi per esaminare gli attributi.

• La ricerca di parole chiave, simile a quella che si potrebbe immettere in un Web browser commerciale, è utile per testare un'esperienza utente finale. Si supponga, ad esempio, di avere l'indice hotels-sample, è possibile immettere "activities 'outdoor pool' restaurant OR continental breakfast", e quindi utilizzare Ctrl-F per trovare termini all'interno dei risultati della ricerca.

• Le espressioni di query e filtro sono articolate in una sintassi implementata da Azure AI Search. Il valore predefinito è una sintassi semplice, ma facoltativamente è possibile usare Lucene completo per query più potenti. Le espressioni di filtro sono articolate in una sintassi OData.

Pulire le risorse

Quando si lavora nella propria sottoscrizione, è consigliabile completare un progetto rimuovendo le risorse non più necessarie. Le risorse che rimangono in esecuzione hanno un costo.

Nel portale di Azure selezionare Tutte le risorse o Gruppi di risorse dal riquadro sinistro per trovare e gestire le risorse. È possibile eliminare le risorse singolarmente o eliminare il gruppo di risorse per rimuovere tutte le risorse contemporaneamente.

Se si usa un servizio di ricerca gratuito, tenere presente che sono limitati a tre indici, indicizzatori e origini dati. È possibile eliminare singoli elementi nel portale per rimanere al di sotto del limite.

Passaggio successivo

Per altre informazioni sulle strutture di query e sulla sintassi, usare un client REST per creare espressioni di query che usano più parti dell'API REST. Documenti - Post di ricerca (API REST) è particolarmente utile per l'apprendimento e l'esplorazione.

Guida introduttiva: Ricerca testuale completa