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](kb-managed-servicenow-oauth2-setup.md). 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/ ](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. 1. Sous Source de ** données**, donnez un nom à votre source de données. 1. Dans la ** liste Type de source de ** données, sélectionnez ** ServiceNow**. 1. Pour ** Host URL**, entrez l'URL de votre ServiceNow instance (par exemple,`https://{{INSTANCE}}.service-now.com`). 1. Sous ** Authentification**, sélectionnez ou créez un AWS Secrets Manager secret contenant vos `clientId``clientSecret`, et`instanceUrl`. 1. 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. 1. (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 ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 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. Dans`connectorParameters`, réglez à la fois `type` et `connectorType` sur `SERVICENOW` et `version` réglez sur`1`. Pour les champs encapsulés `connectorParameters` (tels que `deletionProtectionConfiguration` et`mediaExtractionConfiguration`), consultez[Connexion d’une sources de données](kb-managed-connect-ds.md). 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](kb-managed-ds-servicenow.md#kb-managed-servicenow-auth-methods). | 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](kb-managed-sync.md). 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é.