Crea un'app

Questa pagina descrive come creare un'app Gemini Enterprise.

Nota: non puoi connettere i datastore di 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 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 suffissi come Inc o LLC. In questo modo, l'LLM può identificare l'azienda rappresentata dall'app.

   2. Se stai connettendo 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 prompt injection da documenti esterni e 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 connettere un'origine dati Google o un'origine dati di terze parti a 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 fai clic su 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 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 suffissi come Inc o LLC.

   • Se stai connettendo 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 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 Google Cloud console o consulta Ottenere 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 Gestire le funzionalità dell'app web.