Créer une application

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

Remarque : Vous ne pouvez pas connecter de datastores de site 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 de l'application généré automatiquement, cliquez sur Modifier. L'ID de l'application ne peut pas être modifié une fois l'application créée.
5. Dans la section Choisir un emplacement, sélectionnez Multirégional. Utilisez la multirégion global (Monde) 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, 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é, comme 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 data store existant. Si vous n'avez pas de data store, vous devez associer 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. Trouvez 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, puis cliquez sur Data Stores dans le menu de navigation.

      Accéder à la page "Data stores"

   2. Cliquez sur le nom de votre data store.

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

2. Créez une application et associez-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 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 plutôt l'ID du data store.

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

   • Pour indiquer le nom externe de votre entreprise, incluez les informations suivantes :

     "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 data store 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 consoleGoogle Cloud ou consultez Obtenir des résultats de recherche à partir de StreamAssist.

• Pour configurer l'application Web, par exemple pour activer ou 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.