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 V2.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, incidentes y sus archivos adjuntos.
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:
-
Asignaciones de campos
-
Control de acceso de usuarios
-
Inclusion/exclusion filtros
-
Sincronizaciones completas e incrementales del contenido
-
ServiceNow versiones de instancia: Roma, Sandiego, Tokio, otras
-
Nube privada virtual (VPC)
Requisitos previos
Antes de poder utilizarla Amazon Kendra para indexar la fuente de ServiceNow datos, realiza estos cambios en tus AWS cuentas ServiceNow y.
En ServiceNow, asegúrate de tener:
-
Ha creado una instancia de Personal o Enterprise Developer y dispone de una instancia de ServiceNow con un rol administrativo.
-
Has copiado el host de la URL de tu ServiceNow instancia. El formato de la URL del host que ingresas esyour-domain.service-now.com. Necesita la URL de la instancia de ServiceNow para conectarse a Amazon Kendra.
-
Anotó sus credenciales de autenticación básicas, es decir, un nombre de usuario y una contraseña Amazon Kendra para poder conectarse a la ServiceNow instancia.
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é las credenciales de cliente de OAuth 2.0 que pueden identificarse Amazon Kendra mediante un nombre de usuario, una contraseña, un ID de cliente generado y un secreto de cliente. Consulta ServiceNow la documentación sobre la autenticación 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.
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.
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
-
Inicie sesión en la Amazon Kendra consola Consola de administración de AWS y ábrala.
-
En el panel de navegación izquierdo, elija Índices y, a continuación, elija el índice que desee usar de la lista de índices.
Puede elegir configurar o editar los ajustes de Control de acceso de usuarios en la Configuración del índice.
-
En la página Introducción, seleccione Agregar origen de datos.
-
En la página Agregar origen de datos, seleccione el Conector de ServiceNow y, a continuación, seleccione Agregar conector. Si usas la versión 2 (si corresponde), elige el ServiceNow conector con la etiqueta V2.0 "».
-
En la página Especificar detalles del origen de datos, introduzca la siguiente información:
-
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.
-
(Opcional) Descripción: introduzca una descripción opcional para el origen de datos.
-
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.
-
En Etiquetas, en Añadir una nueva etiqueta, incluye etiquetas opcionales para buscar y filtrar tus recursos o realizar un seguimiento de tus AWS costos.
-
Elija Siguiente.
-
En la página Definir acceso y seguridad, introduzca la siguiente información:
-
ServiceNow host: introduce la URL del ServiceNow host. El formato de la URL del host que introduzca esyour-domain.service-now.com.
-
ServiceNow versión: selecciona la versión de tu ServiceNow instancia. Puede elegir entre Roma, Sandiego, Tokio u Otras.
-
Autorización: active o desactive la información de la lista de control de acceso (ACL) para los documentos, si tiene una ACL y desea usarla para el control de acceso. La ACL especifica a qué documentos pueden acceder los usuarios y los grupos. La información de la ACL se utiliza para filtrar los resultados de búsqueda en función del acceso del usuario o su grupo a los documentos. Para obtener más información, consulte Filtrado de contexto de usuario.
-
Autenticación: elija entre Autenticación básica y Autenticación OAuth 2.0.
-
AWS
Secrets Manager secret: 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 . En la ventana, introduzca la siguiente información:
-
Nombre del secreto: un nombre para su secreto. El prefijo «AmazonKendra-ServiceNow-» se añade automáticamente a su nombre secreto.
-
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 OAuth2.0 la autenticación, 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
-
Guarde y agregue el secreto.
-
Nube privada virtual (VPC): puede optar por utilizar una VPC. Si es así, debe agregar Subredes y Grupos de seguridad de VPC.
-
Rastreador de identidades: especifique si se debe activar el rastreador de identidades de Amazon Kendra. El rastreador de identidades utiliza la información de la lista de control de acceso (ACL) de los documentos para filtrar los resultados de la búsqueda en función del acceso del usuario o del grupo a los documentos. Si tiene una ACL para sus documentos y decide utilizarla, también puede optar por activar el rastreador de identidades para configurar el filtrado por contexto Amazon Kendra de usuario de los resultados de búsqueda. De lo contrario, si el rastreador de identidades está desactivado, todos los documentos se pueden buscar públicamente. Si quieres usar el control de acceso para tus documentos y el rastreador de identidades está desactivado, también puedes usar la PutPrincipalMapping API para cargar la información de acceso de usuarios y grupos para filtrar el contexto de los usuarios.
-
IAM rol: elige un IAM rol existente o crea uno nuevo IAM para acceder a las credenciales de tu repositorio e indexar el contenido.
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.
-
Elija Siguiente.
-
En la página Configurar ajustes de sincronización, introduzca la siguiente información:
-
En Artículos de Knowledge, elija entre las siguientes opciones:
-
Artículos de conocimiento: elija si desea indexar los artículos de conocimiento.
-
Archivos adjuntos de artículos de conocimiento: elija si desea indexar los archivos adjuntos de los artículos de conocimiento.
-
Tipo de artículos de conocimiento: elija entre solo artículos públicos y artículos de conocimiento mediante una consulta de ServiceNow filtro basada en 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. Entre los ejemplos de consultas de filtro se incluyen: workflow_state=draft^EQkb_knowledge_base=dfc19531bf2021003f07e2c1ac0739ab^text
ISNOTEMPTY^EQ,,article_type=text^active=true^EQ.
Si eliges rastrear solo los artículos públicos, solo Amazon Kendra rastreará los artículos de conocimiento a los que se les haya asignado una función de acceso público en. ServiceNow
-
Incluir artículos según el filtro de descripción breve: especifique patrones de expresión regular para incluir o excluir artículos específicos.
-
En Elementos del catálogo de servicios:
-
Elementos del catálogo de servicios: elija si desea indexar los elementos del catálogo de servicios.
-
Archivos adjuntos de elementos del catálogo de servicios: elija si desea indexar los archivos adjuntos de los elementos del catálogo de servicios.
-
Elementos activos del catálogo de servicios: elija si desea indexar los elementos activos del catálogo de servicios.
-
Elementos inactivos del catálogo de servicios: elija si desea indexar los elementos inactivos del catálogo de servicios.
-
Consulta de filtrado: elige incluir los elementos del catálogo de servicios en función de un filtro definido en tu instancia. ServiceNow Los ejemplos de consultas de filtro incluyen:short_descriptionLIKEAccess^category=2809952237b1300054b6a3549dbe5dd4^EQ,nameSTARTSWITHService^active=true^EQ.
-
Incluir los elementos del catálogo de servicios según un filtro de descripción breve: especifique un patrón de regex para incluir elementos del catálogo específicos.
-
En Incidentes:
-
Incidentes: elija si desea indexar los incidentes de servicio.
-
Archivos adjuntos de incidentes: elija si desea indexar los archivos adjuntos de incidentes.
-
Incidentes activos: elija si desea indexar los incidentes activos.
-
Incidentes inactivos: elija si desea indexar los incidentes inactivos.
-
Tipo de incidente activo: elija entre Todos los incidentes, Incidentes abiertos, Incidentes abiertos: no asignados e Incidentes resueltos, según el caso de uso.
-
Consulta de filtro: elija incluir los incidentes en función de un filtro definido en su ServiceNow instancia. Los ejemplos de consultas de filtro incluyen:short_descriptionLIKETest^urgency=3^state=1^EQ,priority=2^category=software^EQ .
-
Incluir incidentes según el filtro de descripción breve: especifique un patrón de regex para incluir incidentes específicos.
-
En Configuración adicional:
-
Información de ACL: las listas de control de acceso de las entidades que ha seleccionado se incluyen de forma predeterminada. Al anular la selección de una lista de control de acceso, todos los archivos de esa categoría serán públicos. Las opciones de ACL se desactivan automáticamente para las entidades no seleccionadas. En el caso de los artículos públicos, no se aplica la ACL.
-
En Tamaño máximo de archivo: especifique el límite de tamaño del archivo en MB que Amazon Kendra rastreará. Amazon Kendra rastreará solo los archivos que se encuentren dentro del límite de tamaño que defina. El tamaño de archivo predeterminado es de 50 MB. El tamaño máximo del archivo debe ser mayor que 0 MB y menor o igual que 50 MB.
-
Patrones de regex de archivos adjuntos: añada patrones de expresiones regulares para incluir o excluir determinados archivos adjuntos de catálogos, artículos de conocimiento e incidentes. Puede añadir hasta 100 patrones.
-
Modo de sincronización: elija cómo desea actualizar el índice cuando cambie el contenido del origen de datos. Al sincronizar el origen de datos con Amazon Kendra
por primera vez, todo el contenido se rastrea y se indexa de forma predeterminada. Debe ejecutar una sincronización completa de los datos si la sincronización inicial falló, incluso si no selecciona la sincronización completa como opción de modo de sincronización.
-
Sincronización completa: se vuelve a indexar todo el contenido, reemplazando el contenido existente cada vez que el origen de datos se sincronice con el índice.
-
Sincronización nueva, modificada y eliminada: indexe solo el contenido nuevo, modificado y eliminado cada vez que la fuente de datos se sincronice con el índice. Amazon Kendra puede usar el mecanismo de la fuente de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido que haya cambiado desde la última sincronización.
-
En Programación de ejecución de sincronización, en Frecuencia: elija la frecuencia con la que desea sincronizar el contenido del origen de datos y actualizar el índice.
-
Elija Siguiente.
-
En la página Establecer asignaciones de campos, especifique la siguiente información:
-
Asignaciones de campos predeterminadas: seleccione entre las fuentes de datos predeterminadas Amazon Kendra generadas los campos que desee asignar a su índice.
-
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.
-
Elija Siguiente.
-
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 un JSON del esquema del origen de datos mediante la API TemplateConfiguration. Debe proporcionar la siguiente información:
-
Origen de datos: defina el tipo de origen de datos como SERVICENOWV2 cuando utilice el esquema JSON TemplateConfiguration. Además, defina el origen de datos como TEMPLATE al llamar a la API CreateDataSource.
-
URL del host: especifique la versión de la instancia del ServiceNow host. Por ejemplo, your-domain.service-now.com.
-
Tipo de autenticación: especifique el tipo de autenticación que usa, ya sea OAuth2 para su ServiceNow instancia basicAuth o para ella.
-
ServiceNow versión de instancia: especifica la ServiceNow instancia que usas, ya seaTokyo, SandiegoRome, o. Others
-
Modo de sincronización: especifique cómo Amazon Kendra
debe actualizar el índice cuando cambie el contenido del origen de datos. Cuando sincronizas tu fuente de datos Amazon Kendra por primera vez, todo el contenido se rastrea e indexa de forma predeterminada. Debe ejecutar una sincronización completa de los datos si la sincronización inicial falló, incluso si no selecciona la sincronización completa como opción de modo de sincronización. Puede elegir entre las siguientes opciones:
-
FORCED_FULL_CRAWL para volver a indexar todo el contenido, reemplazando el contenido existente cada vez que el origen de datos se sincronice con el índice.
-
FULL_CRAWLpara indexar solo el contenido nuevo, modificado y eliminado cada vez que la fuente de datos se sincronice con el índice. Amazon Kendra puede usar el mecanismo de la fuente de datos para rastrear los cambios en el contenido e indexar el contenido que ha cambiado desde la última sincronización.
-
Nombre de recurso secreto de Amazon (ARN): proporciona el nombre de recurso de Amazon (ARN) de un Secrets Manager secreto que contenga las credenciales de autenticación que creaste en tu cuenta. ServiceNow
Si utiliza la autenticación básica, el secreto se almacena en una estructura JSON con las siguientes claves:
{
"username": "user name",
"password": "password"
}
-
Si usa las credenciales de cliente 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:
-
Nube privada virtual (VPC): especifique a VpcConfiguration cuándo llamar a CreateDataSource. Para obtener más información, consulte ¿Se está configurando Amazon Kendra para usar un Amazon VPC.
-
Filtros de inclusión y exclusión: puede especificar si desea incluir o excluir determinados archivos adjuntos mediante los nombres y tipos de archivos de los artículos de conocimiento, los catálogos de servicios y los incidentes.
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.
-
Documentos específicos para indexar: puede usar una ServiceNow consulta para especificar los documentos que desea obtener de una o más bases de conocimiento, incluidas las bases de conocimiento privadas. El acceso a las bases de conocimiento lo determina el usuario que utilice para conectarse a la ServiceNow instancia. Para obtener más información, consulte Especificar documentos a indexar con una consulta.
-
Parámetros de indexación: también puede optar por especificar si desea:
-
Indexar artículos de conocimiento, catálogos de servicios e incidentes, o todos ellos. Si opta por indexar los artículos de conocimiento, los elementos del catálogo de servicios y los incidentes, debe proporcionar el nombre del ServiceNow campo que está asignado al campo de contenido del documento de Amazon Kendra índice.
-
Indexar los archivos adjuntos de los artículos de conocimiento, los elementos del catálogo de servicios y los incidentes.
-
Incluir artículos de conocimiento, elementos del catálogo de servicios e incidentes según el patrón de filtrado short description.
-
Elegir filtrar los elementos e incidentes del catálogo de servicios activos e inactivos.
-
Elegir filtrar los incidentes en función de su tipo.
-
Elegir de qué entidades se debe rastrear la ACL.
-
Puede usar una ServiceNow consulta para especificar los documentos que desea obtener de una o más bases de conocimiento, incluidas las bases de conocimiento privadas. El acceso a las bases de conocimiento lo determina el usuario que utilice para conectarse a la ServiceNow instancia. Para obtener más información, consulte Especificar documentos a indexar con una consulta.
-
Rastreador de identidades: especifique si se debe activar el rastreador de identidades de Amazon Kendra. El rastreador de identidades utiliza la información de la lista de control de acceso (ACL) de los documentos para filtrar los resultados de la búsqueda en función del acceso del usuario o del grupo a los documentos. Si tiene una ACL para sus documentos y decide utilizarla, también puede optar por activar el rastreador Amazon Kendra de identidades para configurar el filtrado por contexto de usuario de los resultados de búsqueda. De lo contrario, si el rastreador de identidades está desactivado, todos los documentos se pueden buscar públicamente. Si quieres usar el control de acceso para tus documentos y el rastreador de identidades está desactivado, también puedes usar la PutPrincipalMapping API para cargar la información de acceso de usuarios y grupos para filtrar el contexto de los usuarios.
-
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.
El campo del cuerpo del documento o el equivalente del cuerpo del documento para sus documentos es necesario 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.
Para obtener una lista de otras claves JSON importantes que debe configurar, consulte el Esquema de plantilla de ServiceNow .
Más información
Para obtener más información sobre la integración Amazon Kendra con su fuente de ServiceNow datos, consulte: