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

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.

Screenshot of the Overview page for an Azure AI Search service instance in the Azure portal, showing the number of indexes, indexers, and data sources.

Avviare la procedura guidata

  1. Accedere al portale di Azure con l'account Azure e passare al servizio di ricerca di intelligenza artificiale di Azure.

  2. Nella pagina Panoramica selezionare Importa dati per avviare la procedura guidata.

    Screenshot that shows how to open the Import data wizard in the Azure portal.

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.

  1. In Connessione ai dati espandere l'elenco a discesa Origine dati e selezionare Esempi.

  2. Nell'elenco di esempi predefiniti selezionare hotels-sample.

    Screenshot that shows how to select the hotels-sample data source in the Import data wizard.

  3. 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.

  1. Per questa guida introduttiva, ignorare le opzioni di configurazione di arricchimento tramite intelligenza artificiale nella scheda Aggiungi competenze cognitive.

  2. Selezionare Ignora a: Personalizzare l'indice di destinazione per continuare.

    Screenshot that shows how to Skip to the Customize target index tab in the Import data wizard.

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:

  1. Accettare i valori generati dal sistema per il campo Index name (hotels-sample-index) e Key (HotelId).

  2. 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.

  3. Selezionare Avanti: Creare un indicizzatore per continuare.

Screenshot that shows the generated index definition for the hotels-sample data source in the Import data wizard.

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.

  1. Accettare il valore generato dal sistema per il nome dell'indicizzatore (hotels-sample-indexer).

  2. 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.

  3. Selezionare Invia per creare ed eseguire contemporaneamente l'indicizzatore.

    Screenshot that shows how to configure the indexer for the hotels-sample data source in the Import data wizard.

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.

  1. A sinistra selezionare Indicizzatori.

    Screenshot that shows the creation of the indexer in progress in the Azure portal.

    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

  1. A sinistra selezionare Indici.

  2. 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.

    Screenshot of the Indexes list on the Azure AI Search service dashboard in the Azure portal.

  3. 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.

    Screenshot that shows the schema definition for an index in the Azure AI Search service in the Azure portal.

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.

  1. Nella scheda Esplora ricerche immettere il testo in cui eseguire la ricerca.

    Screenshot that shows how to enter and run a query in the Search Explorer tool.

  2. Usare la mappa Mini per passare rapidamente alle aree non visibili dell'output.

    Screenshot that shows long results for a query in the Search Explorer tool and the mini-map.

  3. Per specificare la sintassi, passare alla visualizzazione JSON.

    Screenshot of the JSON view selector.

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.67di 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.