Creare un'app di suggerimenti generica

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

In questa pagina viene descritto come creare un'app per suggerimenti generica.

Console

Per utilizzare la console Google Cloud per creare un'app di suggerimenti generica, 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, seleziona Suggerimenti.

4. Nel campo Nome dell'app, inserisci un nome per l'app. ID app viene visualizzato sotto il nome del motore.

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

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

7. Fai clic su Continua.

8. Per connetterti a un datastore, seleziona un datastore nella pagina Datastore creato in precedenza o crearne uno nuovo. Esegui una di queste operazioni:

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

   • Creare un nuovo datastore in cui importare i dati. Per farlo, fai clic Crea un datastore seguendo i passaggi della sezione Crea un nuovo del datastore. Quindi seleziona il nuovo datastore. Per maggiori informazioni informazioni sulla creazione di un datastore, vedi Creare dati generici sui suggerimenti Google Store.

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

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

   • Il tipo di datastore consente la connessione a una sola app e il datastore è già collegato.
   • Il datastore e l'app si trovano in regioni diverse.
   • Il datastore e l'app sono di tipi diversi. Ad esempio, non può collegare un datastore di contenuti multimediali a un'app di suggerimenti generica.
   • Il datastore offre una ricerca sul sito web di base, mentre una generica L'app di suggerimenti richiede un datastore con indicizzazione avanzata del sito web.

10. Fai clic su Crea.

REST

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

Nota: questa funzionalità è sperimentale.

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

1. Individua l'ID datastore. Se hai già un datastore ID, vai al passaggio successivo.

   1. Nella console Google Cloud, vai alla pagina Agent Builder e Nel menu di navigazione, fai clic su Datastore.

      Vai alla pagina Datastore

   2. Fai clic sul nome del datastore.

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

2. Creare un'app e collegarla a un datastore. Un data store può essere collegato a una sola app e non può essere rimosso dall'app in un secondo momento.

   Termine chiave: in Vertex AI Search, è possibile utilizzare il termine app 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 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.

Passaggi successivi

• Per visualizzare un'anteprima della visualizzazione dei consigli, consulta Ricevere consigli.