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ù, consulta Chiavi di crittografia gestite dal cliente.

Nota: non puoi collegare datastore di siti web alle tue app di ricerca e assistente 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 Multiregione. Utilizza la regione multipla predefinita global (Global), 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 LLC. In questo modo l'LLM può identificare l'azienda rappresentata dall'app.

   2. Se colleghi un datastore di Google Drive, puoi consentire all'app di cercare documenti all'esterno 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 prompt injection 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 alla tua app.

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

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

   1. Nella console Google Cloud , 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 engine nel contesto delle API. Un motore di 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 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 stai collegando un datastore di Google Drive, puoi consentire all'app di cercare e indicizzare i 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 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 Connetti un'app a un datastore esistente.

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

• Per visualizzare l'anteprima dei risultati di ricerca, vai a Configurazioni > UI di ricerca nella consoleGoogle Cloud o consulta Ottieni 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, consulta Gestisci le funzionalità dell'app web.