Inizia a utilizzare i suggerimenti generici

Inizia a utilizzare i suggerimenti generici

Nota: Questa funzionalità è un'offerta in anteprima, soggetta ai "Termini dell'offerta pre-GA" dei Termini di servizio specifici per Google Cloud. I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Per ulteriori informazioni, consulta descrizioni della fase di lancio. Utilizzando questa funzione, accetti i Termini e condizioni dell'anteprima dell'IA generativa ("Termini di anteprima"). Per questa funzionalità, puoi trattare i dati personali come descritto nell'Addendum per il trattamento dei dati Cloud, in conformità alle limitazioni e alle obbligazioni applicabili del Contratto (come definite nei Termini di anteprima).

Puoi creare rapidamente un'app di suggerimenti generici all'avanguardia basata sui tuoi dati in grado di suggerire contenuti simili a quelli che l'utente sta visualizzando.

Questo tutorial spiega come creare tre app di suggerimenti generici, ciascuna per un tipo diverso di dati:

• Dati non strutturati sotto forma di PDF importati da un bucket Cloud Storage
• Dati strutturati sotto forma di file NDJSON importati da un bucket Cloud Storage
• Dati dei siti web provenienti dagli URL da te forniti

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

---

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, 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, Cloud Storage APIs.

   Enable the APIs

Abilita 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

Questa procedura ti guida nella creazione di un data store e nel caricamento dei dati di esempio forniti. Fai clic sulla scheda del tipo di datastore che vuoi creare.

Dati sui siti web

Nota: per utilizzare i suggerimenti con un sito web, devi utilizzare un dominio di cui puoi verificare la proprietà. Se non hai un dominio, salta questa sezione.

1. Vai alla pagina Datastore.

2. Fai clic su Crea datastore.

3. Nella pagina Seleziona un'origine dati, scegli Contenuti dei siti web.

4. Nella pagina Specifica i siti web per il datastore, inserisci gli URL dei siti web che vuoi includere nell'app di suggerimenti. Includi un URL per riga, senza virgole.

5. Fai clic su Continua.

6. Nella pagina Configura il datastore, inserisci un nome visualizzato per il datastore, quindi fai clic su Crea.

7. Nella pagina Datastore, seleziona il nuovo datastore e fai clic su Crea per creare la tua app.

8. Nella pagina Dati, vai alla scheda Attività per visualizzare lo stato dell'importazione dei dati. Il messaggio Importazione completata viene visualizzato nella colonna Stato al termine del processo di importazione. Potrebbe essere necessario fare clic su Aggiorna per visualizzare il messaggio Importazione completata.

9. Fai clic sulla scheda Documenti per visualizzare i documenti importati.

Dati strutturati

1. Vai alla pagina Datastore.

2. Fai clic su Crea datastore.

3. Nella pagina Seleziona un'origine dati, scegli Cloud Storage.

4. Nella pagina Importa dati da Cloud Storage, seleziona Strutturati (JSONL).

5. Fai clic su File.

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

7. Fai clic su Continua.

8. Assegna le proprietà delle chiavi nel seguente modo:

   Nome campo	Proprietà della chiave
   homepage	uri
   original_title	title
   overview	description

   E fai clic su Continua.

9. Inserisci un nome visualizzato per il datastore e fai clic su Crea.

10. Fai clic sul nome del tuo datastore.

11. Nella pagina Dati, vai alla scheda Attività per visualizzare lo stato dell'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.

12. Fai clic sulla scheda Documenti per visualizzare i documenti importati.

Dati non strutturati

1. Vai alla pagina Datastore.

2. Fai clic su Crea datastore.

3. Nella pagina Seleziona un'origine dati, scegli Cloud Storage.

4. Nella pagina Importa dati da Cloud Storage, 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. Seleziona Documenti non strutturati, quindi fai clic su Continua.

7. Inserisci un nome per il datastore e fai clic su Crea.

8. Seleziona il datastore appena creato, poi fai clic su Crea per creare la tua app.

9. Nella pagina Dati del datastore, vai alla scheda Attività per visualizzare lo stato dell'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.

10. Fai clic sulla scheda Documenti per visualizzare i documenti importati.

Crea un'app

Successivamente, creerai un'app di consigli e collegherai il datastore che hai creato in precedenza.

1. Vai alla pagina App.

2. Fai clic su Crea app.

3. Nella pagina Crea app, seleziona Suggerimenti.

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

5. In Contenuti, assicurati che sia selezionata l'opzione Generico.

6. Fai clic su Continua.

7. Nell'elenco dei datastore, seleziona quello creato in precedenza.

8. Fai clic su Crea.

Visualizzare l'anteprima dell'app

Dati sui siti web

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

2. Fai clic sul campo URI. Viene visualizzato un elenco di URL dal tuo sito web.

3. Fai clic sull'URL della pagina web per la quale desideri suggerimenti. In alternativa, inserisci un URL del tuo sito web nel campo URL.

4. Fai clic su Ricevi suggerimenti. Viene visualizzato un elenco di URL per le pagine web suggerite.

5. Fai clic su un URL per visualizzare la pagina web.

Dati strutturati

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

2. Se viene visualizzato il messaggio "Potrai visualizzare l'anteprima del motore per suggerimenti qui. Stiamo ancora preparando il motore, quindi controlla di nuovo in seguito", attendi e aggiorna periodicamente la pagina. Potresti dover attendere alcune ore o fino al giorno successivo per visualizzare l'anteprima dei dati.

3. Fai clic sul campo ID documento. Viene visualizzato un elenco di ID documento.

4. Fai clic sull'ID del documento per il quale vuoi ricevere suggerimenti. In alternativa, inserisci un ID documento nel campo ID documento.

5. Fai clic su Ricevi suggerimenti. Viene visualizzato un elenco di documenti suggeriti.

6. Fai clic su un documento per visualizzarne i dettagli.

Dati non strutturati

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

2. Fai clic sul campo ID documento. Viene visualizzato un elenco di ID documento.

3. Fai clic sull'ID del documento per il quale vuoi ricevere suggerimenti. In alternativa, inserisci un ID documento nel campo ID documento.

4. Fai clic su Ricevi suggerimenti. Viene visualizzato un elenco di documenti suggeriti.

5. Fai clic su un documento per visualizzarne i dettagli.

esegui il deployment dell'app

Non esiste un widget dei suggerimenti per il deployment della tua app. Per eseguire il test dell'app prima del deployment:

1. Vai alla pagina Dati e copia un ID documento.

2. Vai alla pagina Integrazione. Questa pagina include un comando di esempio per il metodo servingConfigs.recommend nell'API REST.

3. Incolla l'ID documento che hai copiato in precedenza nel campo ID documento.

4. Lascia invariato il campo Pseudo ID utente.

5. Copia la richiesta di esempio ed eseguila in Cloud Shell.

   I risultati sono gli ID dei documenti consigliati in base al documento scelto.

Per assistenza nell'integrazione dell'app di suggerimenti nella tua app web, consulta gli esempi di codice per C#, Go, Java, Node.js, PHP e Ruby su Ricevere suggerimenti per un'app.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi per le 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 app e datastore