Configura un almacén de datos de Slack

En esta página, se describe cómo crear un almacén de datos y conectar Slack a Gemini Enterprise.

Antes de comenzar

Antes de configurar la conexión de Slack, asegúrate de tener lo siguiente:

  • Otorga el rol de Editor de Discovery Engine (roles/discoveryengine.editor). Este rol es necesario para que el usuario cree el almacén de datos. Para otorgar este rol, haz lo siguiente:

    1. En la consola de Google Cloud , ve a la página IAM.

      Ir a IAM

    2. Ubica la cuenta de usuario y haz clic en editar Editar.
    3. Otorga el rol Discovery Engine Editor al usuario. Para obtener más información, consulta Roles y permisos de IAM.

  • Verifica que tengas acceso al espacio de trabajo de Slack al que necesitas conectarte y que hayas accedido a tu cuenta de Slack.

  • Verifica que tengas un plan de Slack que incluya la búsqueda con Slack AI.

  • Coordina con el administrador de Slack de tu organización para asegurarte de que los usuarios finales puedan autorizar sus cuentas sin interrupciones. Comparte la documentación oficial del Centro de ayuda de Slack: Administra la aprobación de apps para tu lugar de trabajo para obtener instrucciones paso a paso sobre cómo configurar una de las siguientes opciones de implementación:

Crea un almacén de datos de Slack

Para crear un almacén de datos de Slack, sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página Gemini Enterprise.

    Gemini Enterprise

  2. Selecciona o crea un proyecto de Google Cloud .

  3. En el menú de navegación, haz clic en Almacenes de datos.

  4. Haz clic en Crear almacén de datos.

  5. En la sección Fuente, busca Slack y haz clic en Seleccionar.

  6. En la sección Datos, haz lo siguiente:

    1. En la sección Entidades para buscar, selecciona las entidades que deseas buscar de las siguientes:

      • Conversación
      • Archivo
      • Mensaje

    2. Opcional: En el campo ID del equipo de Slack, ingresa el ID de tu equipo de Slack para restringir que los usuarios se conecten solo a un espacio de trabajo de Slack específico. Para obtener más información, consulta Restringe el conector a un espacio de trabajo de Slack específico (opcional).

  7. Haz clic en Continuar.

  8. Si el flujo de creación del almacén de datos muestra una sección Opciones avanzadas, puedes seleccionar la casilla de verificación Habilitar direcciones IP estáticas dentro de ella. Esto garantiza que el almacén de datos use un conjunto fijo de direcciones IP para el tráfico saliente, lo que es adecuado para incluir en la lista de entidades permitidas en el sistema de origen. Para obtener más información, consulta Configura la salida de IP estática.

  9. En la sección Configuración, haz lo siguiente:

    1. En la lista Multirregional, selecciona la ubicación de tu conector de datos.
    2. En el campo Nombre de tu conector de datos, ingresa un nombre para tu conector.
    3. Si seleccionaste us o eu como ubicación, configura los parámetros de configuración de encriptación:
      • Opcional: Si no configuraste claves de una sola región, haz clic en Ir a la página de configuración para hacerlo. Para obtener más información, consulta Cómo registrar una clave de una sola región para conectores de terceros.
      • Selecciona Clave de encriptación administrada porGoogle o Clave de Cloud KMS.
      • Si seleccionaste Clave de Cloud KMS, haz lo siguiente:
        • En la lista Tipo de administración de claves, selecciona el tipo adecuado.
        • En la lista Clave de Cloud KMS, selecciona la clave.
      Para obtener más información, consulta Claves de encriptación administradas por el cliente.

  10. Haz clic en Continuar.

  11. En la sección Facturación, selecciona Precios generales o Precios configurables. Para obtener más información, consulta Verifica el estado de facturación de tus proyectos y Licencias.

  12. Haz clic en Crear. Gemini Enterprise crea tu almacén de datos y lo muestra en la página Almacenes de datos.

En la página Almacenes de datos, haz clic en el nombre del almacén de datos para ver el estado. Después de que el estado del almacén de datos cambie de Creando a Activo, el conector de Slack estará listo para usarse.

Después de crear el almacén de datos, crea una app, conéctala al almacén de datos de Slack y autoriza a Gemini Enterprise para que acceda a Slack antes de ejecutar cualquier consulta.

Restringe el conector a un espacio de trabajo de Slack específico (opcional)

El campo ID del equipo de Slack es opcional. Úsala para restringir a los usuarios finales a un espacio de trabajo de Slack específico y evitar que vinculen cuentas personales o no autorizadas.

  • Si proporcionas un ID de equipo: Durante la autorización, el conector verifica que la cuenta que se conecta pertenezca al espacio de trabajo especificado. Si no es así, se rechaza la conexión.

  • Si dejas este campo en blanco, los usuarios podrán conectarse a cualquier espacio de trabajo al que su cuenta tenga permiso para acceder.

Para encontrar el ID de equipo correspondiente a un espacio de trabajo específico, realiza una de las siguientes acciones:

  • Barra de direcciones del navegador web: Accede a Slack en un navegador web con la URL de tu espacio de trabajo (por ejemplo, https://example.slack.com). Una vez que se cargue la página, busca en la barra de direcciones: la URL tiene el formato https://app.slack.com/client/T01234567/C01234567, y el segmento que comienza con T es tu ID de equipo.
  • Panel de administración: Los administradores de Enterprise Grid pueden encontrar el ID de equipo de un espacio de trabajo específico en el panel de administración en admin.slack.com, en Espacios de trabajo.
  • API de Slack: Recupera el ID del equipo de forma programática con el método de la API team.info de Slack.

Copia el valor y pégalo en el campo ID del equipo de Slack para aplicar la restricción.

Control de datos y ejecución de consultas

En esta sección, se describe cómo Gemini Enterprise administra tu búsqueda y las implicaciones de privacidad del uso del almacén de datos federado.

Ejecución de las consultas

Después de autorizar Slack y enviar una búsqueda a Gemini Enterprise, ocurrirá lo siguiente:

  • Gemini Enterprise envía tu búsqueda directamente a la API de Slack.
  • Gemini Enterprise combina los resultados con los de otras fuentes de datos conectadas y muestra un resultado de búsqueda integral.

Manejo de datos

Cuando se usa la búsqueda federada de terceros, se aplican las siguientes reglas de tratamiento de datos:

  • Tu cadena de consulta se envía al backend de búsqueda de terceros (API de Slack).
  • Estos terceros pueden asociar las búsquedas con tu identidad.
  • Si hay varias fuentes de datos de búsqueda federada habilitadas, es posible que la consulta se envíe a todas ellas.
  • Después de que los datos llegan al sistema de terceros, se rigen por las condiciones del servicio y las políticas de privacidad de ese sistema.

¿Qué sigue?