1 - Panoramica dell'aggiunta della ricerca a un sito Web con Python

  • Articolo

Questa esercitazione crea un sito Web in cui cercare un catalogo di libri e quindi distribuisce il sito Web in un'app Web statica di Azure.

Cosa fa l'esempio?

Questo sito Web di esempio consente di accedere a un catalogo di 10.000 libri. Un utente può eseguire ricerche nel catalogo immettendo testo nella barra di ricerca. Mentre l'utente immette testo, il sito Web usa la funzionalità di suggerimento dell'indice di ricerca per completare il testo. Al termine della query, l'elenco dei libri viene visualizzato con una parte dei dettagli. Un utente può selezionare un libro per visualizzare tutti i dettagli, archiviati nell'indice di ricerca, del libro.

Screenshot of the sample app in a browser window.

L'esperienza di ricerca include:

  • Ricerca: fornisce la funzionalità di ricerca per l'applicazione.
  • Suggerisci: fornisce suggerimenti quando l'utente digita nella barra di ricerca.
  • Facet e filtri: fornisce una struttura di spostamento in base a facet che filtra in base all'autore o alla lingua.
  • Risultati impaginati: fornisce controlli di paging per lo scorrimento dei risultati.
  • Ricerca documento: cerca un documento in base all'ID per recuperare tutto il relativo contenuto per la pagina dei dettagli.

Come è organizzato l'esempio?

Il codice di esempio include quanto segue:

App Scopo GitHub
Repository
Ubicazione
Client App React (livello presentazione) per visualizzare i libri, con la ricerca. Chiama l'app per le funzioni di Azure. /search-website-functions-v4/client
Server App per le funzioni di Azure (livello aziendale): chiama l'API Ricerca di intelligenza artificiale di Azure con Python SDK /search-website-functions-v4/api
Inserimento in blocco File Python per creare l'indice e aggiungervi documenti. /search-website-functions-v4/bulk-upload

Configurare l'ambiente di sviluppo

Installare quanto segue per l'ambiente di sviluppo locale.

Creare una copia tramite fork e clonare l'esempio di ricerca con Git

La creazione di fork del repository di esempio è fondamentale per poter distribuire l'app Web statica. Le app Web determinano le azioni di compilazione e il contenuto della distribuzione in base alla propria posizione fork di GitHub. L'esecuzione del codice nell'app Web statica è remota, con le app Web statiche di Azure che leggono dal codice nell'esempio di fork.

  1. In GitHub creare una copia tramite fork del repository di esempio.

    Completare il processo di fork nel Web browser con l'account GitHub. Questa esercitazione usa il fork come parte della distribuzione in un'app Web statica di Azure.

  2. In un terminale bash scaricare l'applicazione di esempio nel computer locale.

    Sostituire YOUR-GITHUB-ALIAS con l'alias GitHub.

    git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-python-samples.git

  3. In Visual Studio Code aprire la cartella locale del repository clonato. Le attività rimanenti vengono eseguite da Visual Studio Code, a meno che non sia specificato.

Creare un gruppo di risorse per le risorse di Azure

  1. In Visual Studio Code aprire la barra attività e selezionare l'icona di Azure.

  2. Accedere ad Azure, se non si è già connessi.

  3. Nella sezione Risorse selezionare Aggiungi (+) e quindi crea gruppo di risorse.

    Screenshot of Visual Studio Code, in Azure explorer, showing **Create Resource Group** option.

  4. Immettere un nome del gruppo di risorse, ad esempio cognitive-search-demo-rg.

  5. Immettere un'area:

    • Per Node.js selezionare West US 2. Questa è l'area consigliata per l'anteprima del modello di programmazione delle funzioni di Azure v4.
    • Per C# e Python, è consigliabile usare le aree seguenti, supportate da App Web statiche di Azure a partire da questa scrittura: West US 2, East US 2, West Europe, Central USEast Asia

Usare questo gruppo di risorse per tutte le risorse create durante questa esercitazione. Un gruppo di risorse offre un'unità logica per gestire le risorse, inclusa l'eliminazione al termine.

Passaggi successivi