View a markdown version of this page

Conectar una fuente ServiceNow de datos - Amazon Bedrock
Cree la fuente de datosParámetros de conectorSiguientes pasos

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. 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/. En el panel de navegación, seleccione Knowledge Bases y abra su base de conocimientos gestionada.

  2. En Fuente de datos, proporcione un nombre para la fuente de datos.

  3. En la lista de tipos de fuente de datos, selecciona ServiceNow.

  4. En la URL del host, introduce la URL de la ServiceNow instancia (por ejemplo,https://INSTANCE.service-now.com).

  5. En Autenticación, selecciona o crea un AWS Secrets Manager secreto que contenga tu clientIdclientSecret, yinstanceUrl.

  6. 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.

  7. (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 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. DentroconnectorParameters, connectorType defina type SERVICENOW y como1. version Para ver los campos que se connectorParameters agrupan (como deletionProtectionConfiguration ymediaExtractionConfiguration), consulteConexión de un origen de datos.

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.

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. 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.