Guida introduttiva: Creare un indice di ricerca nel portale di Azure
In questa guida introduttiva di Ricerca intelligenza artificiale di Azure creare il primo indice di ricerca usando la procedura guidata Importa dati e un'origine dati di esempio predefinita costituita da dati di hotel fittizi ospitati da Microsoft. La procedura guidata illustra la creazione di un indice di ricerca senza codice che consente di scrivere query interessanti in pochi minuti.
La procedura guidata crea più oggetti nel servizio di ricerca, ovvero un indice ricercabile, ma anche una connessione indicizzatore e origine dati per il recupero automatico dei dati. Alla fine di questo argomento di avvio rapido viene esaminato ogni oggetto.
Nota
La procedura guidata Importa dati include opzioni per OCR, traduzione testuale e altri arricchimenti di intelligenza artificiale non trattati in questa guida introduttiva. Per una procedura dettagliata simile incentrata sull'arricchimento tramite intelligenza artificiale, vedere Avvio rapido: Creare un set di competenze nel portale di Azure.
Prerequisiti
Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
Un servizio di ricerca di intelligenza artificiale di Azure per qualsiasi livello e qualsiasi area. Creare un servizio o trovarne uno esistente nella sottoscrizione corrente. È possibile usare un servizio gratuito per questo avvio rapido.
Verificare lo spazio
Molti clienti iniziano con il servizio gratuito. Il livello gratuito è limitato a tre indici, tre origini dati e tre indicizzatori. Assicurarsi di avere spazio per gli elementi aggiuntivi prima di iniziare, Questa guida introduttiva crea uno di ogni oggetto.
Controllare la scheda Utilizzo panoramica > per il servizio per verificare il numero di indici, indicizzatori e origini dati già disponibili.
Avviare la procedura guidata
Accedere al portale di Azure con l'account Azure e passare al servizio di ricerca di intelligenza artificiale di Azure.
Nella pagina Panoramica selezionare Importa dati per avviare la procedura guidata.
Creare e caricare un indice
In questa sezione creare e caricare un indice in quattro passaggi.
Connessione a un'origine dati
La procedura guidata crea una connessione all'origine dati per i dati di esempio ospitati da Microsoft in Azure Cosmos DB. Questi dati di esempio vengono recuperati tramite una connessione interna. Per eseguire questa guida introduttiva non è necessario un account o file di origine di Azure Cosmos DB.
In Connessione ai dati espandere l'elenco a discesa Origine dati e selezionare Esempi.
Nell'elenco di esempi predefiniti selezionare hotels-sample.
Selezionare Avanti: Aggiungere competenze cognitive (facoltativo) per continuare.
Ignorare la configurazione per le competenze cognitive
La procedura guidata Importa dati supporta la creazione di un set di competenze e l'arricchimento tramite intelligenza artificiale nell'indicizzazione.
Per questa guida introduttiva, ignorare le opzioni di configurazione di arricchimento tramite intelligenza artificiale nella scheda Aggiungi competenze cognitive.
Selezionare Ignora a: Personalizzare l'indice di destinazione per continuare.
Suggerimento
Interesse per l'arricchimento tramite intelligenza artificiale? Provare questa guida introduttiva: Creare un set di competenze nel portale di Azure
Configurare l'indice
La procedura guidata deduce uno schema per l'indice hotels-sample predefinito. Per configurare l'indice, seguire questa procedura:
Accettare i valori generati dal sistema per il campo Index name (hotels-sample-index) e Key (HotelId).
Accettare i valori generati dal sistema per tutti gli attributi di campo.
Importante
Se si esegue di nuovo la procedura guidata e si usa un'origine dati hotels-sample esistente, l'indice non è configurato con gli attributi predefiniti. È necessario selezionare manualmente gli attributi nelle importazioni future.
Selezionare Avanti: Creare un indicizzatore per continuare.
Come minimo, l'indice richiede un nome di indice e una raccolta di campi. Un campo deve essere contrassegnato come chiave del documento per identificare in modo univoco ogni documento. Il valore è sempre una stringa. La procedura guidata analizza i campi stringa univoci e ne sceglie una per la chiave.
Ogni campo ha un nome, un tipo di dati e attributi che controllano come usare il campo nell'indice di ricerca. Le caselle di controllo abilitano o disabilitano gli attributi seguenti:
- Recuperabile: campi restituiti in una risposta di query.
- Filtrabile: campi che accettano un'espressione di filtro.
- Ordinabile: campi che accettano un'espressione orderby.
- Facetable: campi usati in una struttura di spostamento in base a facet.
- Ricercabile: campi usati nella ricerca full-text. Le stringhe sono ricercabili. I campi numerici e i campi booleani sono spesso contrassegnati come non ricercabili.
Le stringhe vengono attribuite come recuperabili e ricercabili. I numeri interi vengono attribuiti come Recuperabile, Filtrabile, Ordinabile e Facetable.
Gli attributi influiscono sull'archiviazione. I campi filtrabili utilizzano spazio di archiviazione aggiuntivo, ma non recuperabili . Per altre informazioni, vedere Esempio che illustra le implicazioni di archiviazione di attributi e suggerimenti.
Se si desidera eseguire il completamento automatico o le query suggerite, specificare analizzatori del linguaggio o suggerimenti.
Configurare ed eseguire l'indicizzatore
L'ultimo passaggio configura ed esegue l'indicizzatore. Questo oggetto definisce un processo eseguibile. L'origine dati, l'indice e l'indicizzatore vengono creati in questo passaggio.
Accettare il valore generato dal sistema per il nome dell'indicizzatore (hotels-sample-indexer).
Per questa guida introduttiva, usare l'opzione predefinita per eseguire immediatamente l'indicizzatore. I dati ospitati sono statici, quindi non è abilitato il rilevamento delle modifiche.
Selezionare Invia per creare ed eseguire contemporaneamente l'indicizzatore.
Monitorare lo stato dell'indicizzatore
È possibile monitorare la creazione dell'indicizzatore o dell'indice nel portale. La pagina Panoramica del servizio fornisce collegamenti alle risorse create nel servizio di ricerca di intelligenza artificiale di Azure.
A sinistra selezionare Indicizzatori.
L'aggiornamento dei risultati della pagina nella portale di Azure può richiedere alcuni minuti. Nell'elenco dovrebbe essere visualizzato l'indicizzatore appena creato con lo stato In corso o Operazione completata. L'elenco mostra anche il numero di documenti indicizzati.
Controllare i risultati dell'indice di ricerca
A sinistra selezionare Indici.
Selezionare hotels-sample-index.
Attendere l'aggiornamento della pagina portale di Azure. Verrà visualizzato l'indice con un numero di documenti e dimensioni di archiviazione.
Selezionare la scheda Campi per visualizzare lo schema dell'indice.
Verificare quali campi sono filtrabili o ordinabili in modo da conoscere le query da scrivere.
Aggiungere o modificare i campi
Nella scheda Campi è possibile creare un nuovo campo usando Aggiungi campo con un nome, un tipo di dati supportato e le attribuzioni.
La modifica dei campi esistenti è più difficile. I campi esistenti hanno una rappresentazione fisica nell'indice in modo che non siano modificabili, nemmeno nel codice. Per modificare fondamentalmente un campo esistente, è necessario creare un nuovo campo che sostituisce l'originale. Altri costrutti, ad esempio profili di punteggio e opzioni CORS, possono essere aggiunti a un indice in qualsiasi momento.
Per comprendere chiaramente cosa è possibile e non è possibile modificare durante la progettazione dell'indice, è necessario un minuto per visualizzare le opzioni di definizione dell'indice. Le opzioni grigie nell'elenco dei campi indicano valori che non possono essere modificati o eliminati.
Eseguire query con Esplora ricerche
È ora disponibile un indice di ricerca su cui è possibile eseguire query con Esplora ricerche. Esplora ricerche invia chiamate REST conformi all'API REST POST di ricerca. Lo strumento supporta la sintassi di query semplice e la sintassi di query Lucene completa.
Nella scheda Esplora ricerche immettere il testo in cui eseguire la ricerca.
Usare la mappa Mini per passare rapidamente alle aree non visibili dell'output.
Per specificare la sintassi, passare alla visualizzazione JSON.
Query di esempio per l'indice di esempio degli hotel
Gli esempi seguenti presuppongono la visualizzazione JSON e la versione dell'API REST 2023-11-01.
Esempi di filtro
Parcheggio, tag, data di ristrutturazione, classificazione e posizione sono filtrabili.
{
"search": "beach OR spa",
"select": "HotelId, HotelName, Description, Rating",
"count": true,
"top": 10,
"filter": "Rating gt 4"
}
Per impostazione predefinita, i filtri booleani presuppongono "true".
{
"search": "beach OR spa",
"select": "HotelId, HotelName, Description, Rating",
"count": true,
"top": 10,
"filter": "ParkingIncluded"
}
La ricerca geospaziale è basata su filtri. La geo.distance
funzione filtra tutti i risultati per i dati posizionali in base alle coordinate e geography'POINT
specificateLocation
. La query cerca gli hotel che si trovano entro 5 chilometri dalle coordinate -122.12 47.67
di longitudine della latitudine, ovvero "Redmond, Washington, USA". La query visualizza il numero totale di corrispondenze &$count=true
con i nomi degli hotel e le posizioni degli indirizzi.
{
"search": "*",
"select": "HotelName, Address/City, Address/StateProvince",
"count": true,
"top": 10,
"filter": "geo.distance(Location, geography'POINT(-122.12 47.67)') le 5"
}
Esempi di sintassi Lucene completi
La sintassi predefinita è semplice, ma se si desidera eseguire ricerche fuzzy o espressioni regolari, specificare la sintassi completa.
{
"queryType": "full",
"search": "seatle~",
"select": "HotelId, HotelName,Address/City, Address/StateProvince",
"count": true
}
Per impostazione predefinita, i termini di query con errori di ortografia, ad seatle
esempio per Seattle
la mancata restituzione delle corrispondenze in una ricerca tipica. Il queryType=full
parametro richiama il parser di query Lucene completo, che supporta l'operando tilde ~
. Quando questi parametri sono presenti, la query esegue una ricerca fuzzy per la parola chiave specificata. La query cerca risultati corrispondenti insieme ai risultati simili ma non esattamente corrispondenti alla parola chiave .
Provare alcune di queste query di esempio per l'indice. Per altre informazioni sulle query, vedere Esecuzione di query in Ricerca di intelligenza artificiale di Azure.
Pulire le risorse
Quando si lavora nella propria sottoscrizione, è consigliabile alla fine di un progetto identificare se sono ancora necessarie le risorse create. Le risorse che rimangono in esecuzione hanno un costo. È possibile eliminare risorse singole oppure gruppi di risorse per eliminare l'intero set di risorse.
È possibile trovare e gestire le risorse per il servizio nel portale di Azure in Tutte le risorse o Gruppi di risorse nel riquadro sinistro.
Se si usa un servizio gratuito, tenere presente che il limite è costituito da tre indici, indicizzatori e origini dati. È possibile eliminare singoli elementi nel portale di Azure per rimanere al di sotto del limite.
Passaggi successivi
Provare una portale di Azure procedura guidata per generare un'app Web pronta per l'uso eseguita in un browser. Usare questa procedura guidata sull'indice di piccole dimensioni creato in questa guida introduttiva oppure usare uno dei set di dati di esempio predefiniti per un'esperienza di ricerca più completa.