Creare un'app di suggerimenti personalizzata

Nota: questa funzionalità è un'offerta in anteprima, soggetta ai "Termini delle offerte 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 le descrizioni della fase di lancio. Inoltre, utilizzando questa funzionalità, accetti i Termini e condizioni di 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).

Questa pagina descrive come creare un'app di suggerimenti personalizzati.

Console

Per utilizzare la console Google Cloud per creare un'app di consigli personalizzati, segui questi passaggi:

1. Nella Google Cloud console, vai alla pagina AI Applications.

   Applicazioni di AI

2. Nella pagina App, fai clic su Crea app.

3. Nella pagina Crea app, fai clic su Crea in Motore per suggerimenti.

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

5. (Facoltativo) Fai clic su Modifica per modificare l'ID app.

6. Fai clic su Continua.

7. Per connetterti a un datastore, nella pagina Datastore, seleziona un datastore che contenga dati strutturati o scegli di crearne uno. Esegui una di queste operazioni:

   • Seleziona un datastore esistente, se disponibile. Un datastore può essere collegato a una sola app e non può essere rimosso dall'app in un secondo momento.

   • Crea un nuovo datastore strutturato e inserisci i dati. Per farlo, fai clic su Crea datastore e segui i passaggi nel riquadro Crea un nuovo datastore che si apre. Poi seleziona il nuovo datastore. Per maggiori informazioni sulla creazione di un datastore, consulta Crea un datastore di suggerimenti personalizzati.

8. (Facoltativo) Per visualizzare un elenco di datastore non disponibili, fai clic su Scopri perché.

   Viene visualizzata una tabella con un elenco di datastore e il motivo per cui non sono disponibili. Ecco alcuni motivi per cui un datastore potrebbe non essere disponibile:

   • Il tipo di datastore consente la connessione a una sola app e il datastore è già connesso.
   • Il datastore e l'app si trovano in regioni diverse.
   • Il datastore e l'app sono di tipi diversi. Ad esempio, non puoi collegare un datastore dei contenuti multimediali a un'app di suggerimenti personalizzata.
   • Il tuo datastore dispone della ricerca di base sui siti web, mentre un'app di consigli personalizzati richiede un datastore con indicizzazione avanzata dei siti web.

9. Fai clic su Crea.

REST

Prima di utilizzare la riga di comando per creare un'app, devi disporre di un datastore esistente. Se non hai un datastore, creane uno seguendo i passaggi descritti in Creare un datastore di consigli personalizzati.

Nota: questa funzionalità è sperimentale.

Per utilizzare la riga di comando per creare un'app di consigli, segui questi passaggi:

1. Trova l'ID datastore. Se hai già l'ID del tuodatastorei, vai al passaggio successivo.

   1. Nella console Google Cloud , vai alla pagina AI Applications e nel menu di navigazione, fai clic su Data Stores.

      Vai alla pagina Datastore

   2. Fai clic sul nome del tuo datastore.

   3. Nella pagina Dati del datastore, recupera l'ID datastore.

2. Crea un'app e collegala a un datastore strutturato. Un datastore può essere collegato a una sola app e non può essere rimosso dall'app in un secondo momento.

   Termine chiave: in Vertex AI Search, il termine app può essere utilizzato in modo intercambiabile con il termine motore nel contesto delle API.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ID"],
     "solutionType": ["SOLUTION_TYPE_RECOMMENDATION"],
     "similarDocumentsConfig": {}
   }'
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo Google Cloud progetto.
   • APP_ID: l'ID dell'app di consigli che vuoi creare.
   • APP_DISPLAY_NAME: il nome visualizzato dell'app di consigli che vuoi creare.
   • DATA_STORE_ID: l'ID di un datastore di consigli esistente che vuoi aggiungere all'app di consigli.

Passaggi successivi

• Per visualizzare l'anteprima dell'aspetto dei consigli, consulta Ricevere consigli.