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.
Slack es una aplicación de comunicación empresarial que permite a los usuarios enviar mensajes y archivos adjuntos a través de varios canales públicos y privados. Puedes usarlo Amazon Kendra para indexar tus canales públicos y privados de Slack, guardar y almacenar mensajes, archivos y archivos adjuntos y mensajes directos y grupales. También puede elegir contenido específico para filtrar.
nota
Amazon Kendra ahora es compatible con un conector de Slack actualizado.
La consola se ha actualizado automáticamente para ti. Todos los conectores nuevos que cree en la consola utilizarán la arquitectura actualizada. Si usa la API, ahora debe usar la TemplateConfigurationobjeto en lugar del SlackConfiguration objeto para configurar el conector.
Los conectores configurados con la antigua arquitectura de consola y API seguirán funcionando tal y como estaban configurados. Sin embargo, no podrá editarlos ni actualizarlos. Si desea editar o actualizar la configuración del conector, debe crear un conector nuevo.
Se recomienda migrar el flujo de trabajo del conector a la versión actualizada. Está previsto que el soporte para los conectores configurados con la arquitectura anterior finalice en junio de 2024.
Puedes conectarte Amazon Kendra a tu fuente de datos de Slack mediante la Amazon Kendra consola
Para solucionar problemas del conector de fuente de datos de Amazon Kendra Slack, consulta. Solución de problemas con los orígenes de datos
Características admitidas
Amazon Kendra El conector de fuente de datos de Slack admite las siguientes funciones:
-
Asignaciones de campos
-
Control de acceso de usuarios
-
Filtros de inclusión/exclusión
-
Sincronizaciones de contenido completas e incrementales
-
Nube privada virtual (VPC)
Requisitos previos
Antes de poder utilizarla Amazon Kendra para indexar tu fuente de datos de Slack, realiza estos cambios en tu cuenta y en tu cuenta de Slack. AWS
En Slack, asegúrese de que:
-
Has configurado un token de usuario de Slack Bot o un OAuth token de usuario de Slack. OAuth Puedes elegir cualquier token para conectarte Amazon Kendra a tu fuente de datos de Slack. Se necesita un token para usarlo como credenciales de autenticación. Consulte la documentación de Slack sobre los tokens de acceso
para obtener más información. nota
Si utiliza el token de bot como parte de sus credenciales de Slack, no podrá indexar los mensajes directos ni los mensajes de grupo y deberá añadir el token de bot al canal que desee indexar.
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).
-
Anote el ID de equipo de su espacio de trabajo Slack en la URL de la página principal de su espacio de trabajo Slack. Por ejemplo,
https://app.slack.com/client/T0123456789/...dóndeT0123456789está el ID del equipo. -
Se agregaron los siguientes alcances/permisos de Oauth:
Ámbito del token de usuario Ámbito del token del bot -
channels:history
-
channels:read
-
emoji:read
-
files:read
-
groups:history
-
groups:read
-
im:history
-
im:read
-
mpim:history
-
mpim:read
-
team:read
-
users.profile:read
-
users:read
-
users:read.email
-
channels:history
-
channels:manage
-
channels:read
-
conversations.connect:manage
-
conversations.connect: leer
-
files:read
-
groups:history
-
groups:read
-
im:history
-
im:read
-
mpim:history
-
mpim:read
-
reacciones: leer
-
team:read
-
usergroups:read
-
users.profile:read
-
users:read
-
users:read.email
-
-
Ha comprobado que cada documento es único en Slack y en otros orígenes de datos que vaya a utilizar para el mismo índice. Cada origen de datos que desee utilizar para un índice no debe contener el mismo documento en varios orígenes de datos. IDs Los documentos son globales para un índice y deben ser únicos por índice.
En el tuyo Cuenta de AWS, asegúrate de tener:
-
Creó un Amazon Kendra índice y, si usa la API, anotó el ID del índice.
-
Creó un IAM rol para su fuente de datos y, si usa la API, anotó el ARN del IAM rol.
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.
-
Ha guardado sus credenciales de autenticación de Slack en un secreto de AWS Secrets Manager y, si utiliza la API, ha anotado 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 secreto existente, puedes usar la consola para crear un nuevo IAM rol y un Secrets Manager secreto al conectar tu fuente de datos de Slack. Amazon Kendra Si utiliza la API, debe proporcionar el ARN de un IAM rol y un Secrets Manager secreto existentes y un ID de índice.
Instrucciones de conexión
Para conectarte Amazon Kendra a tu fuente de datos de Slack, debes proporcionar los detalles necesarios de tu fuente de datos de Slack para que Amazon Kendra puedas acceder a tus datos. Si aún no has configurado Slack para Amazon Kendra, consulta. Requisitos previos
Para conectarte Amazon Kendra a Slack
-
Inicia sesión en la Amazon Kendra consola AWS Management Console
y ábrela. -
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.
-
En la página Introducción, seleccione Agregar origen de datos.
-
En la página Añadir fuente de datos, selecciona el conector de Slack y, a continuación, selecciona Añadir conector. Si utilizas la versión 2 (si corresponde), elige el conector de Slack 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 el idioma predeterminado: elige 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, para añadir una nueva etiqueta: incluya etiquetas opcionales para buscar y filtrar sus recursos o realizar un seguimiento de sus AWS costes.
-
Elija Next (Siguiente).
-
-
En la página Definir acceso y seguridad, introduzca la siguiente información:
-
Para el ID de equipo del espacio de trabajo de Slack: el ID del equipo de tu espacio de trabajo de Slack. Puedes encontrar el ID de tu equipo en la URL de la página principal de tu espacio de trabajo de Slack. Por ejemplo,
https://app.slack.com/client/T0123456789/...dóndeT0123456789está el ID del equipo. -
Autorización: active o desactive la información de la lista de control de acceso (ACL) de sus documentos, si tiene una ACL y desea utilizarla 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.
-
AWS Secrets Manager secreto: elige un secreto existente o crea uno nuevo Secrets Manager para almacenar tus credenciales de autenticación de Slack. Si decide crear un secreto nuevo, se abrirá una ventana de secreto de AWS Secrets Manager .
-
Introduzca la siguiente información en la ventana Crear un secreto de AWS Secrets Manager :
-
Nombre del secreto: un nombre para su secreto. El prefijo «AmazonKendra-Slack» se añade automáticamente a tu nombre secreto.
-
Para el token de Slack: introduce los valores de las credenciales de autenticación que configuraste en Slack.
-
-
Guarda y añade tu 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 identidad: especifique si se debe activar el rastreador Amazon Kendra de identidad. 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 de su 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 Amazon Kendra de los resultados de búsqueda según el contexto del usuario. De lo contrario, si el rastreador de identidades está desactivado, se pueden buscar públicamente todos los documentos. Si quieres usar el control de acceso para tus documentos y el rastreador de identidad está desactivado, también puedes usar la PutPrincipalMappingAPI para cargar información de acceso de usuarios y grupos para filtrar el contexto de los usuarios.
-
IAM rol: elija un IAM rol existente o cree uno nuevo IAM para acceder a las credenciales del repositorio y al contenido del índice.
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.
-
Elija Next (Siguiente).
-
-
En la página Configurar ajustes de sincronización, introduzca la siguiente información:
-
Selecciona el tipo de contenido: selecciona las entidades o los tipos de contenido de Slack que quieres rastrear. Puedes elegir entre todos los canales: canales públicos, canales privados, mensajes grupales y mensajes privados.
-
Selecciona la fecha de inicio del rastreo: introduce la fecha en la que quieres empezar a rastrear tu contenido.
-
Para una configuración adicional: elige incluir mensajes archivados y de bots y utiliza patrones de expresiones regulares para incluir o excluir cierto contenido.
nota
Si decides incluirlos tanto para los nombres de los canales como para los de IDs los canales, el conector de Amazon Kendra Slack dará prioridad a los canales IDs por encima de los nombres de los canales.
Si has decidido incluir algunos mensajes privados y grupales, el conector de Amazon Kendra Slack ignorará todos los mensajes privados y grupales y solo rastreará los mensajes privados y grupales que especifiques.
-
Modo de sincronización: elija cómo desea 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. Debes realizar una sincronización completa de los datos si la sincronización inicial ha fallado, incluso si no seleccionas la sincronización completa como opción de modo de sincronización.
-
Sincronización completa: indexa todo el contenido de forma inmediata y reemplaza el contenido existente cada vez que la fuente de datos se sincronice con el índice.
-
Sincronización nueva, modificada o 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 rastrear los cambios en el contenido e indexar el contenido que ha cambiado desde la última sincronización.
-
-
En el programa de ejecución sincronizado, para Frecuencia: elija la frecuencia con la que desea sincronizar el contenido de la fuente de datos y actualizar el índice.
-
Elija Next (Siguiente).
-
-
En la página Establecer asignaciones de campos, especifique la siguiente información:
-
Campos de fuente de datos predeterminados: seleccione entre los campos de fuente de datos predeterminados Amazon Kendra generados 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 Next (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.
Más información
Para obtener más información sobre la integración Amazon Kendra con tu fuente de datos de Slack, consulta:
