Inizia a utilizzare la ricerca generica

Inizia a utilizzare la ricerca generica

Vertex AI Search riunisce la potenza del recupero approfondito di informazioni, l'elaborazione del linguaggio naturale all'avanguardiae le più recenti innovazioni per l'elaborazione di modelli LLM al fine di comprendere l'intenzione dell'utente e restituire i risultati più pertinenti per l'utente.

Con Vertex AI Search puoi creare app per la ricerca e l'elaborazione di suggerimenti. Vertex AI Search ha inoltre funzionalità speciali per alcuni settori, come media, sanità e vendita al dettaglio.

Questo tutorial spiega come creare un'app di ricerca di dati generici, ovvero dati non specifici di un settore verticale.

Questo tutorial spiega come creare app di ricerca per diversi tipi di dati:

• Dati del sito web dalla scansione di cloud.google.com/generative-ai-app-builder/
• Dati strutturati sotto forma di set di dati in formato NDJSON importati da un bucket Cloud Storage
• Dati non strutturati sotto forma di PDF importati da un bucket Cloud Storage

Prima di seguire questo tutorial, assicurati di aver svolto i passaggi descritti in Prima di iniziare.

Nota: questo tutorial riguarda Vertex AI Search. Per iniziare a utilizzare Vertex AI Agents, consulta il codelab Crea un'app di chat generativa.

---

Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud, fai clic su Procedura guidata:

Procedura guidata

---

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.

   Enable the APIs

Attiva Vertex AI Agent Builder

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

2. Leggi e accetta i Termini di servizio, quindi fai clic su Continua e attiva l'API.

Crea un datastore

Per prima cosa, dovrai creare un datastore contenente i dati che la tua app di ricerca indicizzerà.

Fai clic sulla scheda relativa al tipo di dati che vuoi inserire nel tuo datastore: sito web, strutturati o non strutturati.

Dati sui siti web

1. Vai alla pagina Crea datastore.

   Agent Builder - Crea datastore

2. Nel riquadro Seleziona un'origine dati, scegli contenuto del sito web.

3. Nel riquadro Specifica i siti web per il datastore, assicurati che l'opzione Indicizzazione avanzata dei siti web sia disattivata.

4. Nel campo Siti da includere, inserisci:

   cloud.google.com/generative-ai-app-builder/*
   

5. Fai clic su Continua.

6. Nel riquadro Configura il datastore, seleziona globale (Globale) come località per il datastore.

7. Inserisci un nome per il tuo datastore. Prendi nota dell'ID generato. ti servirà in un secondo momento.

8. Fai clic su Crea.

Dati strutturati

1. Vai alla pagina Crea datastore.

   Agent Builder - Crea datastore

2. Nel riquadro Seleziona un'origine dati, scegli Cloud Storage.

3. Nel riquadro Importa dati da Cloud Storage, seleziona Dati strutturati (JSONL).

4. Assicurati che l'opzione File sia selezionata.

5. Nel campo gs://, inserisci il seguente valore:

   cloud-samples-data/gen-app-builder/search/kaggle_movies/movie_metadata.ndjson
   

   Questo bucket Cloud Storage contiene un file in formato NDJSON di filmati resi disponibili da Kaggle.

6. Fai clic su Continua.

7. Assegna le proprietà chiave come segue:

   Nome campo	Proprietà della chiave
   homepage	uri
   overview	description

   E fai clic su Continua.

8. Nel riquadro Configura il datastore, seleziona globale (Globale) come località per il datastore.

9. Inserisci un nome per il tuo datastore. Prendi nota dell'ID generato. ti servirà in un secondo momento.

10. Fai clic su Crea.

Dati non strutturati

1. Vai alla pagina Crea datastore.

   Agent Builder - Crea datastore

2. Nel riquadro Seleziona un'origine dati, scegli Cloud Storage.

3. Nel riquadro Importa dati da Cloud Storage, seleziona Documenti non strutturati (PDF, HTML, TXT e altro).

4. Assicurati che l'opzione Cartella sia selezionata.

5. Nel campo gs://, inserisci il seguente valore:

   cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs
   

   Questo bucket Cloud Storage contiene i PDF dei report sugli utili del sito per gli investitori Alphabet.

6. Nel riquadro Configura il datastore, seleziona globale (Globale) come località per il datastore.

7. Inserisci un nome per il tuo datastore. Prendi nota dell'ID generato. ti servirà in un secondo momento.

8. Fai clic su Crea.

Crea un'app di ricerca

A questo punto, dovrai creare un'app di ricerca e collegare il datastore creato in precedenza.

Dati sui siti web

1. Vai alla pagina Crea app.

   Agent Builder - Crea app

2. In Cerca il tuo sito web, fai clic su Crea.

3. Assicurati che le funzionalità della versione Enterprise siano attive.

4. Nel campo Nome app, inserisci un nome per l'app. L'ID dell'app è riportato sotto il nome dell'app.

5. Nel campo Nome esterno della tua azienda o organizzazione, inserisci il nome dell'azienda o dell'organizzazione. Per questo tutorial, puoi utilizzare Google Cloud, perché l'app cercherà su un sito web Google Cloud.

6. Seleziona globale (Globale) come località per la tua app, poi fai clic su Continua.

7. Nell'elenco dei datastore, seleziona quello creato in precedenza e fai clic su Crea.

8. Vai alla pagina Dati della tua app per visualizzare l'elenco dei siti web indicizzati e modificarli, se necessario.

Dati strutturati

1. Vai alla pagina Crea app.

   Agent Builder - Crea app

2. In Cerca il tuo sito web, fai clic su Crea.

3. Assicurati che le funzionalità della versione Enterprise siano attive.

4. Nel campo Nome app, inserisci un nome per l'app. L'ID dell'app è riportato sotto il nome dell'app.

5. Nel campo Nome esterno della tua azienda o organizzazione, inserisci il nome dell'azienda o dell'organizzazione. Per questo tutorial, puoi utilizzare Cymbal Cinemas, perché l'app cercherà in un datastore di film.

6. Seleziona globale (Globale) come località per la tua app, poi fai clic su Continua.

7. Nell'elenco dei datastore, seleziona quello creato in precedenza e fai clic su Crea.

8. Nella pagina Dati dell'applicazione, fai clic sulla scheda Attività per visualizzare lo stato di importazione dei dati. Il messaggio Importazione completata viene visualizzato nella colonna stato al termine del processo di importazione. Per questo set di dati, questa operazione richiede in genere dai due ai tre minuti. Potrebbe essere necessario fare clic su Aggiorna per visualizzare il messaggio Importazione completata.

9. Fai clic sulla scheda Documenti per visualizzare il numero di documenti importati.

Dati non strutturati

1. Vai alla pagina Crea app.

   Agent Builder - Crea app

2. In Cerca il tuo sito web, fai clic su Crea.

3. Assicurati che le Funzionalità aziendali siano attive.

4. Nel campo Nome app, inserisci un nome per l'app. L'ID dell'app è riportato sotto il nome dell'app.

5. Nel campo Nome esterno della tua azienda o organizzazione, inserisci il nome dell'azienda o dell'organizzazione. Per questo tutorial, puoi utilizzare Alphabet, perché l'app cercherà nei documenti di Alphabet.

6. Seleziona globale (Globale) come località per la tua app, poi fai clic su Continua.

7. Nell'elenco dei datastore, seleziona quello creato in precedenza e fai clic su Crea.

8. Nella pagina Dati dell'applicazione, fai clic sulla scheda Attività per visualizzare lo stato di importazione dei dati. Al termine del processo di importazione, la colonna stato indica Importazione completata. Per questo set di dati, il processo di importazione richiede in genere dai due a tre minuti. Potresti dover fare clic su Aggiorna per visualizzare lo stato Importazione completata.

9. Fai clic sulla scheda Documenti per visualizzare il numero di documenti importati.

Visualizza l'anteprima dell'app

Dati sui siti web

1. Nella pagina App, fai clic sul nome della nuova app.

2. Nel menu di navigazione, fai clic su Anteprima per eseguire il test dell'app di ricerca.

3. (Facoltativo) Fai clic sulle icone delle viste per passare da quella mobile a quella desktop.

4. Nella barra di ricerca, cerca Vertex AI Search per visualizzare i risultati relativi al prodotto.

Dati strutturati

1. Nella pagina App, fai clic sul nome della nuova app.

2. Nel menu di navigazione, fai clic su Anteprima per eseguire il test dell'app di ricerca.

3. (Facoltativo) Fai clic sulle icone delle viste per passare da quella mobile a quella desktop.

4. Nella barra di ricerca, inserisci trains, quindi premi Invio per visualizzare i risultati relativi ai film sui treni.

Dati non strutturati

1. Nella pagina App, fai clic sul nome della nuova app.

2. Nel menu di navigazione, fai clic su Anteprima per eseguire il test dell'app di ricerca.

3. (Facoltativo) Fai clic sulle icone delle viste per passare da quella mobile a quella desktop.

4. Nella barra di ricerca, inserisci Google, quindi premi Invio per visualizzare i risultati.

Configurare il widget Ricerca

1. Nel menu di navigazione, fai clic su Configurazioni.

2. Nella scheda UI, configura le impostazioni per l'app di ricerca.

   Sono disponibili configurazioni della UI diverse per tipi di dati diversi. Per saperne di più, consulta Configurare i risultati per il widget Ricerca.

3. Se modifichi le configurazioni nella scheda UI, fai clic su Salva e pubblica.

4. Vai alla scheda Completamento automatico per configurare impostazioni specifiche per il completamento automatico.

   Per saperne di più, consulta Configurare il completamento automatico.

5. Vai alla scheda Avanzate per configurare le funzionalità avanzate.

   Per saperne di più, consulta Informazioni sulle funzionalità avanzate.

Esegui il deployment di un'app di ricerca

1. Nella pagina App, fai clic sul nome dell'app di cui vuoi eseguire il deployment.

2. Nel menu di navigazione, fai clic su Integrazione.

3. Assicurati che la scheda Widget sia selezionata.

4. Seleziona Basato su JWT o OAuth come tipo di autorizzazione del widget.

5. Nel campo Dominio, inserisci il nome di dominio della pagina web in cui inserire il widget. Ad esempio, se copi il widget nella pagina web example.com/ai.html, inserisci example.com come dominio.

6. Fai clic su Aggiungi e poi su Salva.

7. Copia lo snippet di codice fornito nella sezione Copia il seguente codice nella tua applicazione web.

8. Nel codebase, genera un token di autorizzazione.

9. Per passare il token di autorizzazione al widget, usa lo snippet di codice "Imposta token di autorizzazione" fornito nellaCopia il seguente codice nella tua applicazione web e sostituisci il testo <JWT or OAuth token provided by your backend> con il token di autorizzazione.

10. Testa l'app di cui è stato eseguito il deployment. Puoi modificare ulteriormente la configurazione seguendo i passaggi descritti in "Configura il widget Ricerca". Assicurati di fare clic su Salva e pubblica per applicare le modifiche al widget di cui è stato eseguito il deployment.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

1. Per evitare addebiti Google Cloud non necessari, utilizza la console Google Cloud per eliminare il progetto se non ti serve.
2. Se hai creato un nuovo progetto per prendere dimestichezza con Vertex AI Agent Builder, ma non ne hai più bisogno, elimina il progetto.
3. Se hai utilizzato un progetto Google Cloud esistente, elimina le risorse che hai creato per evitare addebiti sul tuo account. Per ulteriori informazioni, vedi Elimina un'app.
4. Segui i passaggi descritti in Disattivare Vertex AI Agent Builder.

Passaggi successivi

• Introduzione a Vertex AI Search
• Informazioni su dati, datastore ed engine