Avvio rapido: Creare un archivio conoscenze di Ricerca cognitiva di Azure nel portale di AzureQuickstart: Create an Azure Cognitive Search knowledge store in the Azure portal

L'archivio conoscenze è una funzionalità di Ricerca cognitiva di Azure che consente di rendere persistente l'output di una pipeline di elaborazione di contenuto per analisi successive o per l'elaborazione downstream.Knowledge store is a feature of Azure Cognitive Search that persists output from a content processing pipeline for subsequent analyses or downstream processing.

Una pipeline accetta contenuto non strutturato di testo e immagini, applica l'intelligenza artificiale basata su Servizi cognitivi (ad esempio OCR ed elaborazione del linguaggio naturale) e restituisce nuove strutture e informazioni che prima non esistevano.A pipeline accepts unstructured text and image content, applies AI powered by Cognitive Services (such as OCR and natural language processing), and outputs new structures and information that didn't previously exist. Uno degli artefatti fisici creati da una pipeline è un archivio conoscenze, a cui è possibile accedere tramite strumenti per analizzare ed esplorare il contenuto.One of the physical artifacts created by a pipeline is a knowledge store, which you can access through tools to analyze and explore content.

In questa guida di avvio rapido verranno combinati servizi e dati nel cloud di Azure per creare un archivio conoscenze.In this quickstart, you'll combine services and data in the Azure cloud to create a knowledge store. Si userà quindi la procedura guidata Importa dati nel portale per riunire tutti i dati ottenuti.Once everything is in place, you'll run the Import data wizard in the portal to pull it all together. Il risultato finale è costituito dal contenuto di testo originale e da quello generato dall'intelligenza artificiale che è possibile visualizzare nel portale (Storage Explorer).The end result is original text content plus AI-generated content that you can view in the portal (Storage Explorer).

PrerequisitiPrerequisites

Per eseguire le procedure descritte è necessario:Before you begin, you must have the following:

Nota

Questo argomento di avvio rapido prevede anche l'uso di Servizi cognitivi di Azure per l'intelligenza artificiale.This quickstart also uses Azure Cognitive Services for the AI. Poiché il carico di lavoro è molto ridotto, Servizi cognitivi lavora dietro le quinte per offrire un'elaborazione gratuita per un massimo di 20 transazioni.Because the workload is so small, Cognitive Services is tapped behind the scenes for free processing for up to 20 transactions. Questo significa che è possibile completare questo esercizio senza dover creare una risorsa Servizi cognitivi aggiuntiva.This means that you can complete this exercise without having to create an additional Cognitive Services resource.

Configurare i datiSet up your data

Nei passaggi seguenti si configura un contenitore BLOB in Archiviazione di Azure in cui archiviare file di contenuto eterogenei.In the following steps, set up a blob container in Azure Storage to store heterogeneous content files.

  1. Download HotelReviews_Free.csv.Download HotelReviews_Free.csv. Questi dati corrispondono ai dati delle recensioni di hotel salvati in un file CSV (generato da Kaggle.com) e contengono 19 commenti dei clienti su un unico hotel.This data is hotel review data saved in a CSV file (originates from Kaggle.com) and contains 19 pieces of customer feedback about a single hotel.

  2. Creare un account di archiviazione di Azure o trovare un account esistente nella sottoscrizione corrente.Create an Azure storage account or find an existing account under your current subscription. Si userà l'archiviazione di Azure sia per il contenuto non elaborato da importare che per l'archivio conoscenze che rappresenta il risultato finale.You'll use Azure storage for both the raw content to be imported, and the knowledge store that is the end result.

    • Scegliere il tipo di account Archiviazione V2 (utilizzo generico V2) .Choose the StorageV2 (general purpose V2) account type.
  3. Aprire le pagine dei servizi BLOB e creare un contenitore denominato hotel-reviews.Open the Blob services pages and create a container named hotel-reviews.

  4. Fare clic su Carica.Click Upload.

    Caricare i datiUpload the data

  5. Selezionare il file HotelReviews-Free.csv scaricato nel primo passaggio.Select the HotelReviews-Free.csv file you downloaded in the first step.

    Creazione del contenitore BLOB di AzureCreate the Azure Blob container

  6. Prima di uscire dalle pagine di archiviazione BLOB, usare un collegamento nel riquadro di spostamento sinistro per aprire la pagina Chiavi di accesso.Before you quit the Blob storage pages, use a link on the left navigation pane to open the Access Keys page. Ottenere una stringa di connessione per recuperare i dati dall'archiviazione BLOB.Get a connection string to retrieve data from Blob storage. Una stringa di connessione è simile all'esempio seguente: DefaultEndpointsProtocol=https;AccountName=<YOUR-ACCOUNT-NAME>;AccountKey=<YOUR-ACCOUNT-KEY>;EndpointSuffix=core.windows.netA connection string looks similar to the following example: DefaultEndpointsProtocol=https;AccountName=<YOUR-ACCOUNT-NAME>;AccountKey=<YOUR-ACCOUNT-KEY>;EndpointSuffix=core.windows.net

A questo punto è possibile procedere con la procedura guidata Importa dati.You are now ready to move on the Import data wizard.

Eseguire la procedura guidata Importa datiRun the Import data wizard

  1. Accedere al portale di Azure con il proprio account Azure.Sign in to the Azure portal with your Azure account.

  2. Trovare il servizio di ricerca, quindi nella pagina Panoramica fare clic su Importa dati sulla barra dei comandi per creare un archivio conoscenze in quattro passaggi.Find your search service and on the Overview page, click Import data on the command bar to create a knowledge store in four steps.

    Comando Importa dati

Passaggio 1: Creare un'origine datiStep 1: Create a data source

  1. In Definisci la connessione ai dati scegliere Archiviazione BLOB di Azure e selezionare l'account e il contenitore creati.In Connect to your data, choose Azure Blob storage, select the account and container you created.

  2. In Nome immettere hotel-reviews-ds.For the Name, enter hotel-reviews-ds.

  3. In Modalità di analisi selezionare Testo delimitato e quindi selezionare la casella di controllo La prima riga contiene l'intestazione.For Parsing mode, select Delimited text, and then select the First Line Contains Header checkbox. Verificare che in Carattere di delimitazione sia impostata la virgola (,).Make sure the Delimiter character is a comma (,).

  4. In Stringa di connessione incollare la stringa di connessione copiata dalla pagina Chiavi di accesso in Archiviazione di Azure.In Connection String, paste in the connection string you copied from the Access Keys page in Azure Storage.

  5. In Contenitori immettere il nome del contenitore BLOB in cui si trovano i dati.In Containers, enter the name of the blob container holding the data.

    La pagina sarà simile alla schermata seguente.Your page should look similar to the following screenshot.

    Creazione di un oggetto origine datiCreate a data source object

  6. Passare alla pagina successiva.Continue to the next page.

Passaggio 2: Aggiungere competenze cognitiveStep 2: Add cognitive skills

In questo passaggio della procedura guidata si creerà un set di competenze con arricchimenti delle competenze cognitive.In this wizard step, you will create a skillset with cognitive skill enrichments. I dati di origine sono costituiti dalle recensioni dei clienti in diverse lingue.The source data consists of customer reviews in several languages. Le competenze pertinenti per questo set di dati includono l'estrazione di frasi chiave, il rilevamento del sentiment e la traduzione del testo.Skills that are relevant for this data set include key phrase extraction, sentiment detection, and text translation. In un passaggio successivo questi arricchimenti verranno "proiettati" in un archivio conoscenze come tabelle di Azure.In a later step, these enrichments will be "projected" into a knowledge store as Azure tables.

  1. Espandere Collega Servizi cognitivi.Expand Attach Cognitive Services. Gratuito (miglioramenti limitati) è l'impostazione predefinita.Free (Limited enrichments) is selected by default. È possibile usare questa risorsa perché il numero di record in HotelReviews-Free.csv è 19 e questa risorsa gratuita consente fino a 20 transazioni al giorno.You can use this resource because number of records in HotelReviews-Free.csv is 19 and this free resource allows up to 20 transactions a day.

  2. Espandere Aggiungi arricchimenti.Expand Add enrichments.

  3. In Nome set di competenze immettere hotel-reviews-ss.For Skillset name, enter hotel-reviews-ss.

  4. In Campo dei dati di origine selezionare reviews_text.For Source data field, select reviews_text.

  5. In Livello di granularità dell'arricchimento selezionare Pagine (5000 blocchi di caratteri) .For Enrichment granularity level, select Pages (5000 characters chunks)

  6. Selezionare le competenze cognitive seguenti:Select these cognitive skills:

    • Estrarre le espressioni chiaveExtract key phrases

    • Tradurre un testoTranslate text

    • Rileva sentimentDetect sentiment

      Creare un set di competenzeCreate a skillset

  7. Espandere Salva arricchimenti in un archivio conoscenze (anteprima) .Expand Save enrichments to knowledge store.

  8. Selezionare le proiezioni di tabelle di Azure seguenti:Select these Azure table projections:

    • Documents (Documenti)Documents
    • PaginePages
    • Frasi chiaveKey phrases
  9. Immettere la stringa di connessione dell'account di archiviazione salvata in un passaggio precedente.Enter the Storage account Connection String that you saved in a previous step.

    Configurazione dell'archivio conoscenzeConfigure knowledge store

  10. Facoltativamente, scaricare un modello di Power BI.Optionally, download a Power BI template. Quando si accede al modello dalla procedura guidata, il file con estensione pbit locale viene adattato alla forma dei dati.When you access the template from the wizard, the local .pbit file is adapted to reflect the shape of your data.

  11. Passare alla pagina successiva.Continue to the next page.

Passaggio 3: Configurare l'indiceStep 3: Configure the index

In questo passaggio della procedura guidata si configura un indice per query di ricerca full-text facoltative.In this wizard step, you will configure an index for optional full-text search queries. La procedura guidata campiona l'origine dati per dedurre i campi e i tipi di dati.The wizard will sample your data source to infer fields and data types. Non occorre fare altro che selezionare gli attributi per il comportamento desiderato.You only need to select the attributes for your desired behavior. Ad esempio, l'attributo Recuperabile consentirà al servizio di ricerca di restituire un valore di campo, mentre l'attributo Ricercabile abiliterà la ricerca full-text nel campo.For example, the Retrievable attribute will allow the search service to return a field value while the Searchable will enable full text search on the field.

  1. In Nome indice immettere hotel-reviews-idx.For Index name, enter hotel-reviews-idx.

  2. Per gli attributi, accettare le selezioni predefinite: Recuperabile e Ricercabile per i nuovi campi creati dalla pipeline.For attributes, accept the default selections: Retrievable and Searchable for the new fields that the pipeline is creating.

    L'indice dovrebbe essere simile all'immagine seguente.Your index should look similar to the following image. Poiché l'elenco è lungo, non tutti i campi sono visibili nell'immagine.Because the list is long, not all fields are visible in the image.

    Configurazione di un indiceConfigure an index

  3. Passare alla pagina successiva.Continue to the next page.

Passaggio 4: Configurare l'indicizzatoreStep 4: Configure the indexer

In questo passaggio della procedura guidata si configurerà un indicizzatore che riunisce l'origine dati, il set di competenze e l'indice definiti nei passaggi precedenti della procedura guidata.In this wizard step, you will configure an indexer that will pull together the data source, skillset, and the index you defined in the previous wizard steps.

  1. Per Nome immettere hotel-reviews-idxr.For Name, enter hotel-reviews-idxr.

  2. In Pianificazione mantenere l'impostazione predefinita Una sola volta.For Schedule, keep the default Once.

  3. Fare clic su Invia per eseguire l'indicizzatore.Click Submit to run the indexer. Le operazioni di estrazione dei dati, indicizzazione e applicazione delle competenze cognitive vengono eseguite tutte in questo passaggio.Data extraction, indexing, application of cognitive skills all happen in this step.

Monitorare lo statoMonitor status

Il completamento dell'indicizzazione delle competenze cognitive richiede più tempo rispetto all'indicizzazione tipica basata su testo.Cognitive skill indexing takes longer to complete than typical text-based indexing. La procedura guidata dovrebbe aprire l'elenco degli indicizzatori nella pagina di panoramica in modo che sia possibile monitorare lo stato di avanzamento.The wizard should open the Indexer list in the overview page so that you can track progress. In caso contrario, passare alla pagina Panoramica e fare clic su Indicizzatori.For self-navigation, go to the Overview page and click Indexers.

Nel portale di Azure è anche possibile monitorare il log attività Notifiche per rilevare la presenza di un collegamento di stato Notifica di Ricerca cognitiva di Azure selezionabile.In the Azure portal, you can also monitor the Notifications activity log for a clickable Azure Cognitive Search notification status link. Il completamento dell'esecuzione può richiedere alcuni minuti.Execution may take several minutes to complete.

Passaggi successiviNext steps

Ora che i dati sono stati arricchiti mediante Servizi cognitivi e i risultati sono stati proiettati in un archivio conoscenze, è possibile usare Storage Explorer o Power BI per esplorare il set di dati arricchito.Now that you have enriched your data using Cognitive Services and projected the results into a knowledge store, you can use Storage Explorer or Power BI to explore your enriched data set.

È possibile visualizzare il contenuto in Storage Explorer o eseguire un'ulteriore operazione con Power BI per ottenere informazioni dettagliate tramite la visualizzazione.You can view content in Storage Explorer, or take it a step further with Power BI to gain insights through visualization.

Suggerimento

Se si vuole ripetere questo esercizio o provare un'altra procedura dettagliata per gli arricchimenti di intelligenza artificiale, eliminare l'indicizzatore hotel-reviews-idxr.If you want to repeat this exercise or try a different AI enrichment walkthrough, delete the hotel-reviews-idxr indexer. Eliminando l'indicizzatore, il contatore delle transazioni giornaliere gratuite viene azzerato per l'elaborazione di Servizi cognitivi.Deleting the indexer resets the free daily transaction counter back to zero for Cognitive Services processing.