Características admitidas Requisitos previos Instrucciones de conexión Más información

Slack

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 el 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 o la TemplateConfigurationAPI.

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 campo
Filtrado de contexto de usuario
Rastreo de identidad de usuario
Filtros de inclusión/exclusión
Sincronizaciones de contenido completas e incrementales
Virtual Private Cloud (VPC) (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:

Ha creado un token de OAuth de usuario de Slack Bot o un token de OAuth de usuario de Slack. Puedes elegir cualquier token para conectarte Amazon Kendra a tu fuente de datos de Slack. 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.
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/… donde T0123456789 es el ID del equipo.

Se agregaron los siguientes permisos de ámbito/lectura de Oauth:

Ámbito del token de usuario	Ámbito del token del bot
channels:history channels:read channels:write chat:write emoji:read files:read files:write groups:history groups:read groups:write im:history im:read im:write mpim:history mpim:read mpim:write reactions:write team:read usergroups:read usergroups:write users.profile:read users:read users:read.email auditlogs:read	team:read channels:history groups:history im:history mpim:history chat:write channels:manage groups:write groups:read im:write im:read files:write files:read users:read links:read channels:read mpim:read chat:write.customize channels:join emoji:read mpim:write usergroups:read usergroups:write users.profile:read users:read.email users:write

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. Los ID de documento son globales para un índice y deben ser únicos por índice.

En tu 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

Console

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.
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 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.
4. 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.
5. Seleccione Siguiente.
En la página Definir acceso y seguridad, introduzca la siguiente información:
1. En Origen, para el ID de equipo del espacio de trabajo de Slack: el ID del equipo de tu espacio de trabajo de Slack.
2. 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 .
  1. Introduzca la siguiente información en la ventana Crear un secreto de AWS Secrets Manager :
    1. Nombre del secreto: un nombre para su secreto. El prefijo «AmazonKendra-Slack» se añade automáticamente a tu nombre secreto.
    2. En Token de Slack: introduzca los valores de las credenciales de autenticación que creó en la cuenta de Slack.
  2. Seleccione Guardar.
3. Nube privada virtual (VPC): puede optar por utilizar una VPC. Si es así, debe agregar Subredes y Grupos de seguridad de VPC.
4. Rastreador de identidad: especifica si deseas activar el rastreador de identidad. 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 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 realizar búsquedas públicas en 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.
5. 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.
6. Seleccione Siguiente.
En la página Configurar ajustes de sincronización, introduzca la siguiente información:
1. Seleccionar tipo de contenido para rastreado: las entidades o tipos de contenido de Slack que desea rastrear. Puede elegir entre Todos los canales, Canales públicos, Canales privados, Mensajes grupales y Mensajes privados.
2. Selecciona la fecha de inicio del rastreo: introduce la fecha a partir de la cual Amazon Kendra se rastreará tu contenido de Slack.
3. Para una configuración adicional (opcional), introduce la siguiente información:
  - Identificación/nombre del canal (opcional): si has elegido sincronizar el contenido de los canales, puedes incluir el contenido que se va a sincronizar de canales específicos proporcionando los identificadores y los nombres de los canales.
  - Mensajes: elige si quieres incluir los mensajes del bot, los mensajes archivados o los del bot y los archivados.
    
    nota
    Si decides configurar filtros tanto para el ID como para el nombre del canal, el conector de Amazon Kendra Slack priorizará los ID de los canales por encima de los nombres de los canales.
    Si decides configurar filtros para el ID del canal o el nombre del canal, el conector de Amazon Kendra Slack ignorará los mensajes privados y grupales, aunque hayas elegido rastrear los mensajes privados y grupales en el ámbito de la sincronización.
  - Patrones regex: patrones de expresiones regulares para incluir o excluir determinados archivos. Puede agregar hasta 100 patrones. Algunos ejemplos de patrones de expresiones regulares son:
    Tipo de archivo: .pdf, .docx
    
    Nombre de archivo: hola*.txt,. TestFile *
4. En Modo de sincronización, elija cómo desea actualizar el índice cuando cambie el contenido del origen de datos. Al sincronizar la fuente de datos Amazon Kendra por primera vez, todo el contenido se sincroniza de forma predeterminada.
  - Sincronización completa: sincroniza todo el contenido independientemente del estado de sincronización anterior.
  - Sincronización de documentos nuevos, modificados o eliminados: sincroniza solo los documentos nuevos, modificados y eliminados.
5. En Programa de ejecución de sincronización, en Frecuencia: la frecuencia con la que Amazon Kendra se sincronizará con el origen de datos.
6. Seleccione Siguiente.
En la página Establecer asignaciones de campos, especifique la siguiente información:
1. Para las asignaciones de campos de Slack: selecciona entre los campos de fuentes de datos predeterminados Amazon Kendra generados que quieras asignar a tu í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. Seleccione 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 conectarte a Slack Amazon Kendra

Debe especificar un JSON del esquema del origen de datos mediante la API TemplateConfiguration. Debe proporcionar la siguiente información:

Fuente de datos: especifica el tipo de fuente de datos como SLACK cuando usas el esquema TemplateConfigurationJSON. Especifique también la fuente de datos TEMPLATE al llamar a la CreateDataSourceAPI.
ID del equipo del espacio de trabajo Slack: El ID del equipo de Slack que copió de la URL de su página principal de Slack.
Fecha inicial: la fecha en la que empezarás a rastrear los datos de tu equipo de espacio de trabajo de Slack. La fecha debe seguir este formato:. yyyy-mm-dd
Modo de sincronización: especifique si Amazon Kendra debe actualizar su índice sincronizando todos los documentos o solo los documentos nuevos, modificados y eliminados. Puede elegir entre las opciones siguientes:
- FORCED_FULL_CRAWL para volver a rastrear todo el contenido y reemplazar el contenido existente cada vez que el origen de datos se sincronice con el índice.
- FULL_CRAWL para rastrear de forma incremental solo el contenido nuevo, modificado y eliminado cada vez que el origen de datos se sincronice con el índice.
- CHANGE_LOG para rastrear de forma incremental solo el contenido nuevo y modificado cada vez que el origen de datos se sincronice con el índice.
Rastreador de identidad: especifique si se debe activar el rastreador de identidad. 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 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 realizar búsquedas públicas en 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.
Nombre secreto del recurso de Amazon (ARN): proporciona el nombre del recurso de Amazon (ARN) de un Secrets Manager secreto que contenga las credenciales de autenticación de tu cuenta de Slack. El secreto se almacena en una estructura JSON con las siguientes claves:
```
{
    "slackToken": "token"
}
```
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).
IAM rol: especifica RoleArn cuándo llamas CreateDataSource para proporcionar un IAM rol con permisos para acceder a tu Secrets Manager secreto y para llamar a las API públicas requeridas para el conector de Slack y. Amazon Kendra Para obtener más información, consulte Roles de SlackIAM para orígenes de datos de Slack.

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 Configuración Amazon Kendra para usar un Amazon VPC.
Canales específicos: filtra por canales públicos o privados y especifica determinados canales por su ID.
Tipos de canales y mensajes: si Amazon Kendra debes indexar tus canales públicos y privados, tus mensajes grupales y directos, y tus mensajes bots y archivados. Si utiliza un token de bot como parte de sus credenciales de autenticación de Slack, deberá añadir el token de bot al canal que desee indexar. No puede indexar mensajes directos y mensajes de grupo utilizando un token de bot.
Mira hacia atrás: puedes configurar un lookBack parámetro para que el conector de Slack rastree el contenido actualizado o eliminado hasta un número específico de horas antes de la última sincronización del conector.
Filtros de inclusión y exclusión: especifica si deseas incluir o excluir determinado contenido de Slack. Si utiliza un token de bot como parte de sus credenciales de autenticación de Slack, deberá añadir el token de bot al canal que desee indexar. No puede indexar mensajes directos y mensajes de grupo utilizando un token de bot.

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.
Asignaciones de campos: elija asignar los campos del origen de datos de Slack 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 cuerpo del documento equivalente de tus documentos es obligatorio Amazon Kendra para poder buscarlos. Debe asignar el nombre del campo del cuerpo del documento en la fuente de datos al nombre del campo de í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 Slack.

Más información

Para obtener más información sobre la integración Amazon Kendra con tu fuente de datos de Slack, consulta:

Desentrañe los conocimientos de los espacios de trabajo de Slack con la búsqueda inteligente mediante el conector Slack Amazon Kendra

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Especificar documentos con una consulta

Zendesk