View a markdown version of this page

Connecter une source ServiceNow de données - Amazon Bedrock

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Connecter une source ServiceNow de données

Après avoir configuré l'authentification et enregistré vos informations d'identification de manière AWS Secrets Manager secrète, créez la source de ServiceNow données dans votre base de connaissances. Cette page explique comment créer la source de données à l'aide de l'API Console de gestion AWS ou, suivie d'une référence pour les paramètres de connecteur que vous pouvez configurer.

Note

Terminez d'abord la configuration de l'authentification. Consultez Configurer l'authentification des informations d'identification du client OAuth 2.0 pour ServiceNow. Vous avez besoin de l'ARN secret.

Création de la source de données

Console
Pour vous connecter ServiceNow à votre base de connaissances gérée
  1. Ouvrez la console Amazon Bedrock à https://console.aws.amazon.com/bedrock/ l'adresse. Dans le volet de navigation, choisissez Bases de connaissances et ouvrez votre base de connaissances gérée.

  2. Sous Source de données, donnez un nom à votre source de données.

  3. Dans la liste Type de source de données, sélectionnez ServiceNow.

  4. Pour Host URL, entrez l'URL de votre ServiceNow instance (par exemple,https://INSTANCE.service-now.com).

  5. Sous Authentification, sélectionnez ou créez un AWS Secrets Manager secret contenant vos clientIdclientSecret, etinstanceUrl.

  6. Dans la zone de synchronisation, sélectionnez le contenu à analyser : articles de connaissances, éléments du catalogue de services et leurs pièces jointes. Vous pouvez également choisir d'explorer les éléments inactifs du catalogue de services et de limiter l'exploration aux seuls articles d'intérêt public.

  7. (Facultatif) Pour limiter l'exploration, ajoutez des filtres de base de connaissances, de catégorie d'article de connaissances ou de catalogue de services.

API

Pour créer une source de ServiceNow données, envoyez une CreateDataSource demande auprès d'un point de terminaison Agents for Amazon Bedrock build-time. L' AWS Command Line Interface exemple suivant crée une source ServiceNow de données. Pour une description de chaque champ, reportez-vous à la référence des paramètres du connecteur qui suit.

aws bedrock-agent create-data-source \ --name "ServiceNow-connector" \ --knowledge-base-id "your-knowledge-base-id" \ --data-source-configuration file://servicenow-managed-connector.json

Le servicenow-managed-connector.json fichier contient les éléments suivants :

{ "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR", "managedKnowledgeBaseConnectorConfiguration": { "connectorParameters": { "type": "SERVICENOW", "connectorType": "SERVICENOW", "version": "1", "connectionConfiguration": { "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-servicenow-creds", "authType": "OAUTH2", "hostUrl": "https://INSTANCE.service-now.com" }, "dataEntityConfiguration": { "crawlKnowledgeArticles": true, "crawlServiceCatalogs": true, "crawlKnowledgeArticleAttachments": true, "crawlServiceCatalogAttachments": true, "crawlInactiveServiceCatalogItems": false, "crawlPublicKnowledgeArticlesOnly": false }, "filterConfiguration": { "knowledgeArticleFilter": { "inclusionKnowledgeBaseSysIds": ["optional-kb-sys-id"], "inclusionKnowledgeArticleCategorySysIds": [] }, "serviceCatalogFilter": { "inclusionServiceCatalogSysIds": [], "inclusionServiceCatalogCategorySysIds": [] }, "maxFileSizeInMegaBytes": "500" } } } }

Les dataEntityConfiguration champs contrôlent les entités explorées par le connecteur. Le filterConfiguration champ est facultatif ; utilisez-le pour étendre l'analyse à des bases de connaissances, à des catégories d'articles de connaissances ou à des catalogues de services spécifiques, et pour définir une taille de fichier maximale. Sans filtres, le connecteur explore tous les articles de connaissances actifs et les éléments du catalogue de services.

Pour les bases de connaissances gérées, CreateDataSource est asynchrone : l'état de la source de données passe du statut de la source de données CREATING à la AVAILABLE fin de l'opération.

Paramètres du connecteur

La configuration de la source de données utilise les paramètres de connecteur suivants. DansconnectorParameters, réglez à la fois type et connectorType sur SERVICENOW et version réglez sur1. Pour les champs encapsulés connectorParameters (tels que deletionProtectionConfiguration etmediaExtractionConfiguration), consultezConnexion d’une sources de données.

Le tableau suivant décrit les connectionConfiguration champs.

connectionConfiguration
Champ Obligatoire Description
secretArn Oui L'ARN du AWS Secrets Manager secret contenant vosclientId,clientSecret, etinstanceUrl.
hostUrl Oui L'URL de votre ServiceNow instance (par exemple,https://INSTANCE.service-now.com).
authType Oui Type d'authentification. ServiceNow supportsOAUTH2. Consultez Méthode d’authentification.

Le tableau suivant décrit les dataEntityConfiguration champs qui contrôlent les entités explorées par le connecteur.

données EntityConfiguration
Champ Obligatoire Description
crawlKnowledgeArticles Oui S'il faut explorer les articles de connaissances (kb_knowledge).
crawlServiceCatalogs Oui S'il faut explorer les éléments du catalogue de services (sc_cat_item).
crawlKnowledgeArticleAttachments Oui S'il faut explorer les pièces jointes des articles de connaissances.
crawlServiceCatalogAttachments Oui S'il faut explorer les pièces jointes des éléments du catalogue de services.
crawlInactiveServiceCatalogItems Oui S'il faut explorer les éléments inactifs du catalogue de services.
crawlPublicKnowledgeArticlesOnly Oui S'il faut limiter l'exploration aux articles d'intérêt public uniquement.

Le tableau suivant décrit les filterConfiguration champs facultatifs qui définissent la portée de l'analyse.

Configuration du filtre (facultatif)
Champ Obligatoire Description
knowledgeArticleFilter Non Scopes Knowledge Article Crawling. Contient inclusionKnowledgeBaseSysIds (une liste des ID système de la base de connaissances) et inclusionKnowledgeArticleCategorySysIds (une liste des ID système des catégories d'articles de connaissances).
serviceCatalogFilter Non Analyse du catalogue de services Scopes. Contient inclusionServiceCatalogSysIds (une liste des ID système du catalogue de services) et inclusionServiceCatalogCategorySysIds (une liste des ID système des catégories du catalogue de services). Sur les instances de grande taille, le filtrage par ID système réduit considérablement le temps de synchronisation.
maxFileSizeInMegaBytes Non Taille maximale, en mégaoctets, de tout fichier ingéré par le connecteur. Fournissez-la sous forme de chaîne numérique (par exemple,"500").

Étapes suivantes

Après avoir créé la source de données, synchronisez-la pour intégrer le contenu dans votre base de connaissances. Pour en savoir plus, consultez Synchronisation d’une source de données. Comme il ServiceNow ne prend pas en charge le contrôle d'accès au niveau des documents, tous les utilisateurs authentifiés qui peuvent interroger la base de connaissances peuvent voir tout le contenu analysé.