Configurer un data store Salesforce

Cette page explique comment créer un data store et associer Salesforce à Gemini Enterprise. Le data store recherche vos enregistrements Salesforce en temps réel et permet aux utilisateurs finaux d'agir sur ceux-ci en langage naturel.

Avant de commencer

Avant de configurer votre connexion Salesforce, procédez comme suit :

1. Attribuez le rôle d'éditeur Discovery Engine (roles/discoveryengine.editor). Ce rôle est nécessaire pour que l'utilisateur puisse créer le datastore. Pour attribuer ce rôle, procédez comme suit :

   1. Dans la console Google Cloud , accédez à la page IAM.

      Accéder à IAM

   2. Recherchez le compte utilisateur, puis cliquez sur edit Modifier.
   3. Accordez le rôle Discovery Engine Editor à l'utilisateur. Pour en savoir plus, consultez Rôles et autorisations IAM.

2. Demandez à votre administrateur Salesforce d'activer le serveur MCP SObject All dans l'organisation Salesforce à laquelle vous vous connectez, puis configurez la méthode d'authentification de votre choix :

   • OAuth 2.0 (géré par Google) (par défaut) : installez le package géré Gemini Enterprise – Connecteur Salesforce depuis Salesforce AppExchange dans cette organisation. Vous n'avez pas besoin d'un ID client ni d'un code secret du client.
   • OAuth 2.0 (Bring Your Own App) : créez une application cliente externe dans cette organisation et obtenez sa clé client (ID client) et son code secret client (Code secret du client).

   Tant que l'application OAuth n'est pas configurée, les utilisateurs ne peuvent pas autoriser le connecteur. Tant que le serveur MCP SObject All n'est pas actif, aucune action n'est disponible. Consultez Configuration de Salesforce.

3. Notez l'URL Mon domaine de votre organisation, par exemple https://example.my.salesforce.com. Vous le saisissez en tant qu'URI d'instance. Pour une organisation de bac à sable, utilisez le Mon domaine du bac à sable, par exemple https://example--sandbox.sandbox.my.salesforce.com.

Trouver l'URL de votre domaine

Pour trouver l'URL Mon domaine à saisir comme URI d'instance :

1. Dans Salesforce, accédez à Setup (Configuration).
2. Dans le champ Quick Find (Recherche rapide), recherchez et sélectionnez My Domain (Mon domaine).
3. Sous URL Mon domaine actuelle, copiez l'URL, par exemple https://example.my.salesforce.com.

Pour une organisation de bac à sable, effectuez cette opération dans le bac à sable. L'URL de Mon domaine ressemble à https://example--sandbox.sandbox.my.salesforce.com.

Créer le data store Salesforce

Pour créer le data store Salesforce, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

   Gemini Enterprise

2. Sélectionnez ou créez un projet Google Cloud .

3. Dans le menu de navigation, cliquez sur Datastores.

4. Cliquez sur Créer un datastore.

5. Dans la section Source, recherchez Salesforce, puis cliquez sur Sélectionner.

6. Dans la section Données :

   1. Sous Paramètres d'authentification, pour Sélectionner votre méthode d'authentification, choisissez l'une des options suivantes :

      • OAuth 2.0 (géré par Google) (par défaut) :
        1. Dans le champ URI de l'instance, saisissez l'URL de votre domaine Salesforce (par exemple, https://example.my.salesforce.com). Pour une organisation sandbox, saisissez votre domaine sandbox, par exemple https://example--sandbox.sandbox.my.salesforce.com.
      • OAuth 2.0 (Bring Your Own App) :
        1. Dans le champ URI de l'instance, saisissez l'URL de votre domaine Salesforce (par exemple, https://example.my.salesforce.com). Pour une organisation sandbox, saisissez votre domaine sandbox, par exemple https://example--sandbox.sandbox.my.salesforce.com.
        2. Dans le champ ID client, saisissez la clé client de votre application cliente externe Salesforce.
        3. Dans le champ Code secret du client, saisissez le code secret du client de votre application cliente externe Salesforce.
        4. Cliquez sur Vérifier l'authentification et connectez-vous à Salesforce pour valider vos identifiants OAuth.

   2. Sous Options avancées, si vous connectez une organisation de bac à sable, sélectionnez Utiliser le bac à sable. Salesforce diffuse ensuite les actions de votre organisation de bac à sable.

   3. Cliquez sur Continuer.

   4. Dans la section Entités à rechercher, sélectionnez les entités que vous souhaitez que Gemini Enterprise recherche. Pour Salesforce, sélectionnez Salesforce MCP.

7. Cliquez sur Continuer.

8. Facultatif : Dans la section Actions, sélectionnez les actions de création, de mise à jour et de suppression que vous souhaitez activer pour vos utilisateurs, ou laissez-les décochées pour que le connecteur reste en lecture seule (les actions en lecture seule sont activées par défaut). Vous pouvez également activer ou désactiver ces actions après avoir créé le data store. Consultez Activer les actions.

9. Cliquez sur Continuer.

10. Dans la section Configuration :

    1. Dans la liste Multirégional, sélectionnez l'emplacement de votre connecteur de données.
    2. Dans le champ Nom de votre connecteur de données, saisissez le nom de votre connecteur.
    3. Si vous avez sélectionné l'emplacement us ou eu, configurez les paramètres de chiffrement :
       • Facultatif : Si vous n'avez pas configuré de clés à région unique, cliquez sur Accéder à la page des paramètres pour le faire. Pour en savoir plus, consultez Enregistrer une clé à région unique pour les connecteurs tiers.
       • Sélectionnez Clé de chiffrement gérée parGoogle ou Clé Cloud KMS.
       • Si vous avez sélectionné Clé Cloud KMS :
         • Dans la liste Type de gestion des clés, sélectionnez le type approprié.
         • Dans la liste Clé Cloud KMS, sélectionnez la clé.
       Pour en savoir plus, consultez Clés de chiffrement gérées par le client.

11. Cliquez sur Continuer.

12. Dans la section Facturation, sélectionnez Tarification générale ou Tarification configurable. Pour en savoir plus, consultez Vérifier l'état de facturation de vos projets et Licences.

13. Cliquez sur Créer. Gemini Enterprise crée votre data store et l'affiche sur la page Datastores.

Sur la page Datastores, cliquez sur le nom de votre datastore pour afficher l'état. Une fois que l'état du data store passe de Création à Actif, le data store Salesforce est prêt à être utilisé.

Après avoir créé le data store, connectez-le à une application existante ou créez une application et connectez-le à la nouvelle application, puis autorisez Gemini Enterprise à accéder à Salesforce avant d'exécuter des requêtes.

Remarque : L'étape Autoriser redirige chaque utilisateur vers la page de connexion Salesforce de votre organisation pour accorder à l'application OAuth les champs d'application mcp_api et refresh_token. Cette étape échoue si le package géré Gemini Enterprise (pour OAuth 2.0 (géré par Google)) ou votre application OAuth personnalisée (pour OAuth 2.0 (Bring Your Own App)) n'est pas configuré dans cette organisation, ou si le profil de l'utilisateur n'a pas accès à l'application. La configuration d'une adresse IP statique par datastore n'est pas possible. La règle d'adresse IP de connexion pour l'authentification et les appels d'actualisation des jetons est configurée sur l'application dans Salesforce, et les appels de données sont autorisés à l'aide du jeton d'accès valide de l'utilisateur. Consultez Définir la règle d'adresse IP de connexion pour l'application.

Activer les actions

Lorsque vous créez un data store Salesforce, ses actions sont préremplies dans le data store. Les actions en lecture seule (Requête SOQL, Rechercher, Obtenir le schéma d'objet, Obtenir les enregistrements associés, Lister les enregistrements Sobject récents et Obtenir les informations utilisateur) sont activées par défaut et toujours disponibles. Les actions qui créent, mettent à jour ou suppriment des enregistrements (Créer un enregistrement Sobject, Mettre à jour un enregistrement Sobject, Mettre à jour un enregistrement associé, Supprimer un enregistrement Sobject et Supprimer un enregistrement associé) sont désactivées par défaut.

Si vous n'avez pas activé les actions de création, de mise à jour ou de suppression lors de la création du data store, vous pouvez les activer à tout moment en procédant comme suit :

1. Dans la console Google Cloud , accédez à votre data store Salesforce.

2. Sélectionnez l'onglet Actions.

3. Sélectionnez les actions que vous souhaitez activer (Créer un enregistrement Sobject, Mettre à jour un enregistrement Sobject, Mettre à jour un enregistrement associé, Supprimer un enregistrement Sobject ou Supprimer un enregistrement associé). Pour que le connecteur reste en lecture seule, ne sélectionnez pas ces actions.

4. Cliquez sur Activer les actions.

Pour obtenir la liste des actions, consultez Actions compatibles.

Traitement des données et exécution de la requête

Cette section décrit comment Gemini Enterprise gère votre requête et les implications en termes de confidentialité de l'utilisation du data store fédéré.

Exécution de la requête

Après avoir autorisé Salesforce et envoyé une requête de recherche à Gemini Enterprise :

• Gemini Enterprise envoie votre requête de recherche directement au serveur MCP Salesforce.
• Gemini Enterprise fusionne les résultats avec ceux des autres sources de données connectées et affiche un résultat de recherche complet.

Traitement des données

Lorsque vous utilisez la recherche fédérée tierce, les règles de traitement des données suivantes s'appliquent :

• Votre chaîne de requête est envoyée au backend de recherche tiers (serveur MCP Salesforce).
• Ces tiers peuvent associer les requêtes à votre identité.
• Si plusieurs sources de données de recherche fédérée sont activées, la requête peut être envoyée à chacune d'elles.
• Une fois les données transférées vers le système tiers, elles sont régies par les conditions d'utilisation et les règles de confidentialité de ce système.

Remarque : Pour améliorer la précision, un LLM peut réécrire votre requête avant de l'envoyer à Salesforce. Cette requête réécrite peut inclure des informations provenant de l'historique des requêtes de votre session. Par conséquent, des parties de votre historique des requêtes peuvent également être incluses dans la requête envoyée au serveur MCP Salesforce.

Étapes suivantes

• Pour fournir une interface utilisateur permettant d'interroger vos données Salesforce, créez une application et associez-la au datastore Salesforce.
• Pour prévisualiser l'apparence de vos résultats de recherche une fois votre application configurée, consultez Obtenir des résultats de recherche.
• Pour activer les alertes pour le data store, consultez Configurer des alertes pour les datastores tiers.