Creare un'app di suggerimenti generici

Console

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

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

   Agent Builder

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

3. Nella pagina Crea app, fai clic su Crea in Motore di consigli.

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 creato in precedenza o creane uno nuovo. 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 e importavi i dati. A tal fine, fai clic su Crea datastore e segui i passaggi nel riquadro Crea un nuovo datastore che si apre. Quindi seleziona il nuovo datastore. Per ulteriori informazioni sulla creazione di un datastore, consulta Creare un datastore di consigli generici.

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 il collegamento a una sola app e il datastore è già collegato.
   • Il tuo datastore e la tua app si trovano in regioni diverse.
   • Il tuo datastore e la tua app sono di tipi diversi. Ad esempio, non puoi collegare un datastore dei contenuti multimediali a un'app di suggerimenti generica.
   • Il tuo datastore dispone di una ricerca di base del sito web, mentre un'app di consigli generica 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 avere un datastore esistente. Se non hai un datastore, creane uno seguendo i passaggi descritti in Creare un datastore di suggerimenti generici.

Per utilizzare la riga di comando per creare un'app di consigli:

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

   1. Nella console Google Cloud, vai alla pagina Agent Builder e nel menu di navigazione fai clic su Data Store.

      Vai alla pagina Datastore

   2. Fai clic sul nome del tuo datastore.

   3. Nella pagina Dati del tuo datastore, ottieni l'ID datastore.

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

   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 progetto Google Cloud.
   • 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 dei consigli esistente che vuoi aggiungere all'app dei consigli.