Configura un almacén de datos de Box

Vista previa privada: El almacén de datos de la transferencia de datos está en vista previa privada. Debes estar en la lista de entidades permitidas para usar el almacén de datos de la transferencia de datos. Para que te agreguen a la lista de entidades permitidas, comunícate con tu equipo de cuentas o con el equipo de ventas.

Versión preliminar pública: La búsqueda federada está en versión preliminar pública. Esta función está sujeta a las “Condiciones de la Oferta de la Fase Previa a la DG” en la sección de Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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

Antes de comenzar

Antes de configurar tu conexión de Box, asegúrate de realizar las siguientes acciones:

1. 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 el ícono de editar Editar.
   3. Otorga el rol Discovery Engine Editor al usuario. Para obtener más información, consulta Roles y permisos de IAM.
2. Crea y autoriza la cuenta de la app de Box.
3. Configura Box y establece los permisos necesarios. Para obtener la lista de los permisos necesarios para la búsqueda y la transferencia de datos, consulta Permisos necesarios.
4. Obtén la información de autenticación que se usará durante la creación del almacén de datos.
5. Configura un Google Cloud proyecto con una cuenta de administrador capaz de administrar los parámetros de configuración a nivel de la organización y asegúrate de que la organización pueda configurar un grupo de trabajadores.
6. Asegúrate de que tu organización esté configurada para administrar un grupo de trabajadores.

Crea el almacén de datos de Box

Para crear el almacén de datos de Box, 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 Google Cloud .

   Nota: Para acceder al flujo unificado, tu proyecto debe estar en la lista de entidades permitidas.

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 Box y haz clic en Seleccionar.

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

   1. En la sección Modo del conector, selecciona Búsqueda federada o Transferencia de datos como modo de conexión.

   2. Haz clic en Continuar.

   3. En la sección Configuración de autenticación, configura la autenticación según el modo de conexión que elijas.

      • Si seleccionaste Búsqueda federada, ingresa los siguientes detalles:

        • ID de cliente: Es el identificador único de tu aplicación de Box.
        • Secreto de cliente: Es la clave secreta asociada a tu aplicación de Box.

      • Si seleccionaste Transferencia de datos, ingresa los siguientes detalles:

        • ID de la empresa: Es el identificador único de tu empresa de Box.
        • ID de cliente: Es el identificador público de tu aplicación de Box.
        • Secreto de cliente: Es la clave secreta asociada a tu aplicación de Box.
        • URI de la instancia: Es la URL base de la API de tu instancia de Box.
        • Clave privada: Es la clave privada que se usa para autenticar tu aplicación de Box.
        • ID de clave: Es el identificador de la clave privada.
        • Frase de contraseña: Es la frase de contraseña que se usa para desencriptar la clave privada.

        Para obtener la lista de los permisos requeridos para la búsqueda y la transferencia de datos, consulta Permisos requeridos. Para obtener información sobre cómo obtener información de autenticación, consulta Obtén información de autenticación de Box.

      • Si seleccionaste Búsqueda federada, haz clic en Acceder y completa el acceso.

   4. Haz clic en Continuar.

   5. En la sección Opciones avanzadas:

      • Si seleccionaste Búsqueda federada, selecciona el Modo de suplantación de usuario como Admin o User y haz clic en Continuar.
      • Opcional. Si seleccionaste Transferencia de datos, selecciona la casilla de verificación Habilitar direcciones IP estáticas para permitir un conjunto de direcciones IP estáticas en tu sistema.

   6. Haz clic en Continuar.

   7. En la sección Entidades para buscar (si seleccionaste Búsqueda federada) o Entidades para sincronizar (si seleccionaste Transferencia de datos), haz lo siguiente:

      1. Selecciona todas las entidades requeridas.
      2. Si seleccionaste Transferencia de datos, continúa con los siguientes pasos:
         1. De manera opcional, para sincronizar proyectos específicos, haz lo siguiente:
            1. Haz clic en Filtrar.
            2. Para filtrar entidades del índice, selecciona la casilla de verificación Excluir del índice o, para asegurarte de que se incluyan en él, selecciona la casilla de verificación Incluir en el índice.
            3. Ingresa las claves. Presiona Intro después de cada clave.
            4. Haz clic en Guardar.
         2. Para configurar la programación de sincronización, haz lo siguiente:
            1. En la lista Frecuencia de sincronización, selecciona la frecuencia de sincronización.
               • Para programar sincronizaciones completas independientes de los datos de identidad y de entidad, expande el menú en la sección Sincronización completa y, luego, selecciona Opciones personalizadas.
            2. En la lista Frecuencia de sincronización incremental, selecciona la frecuencia de sincronización incremental. Para obtener más información, consulta Programas de sincronización.

7. Haz clic en Continuar.

8. 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 del conector de datos, ingresa un nombre para tu conector.
   3. Si seleccionaste US o EU como ubicación, establece 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.

9. Haz clic en Continuar.

10. 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.

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

Para verificar el estado del almacén de datos, comprueba lo siguiente:

1. Navega al almacén de datos en la lista de almacenes de datos y supervisa su estado hasta que cambie a Activo.
2. Cuando el estado del almacén de datos cambia de Creando a Activo, el conector de Box está listo para usarse.

En el caso de un almacén de datos de transferencia creado con Box, el estado del almacén de datos pasa de Creando a Ejecutando cuando se inicia la sincronización. Luego, cambia a Activo una vez que se completa la transferencia, lo que indica que el almacén de datos está completamente configurado. Según el volumen de datos, la transferencia puede tardar varias horas.

Si creaste un almacén de datos federado de Box, debes autorizar Gemini Enterprise para Box antes de ejecutar la consulta.

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 Box y enviar una búsqueda a Gemini Enterprise, ocurrirá lo siguiente:

• Gemini Enterprise envía tu búsqueda directamente a la API de Box.
• 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 Box).
• 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.
• Una vez que los datos llegan al sistema de terceros, se rigen por las condiciones del servicio y las políticas de privacidad de ese sistema.

Nota: Para mejorar la precisión, es posible que un LLM reescriba tu búsqueda antes de que se envíe a Box. Esta consulta reescrita puede incorporar información del historial de consultas de tu sesión. Como resultado, es posible que partes de tu historial de consultas también se incluyan en la consulta que se envía a la API de Box.

¿Qué sigue?

• Para proporcionar una interfaz de usuario para consultar tus datos, crea una app y conéctala al almacén de datos federado de Box.
• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar tu app, consulta Cómo obtener resultados de la búsqueda.
• Para habilitar las alertas del almacén de datos, consulta Configura alertas para almacenes de datos de terceros.