Créer une application

Cette page explique comment créer une application Gemini Enterprise.

Important : Si vous souhaitez utiliser des clés de chiffrement gérées par le client (CMEK) pour protéger les données de votre application, vous devez enregistrer votre clé CMEK avant de créer l'application. Les applications créées avant l'enregistrement de la clé ne sont pas protégées. Pour en savoir plus, consultez Clés de chiffrement gérées par le client.

Remarque : Vous ne pouvez pas connecter de datastores de sites Web à vos applications de recherche et d'assistance Gemini Enterprise.

Créer une application

Console

1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.
2. Sur la page Applications, cliquez sur Créer une application.
3. Dans le champ Nom de l'application, saisissez le nom de votre application.
4. Pour modifier l'ID d'application généré automatiquement, cliquez sur Modifier. L'ID de l'application ne peut pas être modifié après la création de l'application.
5. Dans la section Choisir un emplacement, sélectionnez Multirégional. Utilisez l'emplacement multirégional par défaut global (Global), sauf si vous devez limiter vos données à une zone géographique spécifique.

6. Facultatif. Développez Options avancées et configurez les éléments suivants :

   1. Dans le champ Nom de l'entreprise, saisissez le nom externe de votre entreprise, en omettant les suffixes tels que Inc ou LLC. Cela aide le LLM à identifier l'entreprise que l'application représente.

   2. Si vous connectez un data store Google Drive, vous pouvez autoriser l'application à rechercher des documents en dehors de votre organisation. Pour activer cette fonctionnalité, cochez la case Inclure les documents interdomaines.

      Avertissement : L'activation de cette fonctionnalité augmente les risques de sécurité, tels que l'injection de prompt à partir de documents externes et la manipulation des résultats de recherche.

7. Cliquez sur Créer.

REST

Avant de créer une application à l'aide de la ligne de commande, vous devez disposer d'un datastore existant. Si vous n'avez pas de data store, vous devez connecter une source de données Google ou une source de données tierce à votre application.

Pour utiliser la méthode engines.create afin de créer une application à partir de la ligne de commande, procédez comme suit :

1. Recherchez l'ID de votre data store. Si vous disposez déjà de l'ID de votre data store, passez à l'étape suivante.

   1. Dans la console Google Cloud , accédez à la page Gemini Enterprise et cliquez sur Datastores dans le menu de navigation.

      Accéder à la page "Datastores"

   2. Cliquez sur le nom de votre datastore.

   3. Sur la page Données de votre datastore, obtenez l'ID du datastore.

2. Créer une application et la connecter à un data store.

   Terme clé : Dans Gemini Enterprise, le terme app (application) peut être utilisé de manière interchangeable avec le terme engine (moteur) dans le contexte des API. Un moteur Gemini Enterprise est un moteur de recherche générique dont le champ app_type est défini sur 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"
   }'
   

   Remplacez les éléments suivants :

   • PROJECT_ID : par l'ID du projet.
   • APP_ID : ID de l'application que vous souhaitez créer.
   • APP_DISPLAY_NAME : nom à afficher de l'application que vous souhaitez créer.
   • DATA_STORE_ENTITY_ID : si votre data store contient des entités, utilisez les ID d'entité spécifiques. Si votre data store ne contient pas d'entités, utilisez l'ID du data store à la place.

   Vous pouvez inclure les configurations facultatives suivantes dans la charge utile JSON :

   • Pour fournir le nom externe de votre entreprise, incluez les éléments suivants :

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

     Remplacez COMPANY_NAME par le nom externe de votre entreprise, en omettant les suffixes tels que Inc ou LLC.

   • Si vous connectez un data store Google Drive, vous pouvez autoriser l'application à rechercher et à indexer des documents en dehors de votre organisation. Pour activer cette fonctionnalité, incluez les éléments suivants dans la charge utile JSON :

     "includeCrossDomainDocuments": true
     

     Avertissement : L'activation de cette fonctionnalité augmente l'exposition aux risques de sécurité, comme l'injection de prompt à partir de documents externes et la manipulation potentielle des résultats de recherche.

   Exemple de commande et résultat

   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"
     }
   }
   

Étapes suivantes

• Pour associer une application à un data store existant, consultez Associer une application à un datastore existant.

• Pour connecter vos sources de données, consultez Connecter une source de données Google et Connecter une source de données tierce.

• Pour prévisualiser les résultats de recherche, accédez à Configurations > UI de recherche dans la consoleGoogle Cloud ou consultez Obtenir des résultats de recherche à partir de StreamAssist.

• Pour configurer l'application Web, par exemple pour activer et désactiver des paramètres tels que le sélecteur de modèle et le générateur d'images, consultez Gérer les fonctionnalités de l'application Web.