Créer une application

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

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

Créer une application

Console

1. Dans la Google Cloud console, accédez à la Gemini Enterprise page.
2. Sur la page Applications, cliquez sur Créer une application.
3. Dans le champ Nom de l'application, saisissez un nom pour votre application.
4. Pour modifier l'ID de l'application généré automatiquement, cliquez sur Modifier. L'ID de l'application ne peut pas être modifié après sa création.
5. Dans la section Choisir un emplacement, sélectionnez une zone multirégionale. Utilisez la zone multirégionale mondiale (Global) par défaut, 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, sans les suffixes tels que "Inc." ou "LLC". Cela permet au LLM d'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 d'utiliser la ligne de commande pour créer une application, vous devez disposer d'un datastore existant. Si vous n'en avez pas, vous devez connecter une source de données Google ou une source de données tierce à votre application.

Pour utiliser la engines.create méthode 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 le connaissez déjà, passez à l'étape suivante.

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

      Accéder à la page "Datastores"

   2. Cliquez sur le nom de votre data store.

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

2. Créez une application et connectez-la à un data store.

   Terme clé : Dans Gemini Enterprise, le terme application peut être utilisé de manière interchangeable avec le terme moteur dans le contexte des API. Un moteur Gemini Enterprise est un moteur de recherche générique dans lequel 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 : par l'ID de l'application que vous souhaitez créer.
   • APP_DISPLAY_NAME : par le 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 plutôt l'ID du data store.

   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, sans 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 option 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"
     }
   }
   

Étape suivante

• Pour connecter une application à un data store existant, consultez Connecter 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 > Interface utilisateur de recherche dans la Google Cloud console 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.