Crea un'app

Questa pagina descrive come creare un'app Gemini Enterprise.

Nota: non puoi connettere i datastore di siti web alle tue app di ricerca e assistenza Gemini Enterprise.

Crea un'app

Console

1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.
2. Nella pagina App, fai clic su Crea app.
3. Nel campo Nome app, inserisci un nome per l'app.
4. Per aggiornare l'ID dell'app generato automaticamente, fai clic su Modifica. L'ID app non può essere aggiornato dopo la creazione dell'app.
5. Nella sezione Scegli una località, seleziona una multi-regione. Utilizza la multiregione globale (Global) predefinita, a meno che tu non debba limitare i dati a un'area geografica specifica.

6. Facoltativo. Espandi Opzioni avanzate e configura quanto segue:

   1. Nel campo Nome dell'azienda, inserisci il nome esterno della tua azienda, omettendo suffissi come Inc. o S.r.l. In questo modo, il LLM può identificare l'azienda rappresentata dall'app.

   2. Se stai collegando un datastore Google Drive, puoi consentire all'app di cercare documenti al di fuori della tua organizzazione. Per attivare questa funzionalità, seleziona la casella di controllo Includi documenti interdominio.

      Avviso: l'attivazione di questa funzionalità aumenta i rischi per la sicurezza, come l'injection di prompt da documenti esterni e la manipolazione dei risultati di ricerca.

7. 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, devi collegare un'origine dati Google o un'origine dati di terze parti alla tua app.

Per utilizzare il metodo engines.create per creare un'app dalla riga di comando, segui questi passaggi:

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

   1. Nella console Google Cloud , vai alla pagina Gemini Enterprise e fai clic su Data Stores (Datastore) nel menu di navigazione.

      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.

   Termine chiave: in Gemini Enterprise, il termine app può essere utilizzato in modo intercambiabile con il termine motore nel contesto delle API. Un motore Gemini Enterprise è un motore di ricerca generico in cui il campo app_type è impostato su APP_TYPE_INTRANET.

   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/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ENTITY_ID_1", "DATA_STORE_ENTITY_ID_2", "DATA_STORE_ENTITY_ID_3"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "industryVertical": "GENERIC",
     "appType": "APP_TYPE_INTRANET"
   }'
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto.
   • APP_ID: l'ID dell'app che vuoi creare.
   • APP_DISPLAY_NAME: il nome visualizzato dell'app che vuoi creare.
   • DATA_STORE_ENTITY_ID: se il datastore contiene entità, utilizza gli ID entità specifici. Se il tuo datastore non contiene entità, utilizza l'ID datastore.

   Puoi includere le seguenti configurazioni facoltative nel payload JSON:

   • Per fornire il nome esterno della tua azienda, includi quanto segue:

     "commonConfig": {
       "companyName": "COMPANY_NAME"
     }
     

     Sostituisci COMPANY_NAME con il nome esterno della tua azienda, omettendo suffissi come Inc. o LLC.

   • Se colleghi un datastore Google Drive, puoi consentire all'app di cercare e indicizzare documenti al di fuori della tua organizzazione. Per attivare questa funzionalità, includi quanto segue nel payload JSON:

     "includeCrossDomainDocuments": true
     

     Avviso: l'attivazione di questa funzionalità aumenta l'esposizione a rischi per la sicurezza, come la prompt injection da documenti esterni e la potenziale manipolazione dei risultati di ricerca.

   Esempio di comando e risultato

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
   -d '{
     "displayName": "my-app",
     "dataStoreIds": ["slack_1234567890123_conversation", "slack_1234567890123_file", "slack_1234567890123_message"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "industryVertical": "GENERIC",
     "appType": "APP_TYPE_INTRANET"
   }'
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/operations/create-engine-12345678901234567890",
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.Engine",
       "name": "projects/123456/locations/global/collections/default_collection/engines/my-app",
       "displayName": "my-app",
       "dataStoreIds": [
         "slack_1234567890123_conversation",
         "slack_1234567890123_file",
         "slack_1234567890123_message"
       ],
       "solutionType": "SOLUTION_TYPE_SEARCH",
       "searchEngineConfig": {
         "searchTier": "SEARCH_TIER_STANDARD"
       },
       "industryVertical": "GENERIC",
       "appType": "APP_TYPE_INTRANET"
     }
   }
   

Passaggi successivi

• Per connettere un'app a un datastore esistente, consulta Connettere un'app a un datastore esistente.

• Per connettere le origini dati, consulta Connettere un'origine dati Google e Connettere un'origine dati di terze parti.

• Per visualizzare l'anteprima dei risultati di ricerca, vai a Configurazioni > Interfaccia utente di ricerca nella consoleGoogle Cloud o consulta Visualizzare i risultati di ricerca di StreamAssist.

• Per configurare l'app web, ad esempio per attivare e disattivare impostazioni come il selettore di modelli e il generatore di immagini, vedi Gestire le funzionalità dell'app web.