View a markdown version of this page

ServiceNow conector V1.0 - Amazon Kendra
Características admitidasRequisitos previosInstrucciones de conexiónMás información

Amazon Kendra ya no está abierto a nuevos clientes. Para obtener capacidades similares a Amazon Kendra, consulte las bases de conocimiento de Amazon Bedrock. Más información.

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.

ServiceNow conector V1.0

ServiceNow proporciona un sistema de administración de servicios basado en la nube para crear y administrar los flujos de trabajo a nivel de la organización, como los servicios de TI, los sistemas de venta de entradas y el soporte. Puede usarlo Amazon Kendra para indexar sus ServiceNow catálogos, artículos de conocimiento y sus archivos adjuntos.

nota

ServiceNow V1.0 El ServiceNowConfiguration conector/API finalizó en 2023. Recomendamos migrar a la TemplateConfiguration API ServiceNow connector V2.0 /o utilizarla.

Para solucionar problemas con el conector de la fuente de Amazon Kendra ServiceNow datos, consulteSolución de problemas con los orígenes de datos.

Características admitidas

Amazon Kendra ServiceNow El conector de fuente de datos admite las siguientes funciones:

  • ServiceNow versiones de instancia: Londres, otras

  • Inclusion/exclusion patrones: catálogos de servicios, artículos de conocimiento y sus archivos adjuntos

Requisitos previos

Antes de poder utilizarla Amazon Kendra para indexar la fuente de ServiceNow datos, realice estos cambios en sus AWS cuentas ServiceNow y.

En ServiceNow, asegúrate de tener:

  • Has creado una cuenta de ServiceNow administrador y has creado una ServiceNow instancia.

  • Has copiado el host de la URL de tu ServiceNow instancia. Por ejemplo, si la URL de la instancia eshttps://your-domain.service-now.com, el formato de la URL del host que introduzcas esyour-domain.service-now.com.

  • Tomó nota de sus credenciales de autenticación básicas, que contienen un nombre de usuario y una contraseña Amazon Kendra para poder conectarse a la ServiceNow instancia.

    nota

    Le recomendamos que actualice o modifique con regularidad las credenciales y el secreto. Por su propia seguridad, proporcione solo el nivel de acceso necesario. No se recomienda volver a utilizar las credenciales y los datos secretos en varios orígenes de datos ni en las versiones 1.0 y 2.0 del conector (si procede).

  • Opcional: configuré un token de credenciales de OAuth 2.0 que puede identificar Amazon Kendra y generar un nombre de usuario, una contraseña, un ID de cliente y un secreto de cliente. El nombre de usuario y la contraseña deben permitir el acceso a la base de ServiceNow conocimientos y al catálogo de servicios. Consulte ServiceNow la documentación sobre la autenticación de OAuth 2.0 para obtener más información.

  • Ha agregado los siguientes permisos:

    • kb_category

    • kb_knowledge

    • kb_knowledge_base

    • kb_uc_cannot_read_mtom

    • kb_uc_can_read_mtom

    • sc_catalog

    • sc_category

    • sc_cat_item

    • sys_attachment

    • sys_attachment_doc

    • sys_user_role

  • Se ha marcado que cada documento sea único en ServiceNow las demás fuentes de datos que planeas usar para el mismo índice y entre ellas. Cada origen de datos que desee utilizar para un índice no debe contener el mismo documento en varios orígenes de datos. Los ID de documento son globales para un índice y deben ser únicos por índice.

En su Cuenta de AWS, asegúrese de tener:

  • Creaste un Amazon Kendra índice y, si usaste la API, anotaste el ID del índice.

  • Creó una IAM función para su fuente de datos y, si utilizaba la API, anotó el ARN de la IAM función.

    nota

    Si cambias el tipo de autenticación y las credenciales, debes actualizar tu IAM rol para acceder al ID AWS Secrets Manager secreto correcto.

  • ServiceNow Guardaste tus credenciales de autenticación en un AWS Secrets Manager secreto y, si utilizabas la API, anotaste el ARN del secreto.

    nota

    Le recomendamos que actualice o modifique con regularidad las credenciales y el secreto. Por su propia seguridad, proporcione solo el nivel de acceso necesario. No se recomienda volver a utilizar las credenciales y los datos secretos en varios orígenes de datos ni en las versiones 1.0 y 2.0 del conector (si procede).

Si no tienes un IAM rol o un secreto existentes, puedes usar la consola para crear un IAM rol y un Secrets Manager secreto nuevos al conectar tu fuente de ServiceNow datos. Amazon Kendra Si utilizas la API, debes proporcionar el ARN de un IAM rol y un Secrets Manager secreto existentes, así como un ID de índice.

Instrucciones de conexión

Para conectarse Amazon Kendra a su fuente de ServiceNow datos, debe proporcionar los detalles necesarios de su fuente de ServiceNow datos para Amazon Kendra poder acceder a sus datos. Si aún no lo ha configurado ServiceNow , Amazon Kendra consulteRequisitos previos.

Console

Para conectarse Amazon Kendra a ServiceNow

  1. Inicie sesión en la consola AWS de administración y Amazon Kendra ábrala.

  2. En el panel de navegación izquierdo, elija Índices y, a continuación, elija el índice que desee usar de la lista de índices.

    nota

    Puede elegir configurar o editar los ajustes de Control de acceso de usuarios en la Configuración del índice.

  3. En la página Introducción, seleccione Agregar origen de datos.

  4. En la página Agregar origen de datos, elija Conector de ServiceNow V1.0 y, a continuación, elija Agregar origen de datos.

  5. En la página Especificar detalles del origen de datos, introduzca la siguiente información:

    1. En Nombre y descripción, en Nombre del origen de datos: introduzca un nombre para el origen de datos. Puede incluir guiones, pero no espacios.

    2. (Opcional) Descripción: introduzca una descripción opcional para el origen de datos.

    3. En Idioma predeterminado: elija un idioma para filtrar los documentos para el índice. A menos que especifique lo contrario, el idioma predeterminado es el inglés. El idioma especificado en los metadatos del documento anula el idioma seleccionado.

    4. En Etiquetas, para Añadir una nueva etiqueta: incluye etiquetas opcionales para buscar y filtrar tus recursos o realizar un seguimiento de tus AWS costos.

    5. Elija Siguiente.

  6. En la página Definir acceso y seguridad, introduzca la siguiente información:

    1. ServiceNow host: introduce la URL del ServiceNow host.

    2. ServiceNow versión: selecciona tu ServiceNow versión.

    3. Elija entre Autenticación básica y Autenticación OAuth 2.0 según el caso de uso.

    4. AWS Secrets Manager secreto: elija un secreto existente o cree uno nuevo Secrets Manager para almacenar sus credenciales de ServiceNow autenticación. Si decide crear un secreto nuevo, se abrirá una ventana de secreto de AWS Secrets Manager .

      1. Nombre del secreto: un nombre para su secreto. El prefijo «AmazonKendra-ServiceNow-» se añade automáticamente a su nombre secreto.

      2. Si utilizas la autenticación básica, introduce el nombre secreto, el nombre de usuario y la contraseña de tu cuenta. ServiceNow

        Si utilizas la autenticación OAuth2, introduce el nombre secreto, el nombre de usuario, la contraseña , el ID de cliente y el secreto del cliente que creaste en tu cuenta. ServiceNow

      3. Haga clic en Guardar y agregar secreto.

    5. IAM rol: elige un IAM rol existente o crea uno nuevo IAM para acceder a las credenciales de tu repositorio e indexar el contenido.

      nota

      IAM los roles utilizados para los índices no se pueden usar para las fuentes de datos. Si no está seguro de si un rol existente se utiliza para un índice o para las preguntas frecuentes, elija Crear un nuevo rol para evitar errores.

    6. Elija Siguiente.

  7. En la página Configurar ajustes de sincronización, introduzca la siguiente información:

    1. Incluir artículos de conocimiento: elija si desea indexar los artículos de conocimiento.

    2. Tipo de artículos de conocimiento: elija entre incluir solo artículos públicos o Incluir artículos en función de una consulta de ServiceNow filtro según su caso de uso. Si seleccionas Incluir artículos según la consulta de ServiceNow filtrado, debes introducir una consulta de filtrado copiada de tu ServiceNow cuenta.

    3. Incluir archivos adjuntos de artículos de conocimiento: elija si desea indexar los archivos adjuntos de los artículos de conocimiento. También puede seleccionar tipos de archivos específicos para indexarlos.

    4. Incluir elementos del catálogo: elija si desea indexar los elementos del catálogo.

    5. Incluir archivos adjuntos de elementos del catálogo: elija si desea indexar los archivos adjuntos de los elementos del catálogo. También puede seleccionar tipos de archivos específicos para indexarlos.

    6. Frecuencia: con qué frecuencia Amazon Kendra se sincronizará con tu fuente de datos.

    7. Elija Siguiente.

  8. En la página Establecer asignaciones de campos, especifique la siguiente información:

    1. Artículos de conocimiento y catálogo de servicios: seleccione los campos de fuente de datos predeterminados Amazon Kendra generados y las asignaciones de campos adicionales sugeridas que desee asignar a su índice.

    2. Agregar campo: para agregar campos de origen de datos personalizados para crear un nombre de campo de índice al que asignarlos y el tipo de datos del campo.

    3. Elija Siguiente.

  9. En la página Revisar y crear, compruebe que la información que ha introducido es correcta y, a continuación, seleccione Añadir origen de datos. También puede elegir editar la información desde esta página. El origen de datos aparecerá en la página Orígenes de datos una vez que el origen de datos se haya agregado correctamente.

API

Para conectarse a Amazon Kendra ServiceNow

Debe especificar lo siguiente mediante la ServiceNowConfiguration API:

  • URL de la fuente de datos: especifique la ServiceNow URL. El punto final del host debe tener el siguiente aspecto:your-domain.service-now.com.

  • Instancia host de la fuente de datos: especifique la versión de la instancia ServiceNow host como LONDON oOTHERS.

  • Nombre de recurso secreto de Amazon (ARN): proporcione el nombre de recurso de Amazon (ARN) de un Secrets Manager secreto que contenga las credenciales de autenticación que creó en su cuenta. ServiceNow

    Si está utilizando la autenticación básica, el secreto se almacena en una estructura JSON con las siguientes claves:

    {
    "username": "user name",
    "password": "password"
}

    Si está utilizando la autenticación OAuth2, el secreto se almacena en una estructura JSON con las siguientes claves:

    {
    "username": "user name",
    "password": "password",
    "clientId": "client id",
    "clientSecret": "client secret"
}

  • IAM rol: especifica RoleArn cuándo llamarás CreateDataSource para proporcionarle a un IAM rol los permisos necesarios para acceder a tu Secrets Manager secreto y para llamar a las API públicas necesarias para el conector y. ServiceNow Amazon Kendra Para obtener más información, consulte Roles de IAM para orígenes de datos de ServiceNow .

También puede añadir las siguientes características opcionales:

  • Asignaciones de campos: elija asignar los campos del origen de datos de ServiceNow a los campos de índice de Amazon Kendra . Para obtener más información, consulte Asignación de campos de origen de datos.

    nota

    El campo del cuerpo del documento o el equivalente del cuerpo del documento para sus documentos es obligatorio Amazon Kendra para poder buscar en sus documentos. Debe asignar el nombre del campo del cuerpo del documento en el origen de datos al nombre del campo del índice _document_body. Todos los demás campos son opcionales.

  • Filtros de inclusión y exclusión: especifique si desea incluir o excluir determinados archivos adjuntos de catálogos y artículos de conocimiento.

    nota

    La mayoría de los orígenes de datos utilizan patrones de expresiones regulares, que son patrones de inclusión o exclusión denominados filtros. Si especifica un filtro de inclusión, solo se indexará el contenido que coincida con el filtro de inclusión. Los documentos que no coincidan con el filtro de inclusión no se indexan. Si especifica un filtro de inclusión y exclusión, los documentos que coincidan con el filtro de exclusión no se indexarán, aunque coincidan con el filtro de inclusión.

  • Parámetros de indexación: también puede optar por especificar si desea:

    • Indexar artículos de conocimiento y catálogos de servicios, o ambos. Si opta por indexar los artículos de conocimiento y los elementos del catálogo de servicios, debe proporcionar el nombre del ServiceNow campo que está asignado al campo de contenido del documento indexado del Amazon Kendra índice.

    • Indexar los archivos adjuntos de los artículos de conocimiento y los elementos del catálogo.

    • Utilice una ServiceNow consulta que seleccione documentos de una o más bases de conocimiento. Las bases de conocimiento pueden ser públicas o privadas. Para obtener más información, consulte Especificar documentos a indexar con una consulta.

Más información

Para obtener más información sobre la integración Amazon Kendra con su fuente de ServiceNow datos, consulte: