Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Conectar una fuente ServiceNow de datos Después de configurar la autenticación y almacenar sus credenciales en AWS Secrets Manager secreto, cree la fuente de ServiceNow datos en su base de conocimientos. En esta página se describe cómo crear la fuente de datos con la API Consola de administración de AWS o la API, seguida de una referencia para los parámetros del conector que puede configurar. **nota** Complete primero la configuración de la autenticación. Consulte [Configurar la autenticación de credenciales de cliente de OAuth 2.0 para ServiceNow](kb-managed-servicenow-oauth2-setup.md). Necesitas el ARN secreto. ## Cree la fuente de datos ------ #### [ Console ] **Para conectarse ServiceNow a su base de conocimientos gestionada** 1. Abra la consola de Amazon Bedrock en [ https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/). En el panel de navegación, seleccione ** Knowledge Bases ** y abra su base de conocimientos gestionada. 1. En Fuente de ** datos**, proporcione un nombre para la fuente de datos. 1. En la ** lista de tipos de fuente de ** datos, selecciona ** ServiceNow**. 1. En la URL del ** host**, introduce la URL de la ServiceNow instancia (por ejemplo,`https://{{INSTANCE}}.service-now.com`). 1. En ** Autenticación**, selecciona o crea un AWS Secrets Manager secreto que contenga tu `clientId``clientSecret`, y`instanceUrl`. 1. En el ámbito de la ** sincronización**, selecciona el contenido que quieres rastrear: artículos de conocimiento, elementos del catálogo de servicios y sus archivos adjuntos. También puede elegir si desea rastrear los elementos inactivos del catálogo de servicios y si desea restringir el rastreo únicamente a los artículos de conocimiento público. 1. (Opcional) Para limitar el rastreo, añada filtros de base de conocimientos, categorías de artículos de conocimiento o catálogos de servicios. ------ #### [ API ] Para crear una fuente de ServiceNow datos, envíe una [ CreateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) solicitud a un punto final en tiempo de compilación de Agents for Amazon Bedrock. El siguiente AWS Command Line Interface ejemplo crea una ServiceNow fuente de datos. Para obtener una descripción de cada campo, consulte la referencia de parámetros del conector que aparece a continuación. ``` aws bedrock-agent create-data-source \ --name "{{ServiceNow-connector}}" \ --knowledge-base-id "{{your-knowledge-base-id}}" \ --data-source-configuration file://servicenow-managed-connector.json ``` El `servicenow-managed-connector.json` archivo contiene lo siguiente: ``` { "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" } } } } ``` Los `dataEntityConfiguration` campos controlan las entidades que rastrea el conector. El `filterConfiguration` campo es opcional; utilícelo para rastrear bases de conocimiento, categorías de artículos de conocimiento o catálogos de servicios específicos, y para establecer un tamaño máximo de archivo. Sin filtros, el conector rastrea todos los artículos de conocimiento y del catálogo de servicios activos. En el caso de las bases de conocimiento administradas, `CreateDataSource` es asincrónico: el estado de la fuente de datos pasa de `CREATING` a `AVAILABLE` cuando se completa la operación. ------ ## Parámetros de conector La configuración de la fuente de datos usa los siguientes parámetros de conector. Dentro`connectorParameters`, `connectorType` defina `type` `SERVICENOW` y como`1`. `version` Para ver los campos que se `connectorParameters` agrupan (como `deletionProtectionConfiguration` y`mediaExtractionConfiguration`), consulte[Conexión de un origen de datos](kb-managed-connect-ds.md). En la tabla siguiente se describen los `connectionConfiguration` campos. **connectionConfiguration** | Campo | Obligatorio | Descripción | | --- | --- | --- | | secretArn | Sí | El ARN del AWS Secrets Manager secreto que contiene su clientIdclientSecret, yinstanceUrl. | | hostUrl | Sí | La URL de tu ServiceNow instancia (por ejemplo,https://{{INSTANCE}}.service-now.com). | | authType | Sí | El tipo de autenticación. ServiceNow soportesOAUTH2. Consulte [Método de autenticación](kb-managed-ds-servicenow.md#kb-managed-servicenow-auth-methods). | En la siguiente tabla se describen los `dataEntityConfiguration` campos que controlan las entidades que rastrea el conector. **datos EntityConfiguration** | Campo | Obligatorio | Descripción | | --- | --- | --- | | crawlKnowledgeArticles | Sí | Si se deben rastrear artículos de conocimiento (kb\_knowledge). | | crawlServiceCatalogs | Sí | Si se deben rastrear los artículos del catálogo de servicios ()sc\_cat\_item. | | crawlKnowledgeArticleAttachments | Sí | Si se deben rastrear los archivos adjuntos de los artículos de conocimiento. | | crawlServiceCatalogAttachments | Sí | Si se deben rastrear los archivos adjuntos de los artículos del catálogo de servicios. | | crawlInactiveServiceCatalogItems | Sí | Si se deben rastrear los elementos inactivos del catálogo de servicios. | | crawlPublicKnowledgeArticlesOnly | Sí | Si se debe restringir el rastreo únicamente a los artículos de conocimiento público. | En la siguiente tabla se describen los `filterConfiguration` campos opcionales que abarcan el rastreo. **Configuración del filtro (opcional)** | Campo | Obligatorio | Description (Descripción) | | --- | --- | --- | | knowledgeArticleFilter | No | Rastreo de artículos de conocimiento de Scopes. Contiene inclusionKnowledgeBaseSysIds (una lista de los ID de sistema de la base de conocimientos) y inclusionKnowledgeArticleCategorySysIds (una lista de los ID de sistema de las categorías de artículos de conocimiento). | | serviceCatalogFilter | No | Permite rastrear el catálogo de servicios de Scopes. Contiene inclusionServiceCatalogSysIds (una lista de los ID de sistema del catálogo de servicios) y inclusionServiceCatalogCategorySysIds (una lista de los ID de sistema de las categorías del catálogo de servicios). En instancias grandes, el filtrado por ID de sistema reduce considerablemente el tiempo de sincronización. | | maxFileSizeInMegaBytes | No | Tamaño máximo, en megabytes, de cualquier archivo individual que ingiera el conector. Proporciónelo como cadena numérica (por ejemplo,). "500" | ## Siguientes pasos Después de crear la fuente de datos, sincronícela para incorporar el contenido a la base de conocimientos. Para obtener más información, consulte [Sincronización de un origen de datos](kb-managed-sync.md). Como ServiceNow no admite el control de acceso a nivel de documento, todos los usuarios autenticados que pueden consultar la base de conocimientos pueden ver todo el contenido rastreado.