Configurer un data store ServiceNow

Version Preview publique : les fonctionnalités de recherche et d'actions fédérées sont disponibles en version Preview publique. Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section Conditions générales du service des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Cette page explique comment créer un data store et connecter ServiceNow à Gemini Enterprise.

Avant de commencer

Avant de configurer votre connexion ServiceNow, assurez-vous de disposer des éléments suivants :

• 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 l'icône Modifier.
  3. Accordez le rôle Discovery Engine Editor à l'utilisateur. Pour en savoir plus, consultez Rôles et autorisations IAM.

• Configurer un compte ServiceNow et obtenir des identifiants d'authentification

• Configurez le rôle d'administrateur et utilisez le compte administrateur pour définir les rôles et autorisations utilisateur requis.

• Configurez un projet Google Cloud avec un compte administrateur capable de gérer les configurations au niveau de l'organisation, afin de vous assurer que l'organisation peut configurer un pool d'employés. Assurez-vous que votre organisation est configurée pour gérer un pool d'employés.

• Pour activer les fonctionnalités de recherche par mot clé, assurez-vous que l'indexation des tables est activée dans votre instance ServiceNow. Pour en savoir plus, consultez Configurer une table pour l'indexation et la recherche.

Créer un data store ServiceNow

Pour créer un datastore ServiceNow, 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 .

   Remarque : Pour accéder au flux unifié, votre projet doit figurer sur la liste d'autorisation.

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

4. Cliquez sur Créer un datastore.

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

6. Dans la section Données :

   1. Dans la section Mode du connecteur, sélectionnez Ingestion de données ou Recherche unifiée comme mode de connexion.

   2. Cliquez sur Continuer.

   3. Dans la section Paramètres d'authentification, configurez l'authentification en fonction du mode de connexion choisi.

      • Si vous avez sélectionné Recherche fédérée, saisissez les informations suivantes :

        • URL de l'instance : URL de base de votre instance ServiceNow.
        • ID client : ID client OAuth de votre application.
        • Code secret du client : code secret du client OAuth pour votre application.
        • URI d'authentification : URL du point de terminaison d'autorisation fournie par ServiceNow.
        • URI du jeton : URL du point de terminaison du jeton fournie par ServiceNow.
        • ID utilisateur : ID utilisateur ServiceNow.
        • Mot de passe : mot de passe de l'utilisateur ServiceNow.

      • Si vous avez sélectionné Ingestion de données, saisissez les informations suivantes :

        • URL de l'instance : URL de base de votre instance ServiceNow.
        • ID client : ID client OAuth de votre application.
        • Code secret du client : code secret du client OAuth pour votre application.
        • ID utilisateur : ID utilisateur ServiceNow.
        • Mot de passe : mot de passe de l'utilisateur ServiceNow.

        Pour en savoir plus sur les identifiants, consultez la section Configuration de ServiceNow.

      • Si vous avez sélectionné Recherche fédérée, cliquez sur Se connecter et connectez-vous à ServiceNow.

   4. Cliquez sur Continuer.

   5. Si vous avez sélectionné Recherche fédérée, procédez comme suit :

      1. Dans la section Destinations :
         1. Saisissez l'URL de l'instance de votre site ServiceNow.
         2. Saisissez l'URL de base de votre site ServiceNow.

      2. Cliquez sur Continuer.

      3. (Facultatif) Dans la section Options avancées, cochez la case Inclure les tables système pour afficher ou masquer les tables système ServiceNow.

      4. Cliquez sur Continuer.

   6. Si vous avez sélectionné Ingestion de données, procédez comme suit dans la section Options avancées :

      1. (Facultatif) Dans le champ Suffixe de l'URL, saisissez le suffixe de l'URL du lien vers le portail de connaissances ou de catalogue.
      2. Facultatif : Pour autoriser un ensemble d'adresses IP statiques dans votre système, cochez la case Enable static IP addresses (Activer les adresses IP statiques).
      3. Facultatif : Dans le champ RPS max., saisissez le nombre maximal de requêtes par seconde pour appliquer une limite de débit aux requêtes envoyées par le connecteur à l'instance ServiceNow.
      4. Cliquez sur Continuer.

   7. Dans la section Entités à rechercher (si vous avez sélectionné Recherche fédérée) ou Entités à synchroniser (si vous avez sélectionné Ingestion de données), sélectionnez toutes les entités requises.

      • Si vous avez sélectionné Recherche unifiée, passez à l'étape suivante.
      • Si vous avez sélectionné Ingestion de données, procédez comme suit :
        1. Facultatif : Vous pouvez synchroniser des projets spécifiques en procédant comme suit :
           1. Cliquez sur Filtrer.
           2. Cochez la case Exclure de l'index pour filtrer les entités de l'index ou Inclure dans l'index pour vous assurer qu'elles y sont incluses.
           3. Saisissez les clés. Appuyez sur Entrée après chaque clé.
           4. Cliquez sur Enregistrer.
        2. Pour configurer la planification de synchronisation, procédez comme suit :
           1. Dans la liste Fréquence de synchronisation, sélectionnez la fréquence de synchronisation.
              • Pour planifier des synchronisations complètes distinctes pour les données d'entité et d'identité, développez le menu sous Synchronisation complète, puis sélectionnez Options personnalisées.
           2. Dans la liste Fréquence de synchronisation incrémentielle, sélectionnez la fréquence de synchronisation incrémentielle. Pour en savoir plus, consultez Planification de synchronisation.

7. Cliquez sur Continuer.

8. Dans la section Actions :

   • Si vous avez sélectionné Recherche fédérée, dans Sélectionnez les actions ServiceNow à activer, sélectionnez les actions de la catégorie pour les activer pour le connecteur.

   • Si vous avez sélectionné Ingestion de données :

     1. Dans la section Paramètres d'authentification, configurez l'authentification en fonction du mode de connexion choisi.

     2. Fournissez les informations d'authentification suivantes, si nécessaire :

        • URL de l'instance : URL de base de votre instance ServiceNow.
        • ID client : ID client OAuth de votre application.
        • Code secret du client : code secret du client OAuth pour votre application.
        • URI d'authentification : URL du point de terminaison d'autorisation fournie par ServiceNow.
        • URI du jeton : URL du point de terminaison du jeton fournie par ServiceNow.
        • ID utilisateur : ID utilisateur ServiceNow.
        • Mot de passe : mot de passe de l'utilisateur ServiceNow.

        Pour en savoir plus sur les identifiants, consultez la section Configuration de ServiceNow.

     3. Cliquez sur Login (Se connecter) et connectez-vous à ServiceNow pour valider votre compte.

     4. Cliquez sur Continuer.

     5. (Facultatif) Dans la section Options avancées, cochez la case Inclure les tables système pour afficher ou masquer les tables système ServiceNow.

     6. Cliquez sur Continuer.

     7. Dans la section Destinations :

        1. Facultatif : Saisissez l'URL de l'instance de votre site ServiceNow.
        2. Facultatif : Saisissez l'URL de base de votre site ServiceNow.

     8. Cliquez sur Continuer.

     9. Dans Sélectionnez les actions ServiceNow à activer, sélectionnez les actions de la catégorie pour les activer pour le connecteur.

     Remarque : Si vous ignorez l'ajout d'actions à cette étape, vous devez créer un datastore pour ajouter des actions.

     Pour afficher la liste des actions, consultez Afficher 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 du 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 datastore 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 datastore passe de Création à Actif, le connecteur ServiceNow est prêt à être utilisé.

Pour un connecteur d'ingestion créé avec ServiceNow, l'état du data store passe de Création à En cours d'exécution lors du lancement de la synchronisation. Il passe ensuite à Actif une fois l'ingestion terminée, ce qui signifie que le datastore est entièrement configuré. Selon le volume de données, l'ingestion peut prendre plusieurs heures.

Après avoir créé le datastore, créez une application, associez-la au datastore ServiceNow et autorisez Gemini Enterprise à accéder à ServiceNow avant d'exécuter des requêtes.

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 datastore fédéré.

Exécution de la requête

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

• Gemini Enterprise envoie votre requête de recherche directement à l'API ServiceNow.
• 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 unifié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 (API ServiceNow).
• Ces tiers peuvent associer les requêtes à votre identité.
• Si plusieurs sources de données de recherche unifié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 à ServiceNow. 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 à l'API ServiceNow.

Étapes suivantes

• Pour fournir une interface utilisateur permettant d'interroger vos données ServiceNow, créez une application et associez-la au data store ServiceNow.
• Pour afficher la liste des actions, consultez Afficher les actions.
• 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 datastore, consultez Configurer des alertes pour les datastores tiers.