Crea un'app

Questa pagina descrive come creare un'app Gemini Enterprise.

Importante: se vuoi utilizzare le chiavi di crittografia gestite dal cliente (CMEK) per proteggere i dati della tua app, devi registrare la chiave CMEK prima di creare l'app. Le app create prima della registrazione della chiave rimangono non protette. Per saperne di più, vedi Chiavi di crittografia gestite dal cliente.

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

Crea un'app

Console

1. Nella Google Cloud console, 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 dell'app non può essere aggiornato dopo la creazione dell'app.
5. Nella sezione Scegli una località, seleziona una multiregione. Utilizza la multiregione globale (Global) predefinita, a meno che tu non debba limitare i dati a una regione geografica specifica.

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

   1. Nel campo Nome azienda, inserisci il nome esterno della tua azienda, omettendo i suffissi come Inc o LLC. In questo modo, il modello linguistico di grandi dimensioni 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 cross-domain.

      Avviso: l'attivazione di questa funzionalità aumenta i rischi per la sicurezza, come l'iniezione 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 avere un datastore esistente. Se non hai un datastore, devi collegare un'origine dati Google o un'origine dati di terze parti a lla tua app.

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

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 Gemini Enterprise 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.

   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 datastore non contiene entità, utilizza l'ID del 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 i suffissi come Inc o LLC.

   • Se stai collegando 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 collegare un'app a un datastore esistente, vedi Collegare un'app a un datastore esistente.

• Per collegare le origini dati, vedi Collegare un'origine dati Google e Collegare un'origine dati di terze parti.

• Per visualizzare l'anteprima dei risultati di ricerca, vai a Configurazioni > Interfaccia utente di ricerca nella Google Cloud console o consulta Ottenere i risultati di ricerca da 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.