ServiceNow connecteur V2.0

Connectez-vous à la Amazon Kendra console Console de gestion AWS et ouvrez-la.

Dans le volet de navigation de gauche, choisissez Index, puis choisissez l'index que vous souhaitez utiliser dans la liste des index.

Sur la page Mise en route, choisissez Ajouter une source de données.

Sur la page Ajouter une source de données, choisissez ServiceNow connecteur, puis choisissez Ajouter un connecteur. Si vous utilisez la version 2 (le cas échéant), choisissez le ServiceNow connecteur avec la balise V2.0 « ».

Sur la page Spécifier les détails de la source de données, entrez les informations suivantes :

1. Dans Nom et description, pour Nom de la source de données —Entrez un nom pour votre source de données. Vous pouvez inclure des traits d'union mais pas des espaces.

2. (Facultatif) Description —Entrez une description facultative pour votre source de données.

3. Dans la langue par défaut  : choisissez une langue pour filtrer vos documents en vue de l'index. Sauf indication contraire de votre part, la langue par défaut est l'anglais. La langue spécifiée dans les métadonnées du document remplace la langue sélectionnée.

4. Dans Tags, pour Ajouter une nouvelle étiquette  : incluez des balises facultatives pour rechercher et filtrer vos ressources ou suivre vos AWS coûts.

5. Choisissez Suivant.

Sur la page Définir l'accès et la sécurité, entrez les informations suivantes :

1. ServiceNow host —Entrez l'URL de l' ServiceNowhôte. Le format de l'URL de l'hôte que vous entrez estyour-domain.service-now.com.

2. ServiceNow version  : sélectionnez la version de votre ServiceNow instance. Vous pouvez choisir entre Rome, Sandiego, Tokyo ou autres.

3. Autorisation  : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous possédez une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL spécifie les documents auxquels les utilisateurs et les groupes peuvent accéder. Les informations ACL sont utilisées pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Pour plus d'informations, consultez la section Filtrage contextuel des utilisateurs.

4. Authentification  : choisissez entre l'authentification de base et l'authentification Oauth 2.0.

5. AWS Secrets Manager secret —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations ServiceNow d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre. Saisissez les informations suivantes dans la fenêtre :

   1. Nom du secret : nom de votre secret. Le préfixe « AmazonKendra-ServiceNow - » est automatiquement ajouté à votre nom secret.

   2. Si vous utilisez l'authentification de base, entrez le nom secret, le nom d'utilisateur et le mot de passe de votre compte. ServiceNow

      Si vous utilisez l' OAuth2.0 authentification : entrez le nom secret, le nom d'utilisateur, le mot de passe , l'ID client et le code secret client que vous avez créés dans votre compte. ServiceNow

   3. Enregistrez et ajoutez votre secret.

6. Virtual Private Cloud (VPC)  : vous pouvez choisir d'utiliser un VPC. Si c'est le cas, vous devez ajouter des sous-réseaux et des groupes de sécurité VPC.

7. Identity crawler  : indiquez si vous souhaitez activer le robot Amazon Kendra d'identification. Le robot d'identification utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez d'utiliser votre ACL, vous pouvez également choisir d'activer le robot Amazon Kendra d'identification pour configurer le filtrage contextuel des résultats de recherche par utilisateur. Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'PutPrincipalMappingAPI pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.

8. IAM rôle  : choisissez un IAM rôle existant ou créez-en un nouveau IAM pour accéder aux informations d'identification de votre référentiel et indexer le contenu.

   Note

   IAM les rôles utilisés pour les index ne peuvent pas être utilisés pour les sources de données. Si vous ne savez pas si un rôle existant est utilisé pour un index ou une FAQ, choisissez Créer un nouveau rôle pour éviter les erreurs.

9. Choisissez Suivant.

Sur la page Configurer les paramètres de synchronisation, entrez les informations suivantes :

1. Pour les Articles de connaissances, choisissez l’une des options suivantes :

   • Articles de connaissances  : choisissez d'indexer les articles de connaissances.

   • Pièces jointes aux articles de connaissances  : choisissez d'indexer les pièces jointes aux articles de connaissances.

   • Type d'articles de connaissances  : choisissez entre uniquement les articles publics et les articles de connaissances en fonction d'une requête de ServiceNow filtre basée sur votre cas d'utilisation. Si vous sélectionnez Inclure les articles en fonction d'une requête de ServiceNow filtre, vous devez saisir une requête de filtre copiée depuis votre ServiceNow compte. Les exemples de requêtes de filtre incluent :workflow_state=draft^EQ,kb_knowledge_base=dfc19531bf2021003f07e2c1ac0739ab^text ISNOTEMPTY^EQ,article_type=text^active=true^EQ.

     Important

     Si vous choisissez d'explorer uniquement les articles publics, Amazon Kendra analyse uniquement les articles de connaissances auxquels un rôle d'accès public a été attribué. ServiceNow

   • Inclure des articles en fonction d'un filtre de description courte  : spécifiez des modèles d'expressions régulières pour inclure ou exclure des articles spécifiques.

2. Pour les Éléments du catalogue de services :

   • Éléments du catalogue de services  : choisissez d'indexer les éléments du catalogue de services.

   • Pièces jointes aux éléments du catalogue de services  : choisissez d'indexer les pièces jointes aux éléments du catalogue de services.

   • Éléments du catalogue de services actifs  : choisissez d'indexer les éléments du catalogue de services actifs.

   • Éléments du catalogue de services inactifs  : choisissez d'indexer les éléments inactifs du catalogue de services.

   • Requête de filtre  : choisissez d'inclure des éléments du catalogue de services en fonction d'un filtre défini dans votre ServiceNow instance. Les exemples de requêtes de filtre incluent :short_descriptionLIKEAccess^category=2809952237b1300054b6a3549dbe5dd4^EQ,nameSTARTSWITHService^active=true^EQ.

   • Inclure les éléments du catalogue de services en fonction d'un filtre de description courte  : spécifiez un modèle d'expression régulière pour inclure des éléments de catalogue spécifiques.

3. Pour les Incidents :

   • Incidents  : choisissez d'indexer les incidents de service.

   • Pièces jointes aux incidents  : choisissez d'indexer les pièces jointes aux incidents.

   • Incidents actifs  : choisissez d'indexer les incidents actifs.

   • Incidents inactifs  : choisissez d'indexer les incidents inactifs.

   • Type d'incident actif  : choisissez entre Tous les incidents, Incidents ouverts, Incidents ouverts - incidents non attribués et Incidents résolus en fonction de votre cas d'utilisation.

   • Requête de filtre  : choisissez d'inclure les incidents en fonction d'un filtre défini dans votre ServiceNow instance. Les exemples de requêtes de filtre incluent :short_descriptionLIKETest^urgency=3^state=1^EQ,priority=2^category=software^EQ .

   • Inclure les incidents en fonction d'un filtre de description courte  : spécifiez un modèle d'expression régulière pour inclure des incidents spécifiques.

4. Pour une configuration supplémentaire  :

   • Informations ACL  : les listes de contrôle d'accès pour les entités que vous avez sélectionnées sont incluses par défaut. La désélection d'une liste de contrôle d'accès rendra publics tous les fichiers de cette catégorie. Les options ACL sont automatiquement désactivées pour les entités non sélectionnées. Pour les articles publics, l'ACL n'est pas appliquée.

   • Pour Taille de fichier maximale  : spécifiez la limite de taille de fichier en Mo qu'Amazon Kendra analysera. Amazon Kendra analysera uniquement les fichiers dont la taille ne dépasse pas la limite que vous avez définie. La taille de fichier par défaut est de 50 Mo. La taille de fichier maximale doit être supérieure à 0 Mo et inférieure ou égale à 50 Mo.

   • Modèles de regex de pièces jointes  : ajoutez des modèles d'expressions régulières pour inclure ou exclure certains fichiers joints de catalogues, d'articles de connaissances et d'incidents. Vous pouvez ajouter jusqu’à 100 modèles.

5. Mode de synchronisation  : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données si votre synchronisation initiale a échoué, même si vous n'avez pas sélectionné la synchronisation complète comme mode de synchronisation.

   • Synchronisation complète : indexez récemment tout le contenu, en remplaçant le contenu existant chaque fois que votre source de données est synchronisée avec votre index.

   • Synchronisation des contenus nouveaux, modifiés et supprimés : indexez uniquement le contenu nouveau, modifié et supprimé chaque fois que votre source de données est synchronisée avec votre index. Amazon Kendra peut utiliser le mécanisme de votre source de données pour suivre les modifications de contenu et indexer le contenu modifié depuis la dernière synchronisation.

6. Dans Synchroniser le calendrier d'exécution, pour Fréquence  : choisissez la fréquence à laquelle vous souhaitez synchroniser le contenu de votre source de données et mettre à jour votre index.

7. Choisissez Suivant.

Sur la page Définir les mappages de champs, entrez les informations suivantes :

1. Mappages de champs par défaut  : sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés que vous souhaitez mapper à votre index.

2. Ajouter un champ —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.

3. Choisissez Suivant.

Sur la page Réviser et créer, vérifiez que les informations que vous avez saisies sont correctes, puis sélectionnez Ajouter une source de données. Vous pouvez également choisir de modifier vos informations depuis cette page. Votre source de données apparaîtra sur la page Sources de données une fois que la source de données aura été ajoutée avec succès.