Crea un'app di consigli personalizzati

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

Console

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

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

    AI Applications

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

  3. Nella pagina Crea app , fai clic 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 dell'app.

  6. Fai clic su Continua.

  7. Per connetterti a un datastore, nella pagina Datastore, seleziona un datastore contenente dati strutturati o scegli di crearne uno. Esegui una delle seguenti 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 di dati strutturati e inserisci i dati. Per farlo, 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 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. Di seguito sono riportati alcuni dei 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 connettere un datastore di contenuti multimediali a un'app di suggerimenti personalizzati.
    • Il datastore ha la ricerca di base sui siti web, mentre un'app di suggerimenti 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 avere un datastore esistente. Se non hai un datastore, creane uno seguendo i passaggi descritti in Creare un datastore di suggerimenti personalizzati.

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

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

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

      Vai alla pagina Datastore

    2. Fai clic sul nome del tuo datastore.

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

  2. Crea un'app e collegala a un datastore di dati strutturati. 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 Google Cloud progetto.
    • APP_ID: l'ID dell'app di suggerimenti che vuoi creare.
    • APP_DISPLAY_NAME: il nome visualizzato dell'app di suggerimenti che vuoi creare.
    • DATA_STORE_ID: l'ID di un datastore di suggerimenti esistente che vuoi aggiungere all'app di suggerimenti.

Passaggi successivi