Configurar un almacén de datos de Microsoft SharePoint

En esta página se describe cómo crear un almacén de datos y conectar Microsoft SharePoint con Gemini Enterprise.

Antes de empezar

Nota: Para aplicar el control de acceso a las fuentes de datos y proteger los datos en Gemini Enterprise, asegúrate de haber configurado tu proveedor de identidades.

Antes de configurar la conexión federada de Microsoft SharePoint, asegúrate de que se cumplen los siguientes requisitos:

1. Asigna el rol de editor de Discovery Engine (roles/discoveryengine.editor). Este rol es obligatorio para que el usuario pueda crear el almacén de datos. Para asignar este rol, sigue estos pasos:

   1. En la consola, ve a la página Gestión de identidades y accesos. Google Cloud

      Ir a IAM

   2. Busca la cuenta de usuario y haz clic en el icono de editar Editar.
   3. Asigna el rol Discovery Engine Editor al usuario. Para obtener más información, consulta Roles y permisos de gestión de identidades y accesos.

2. Registra Gemini Enterprise como una aplicación OAuth 2.0 en Microsoft Entra ID y obtén las siguientes credenciales:

   • ID de cliente

   • Secreto de cliente

   • ID de cliente

   • URI de la instancia

3. Configura los permisos de la API de Microsoft con el consentimiento de un administrador de Microsoft SharePoint.

Crear un almacén de datos de Microsoft SharePoint

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

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

   Gemini Enterprise

2. Selecciona o crea un Google Cloud proyecto.

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

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

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

5. En la sección Origen, busca Microsoft SharePoint y haz clic en Seleccionar.

6. En la sección Datos:

   1. En la sección Modo de conector, selecciona Búsqueda federada o Ingestión 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 hayas elegido.

      1. Proporciona los detalles de autenticación necesarios:

         • ID de cliente: el identificador único de la aplicación registrada en el ID de Microsoft Entra de tu organización.
         • Secreto de cliente: la clave secreta generada durante el proceso de registro de la aplicación OAuth 2.0 en Microsoft Entra ID.
         • ID de cliente: identificador único de tu organización en el centro de administración de Microsoft Entra.
         • URI de la instancia: la URL base de tu instancia de Microsoft SharePoint (por ejemplo, https://{your-domain}.sharepoint.com).

         Para obtener más información, consulta Obtener credenciales de cliente.

      2. Si has seleccionado Búsqueda federada, haz clic en Iniciar sesión y completa el inicio de sesión de terceros.

   4. Haz clic en Continuar.

   5. Si has seleccionado Búsqueda federada, aparecerá la sección Destinos. Introduce la URL base del sitio.

   6. Haz clic en Continuar.

   7. En la sección Entidades que buscar (si ha seleccionado Búsqueda federada) o Entidades que sincronizar (si ha seleccionado Ingestión de datos):

      1. Selecciona todas las entidades necesarias.
      2. Si has seleccionado Búsqueda federada, ve al siguiente paso.
      3. Si ha seleccionado Ingestión de datos, siga estos pasos:
         1. Opcional: Para sincronizar proyectos específicos, haz lo siguiente:
            1. Haz clic en Filtrar.
            2. Para excluir entidades del índice, selecciona la casilla Excluir del índice. Para incluirlas, selecciona la casilla Incluir en el índice.
            3. Introduce las llaves. Pulsa Intro después de cada tecla.
            4. Haz clic en Guardar.
         2. Para configurar la programación de sincronización, sigue estos pasos:
            1. En la lista Frecuencia de sincronización, seleccione la frecuencia de sincronización.
               • Para programar sincronizaciones completas independientes de los datos de entidad y de identidad, despliega el menú de la sección Sincronización completa y selecciona Opciones personalizadas.
            2. En la lista Frecuencia de sincronización incremental, seleccione la frecuencia de sincronización incremental. Para obtener más información, consulta Programaciones de sincronización.

7. Haz clic en Continuar.

8. En la sección Acciones:

   1. Si has seleccionado Búsqueda federada:
      1. En Seleccionar acciones de Microsoft SharePoint para habilitar, elija las acciones de la categoría para habilitarlas en el conector.

   2. Si has seleccionado Ingestión de datos:

      1. En la sección Configuración de autenticación, configura la autenticación según el modo de conexión que hayas elegido.

         1. Proporciona los detalles de autenticación necesarios:

            • ID de cliente: el identificador único de la aplicación registrada en el ID de Microsoft Entra de tu organización.
            • Secreto de cliente: la clave secreta generada durante el proceso de registro de la aplicación OAuth 2.0 en Microsoft Entra ID.
            • ID de cliente: identificador único de tu organización en el centro de administración de Microsoft Entra.
            • URI de la instancia: la URL base de tu instancia de Microsoft SharePoint (por ejemplo, https://{your-domain}.sharepoint.com).

            Para obtener más información, consulta Obtener credenciales de cliente.

      2. Haz clic en Continuar.

      3. En la sección Destinos, introduzca la URL base del sitio.

      4. Haz clic en Continuar.

      5. En Seleccionar acciones de Microsoft SharePoint para habilitar, elija las acciones de la categoría para habilitarlas en el conector.

9. Haz clic en Continuar.

   Nota: Si no añades acciones en este paso, tendrás que crear un nuevo almacén de datos para añadirlas. Para ver la lista de acciones, consulta Ver acciones.

10. En la sección Configuración:

    1. En la lista Multirregión, selecciona la ubicación del conector de datos.
    2. En el campo Nombre del conector de datos, escriba un nombre para el conector.
    3. Si has seleccionado US o EU como ubicación, configura los ajustes de cifrado:
       • Opcional: Si no ha configurado claves de una sola región, haga clic en Ir a la página de configuración para hacerlo. Para obtener más información, consulte Registrar una clave de una sola región para conectores de terceros.
       • Selecciona Clave de cifrado gestionada porGoogle o Clave de Cloud KMS.
       • Si has seleccionado Clave de Cloud KMS:
         • En la lista Tipo de gestió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 cifrado gestionadas por el cliente.

11. Haz clic en Continuar.

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

13. 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 Data Stores (Almacenes de datos), haz clic en el nombre del almacén de datos para ver el estado. Una vez que el estado del almacén de datos cambie de Creating (Creando) a Active (Activo), el conector de Microsoft SharePoint estará listo para usarse.

En el caso de un conector de ingesta creado con Microsoft SharePoint, el estado del almacén de datos pasa de Creando a En ejecución cuando se inicia la sincronización. Después, cambia a Activo cuando se completa la ingestión, lo que indica que el almacén de datos está totalmente configurado. En función del volumen de datos, la ingestión puede tardar varias horas.

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

Habilitar la sincronización en tiempo real para la ingestión de datos

Vista previa — Real-time sync

Esta función está sujeta a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Nota: La sincronización en tiempo real solo está disponible en el modo de conexión Ingestión de datos.

La sincronización en tiempo real solo sincroniza las entidades de documentos y no sincroniza los datos relacionados con las entidades de identidad. En la siguiente tabla se muestran los eventos de documento que se admiten con la sincronización en tiempo real.

Entidades de Microsoft SharePoint	Crear	Actualizar	Eliminar	Cambios en los permisos
Archivos adjuntos
Comentarios
Eventos
Archivos
Páginas

Para habilitar la sincronización en tiempo real de tu almacén de datos, sigue estos pasos.

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

   Gemini Enterprise

2. En el menú de navegación, haga clic en Almacenes de datos.

3. Haga clic en el nombre del almacén de datos de Microsoft SharePoint para el que quiera habilitar la sincronización en tiempo real.

4. En la página Datos del almacén de datos, espera hasta que el Estado del conector cambie a Activo.

5. En el campo Sincronización en tiempo real, haz clic en Ver o editar.

6. Para habilitar la sincronización en tiempo real, haz clic en el interruptor Habilitar sincronización en tiempo real.

7. En el campo Client secret (Secreto de cliente), introduce un valor. Este valor se usa para verificar los eventos de webhook de Microsoft SharePoint. Te recomendamos que uses una cadena de 20 caracteres.

8. Haz clic en Guardar.

   Espere a que el campo Sincronización en tiempo real cambie a En ejecución.

Gestión de datos y ejecución de consultas

En esta sección se describe cómo gestiona Gemini Enterprise tu consulta y las implicaciones para la privacidad del uso del almacén de datos federado.

Ejecución de consultas

Después de autorizar Microsoft SharePoint y enviar una consulta de búsqueda a Gemini Enterprise:

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

Tratamiento de datos

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

• La cadena de consulta se envía al backend de búsqueda de terceros (API de Microsoft).
• Estos terceros pueden asociar las consultas con tu identidad.
• Si hay varias fuentes de datos de búsqueda federada habilitadas, la consulta se puede enviar a todas ellas.
• Una vez que los datos llegan al sistema de terceros, se rigen por los términos del servicio y las políticas de privacidad de ese sistema.

Nota: Para mejorar la precisión, un LLM puede reescribir tu consulta antes de enviarla a Microsoft SharePoint. Esta consulta reescrita puede incorporar información del historial de consultas de tu sesión. Por lo tanto, es posible que algunas partes de tu historial de consultas también se incluyan en la consulta enviada a la API de Microsoft.

Siguientes pasos

• Para proporcionar una interfaz de usuario que permita consultar tus datos de Microsoft SharePoint, crea una aplicación y conéctala al almacén de datos de Microsoft SharePoint.
• Para ver la lista de acciones, consulta Ver acciones.
• Para ver cómo aparecen los resultados de búsqueda después de configurar tu aplicación, consulta Obtener resultados de búsqueda.
• Para habilitar las alertas del almacén de datos, consulta Configurar alertas para almacenes de datos de terceros.