Configura 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 a Gemini Enterprise.

Antes de comenzar

Nota: Para aplicar el control de acceso a la fuente de datos y proteger los datos en Gemini Enterprise, asegúrate de configurar tu proveedor de identidad.

Antes de configurar la conexión federada de Microsoft SharePoint, asegúrate de cumplir con los siguientes requisitos:

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 , dirígete 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. Registra Gemini Enterprise como una aplicación de OAuth 2.0 en Microsoft Entra ID y obtén las siguientes credenciales:

   • ID de cliente

   • Secreto del cliente

   • ID de usuario

   • URI de instancia

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

Crea un almacén de datos de Microsoft SharePoint

Para crear un almacén de datos de Microsoft SharePoint, haz lo siguiente:

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

   Gemini Enterprise

2. Selecciona o crea un proyecto de 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 Microsoft SharePoint 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.

      1. Proporciona los siguientes detalles de autenticación según sea necesario:

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

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

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

   4. Haz clic en Continuar.

   5. Si seleccionaste Federated Search, aparecerá la sección Destinations. Ingresa la URL base del sitio.

   6. Haz clic en Continuar.

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

      1. Selecciona todas las entidades requeridas.
      2. Si seleccionaste Búsqueda federada, continúa con el siguiente paso.
      3. Si seleccionaste Ingesta de datos, continúa con los siguientes pasos:
         1. 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 llaves. 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 Actions, haz lo siguiente:

   1. Si seleccionaste Búsqueda federada, haz lo siguiente:
      1. En Select Microsoft SharePoint actions to enable, selecciona las acciones de la categoría para habilitarlas en el conector.

   2. Si seleccionaste Transferencia de datos, haz lo siguiente:

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

         1. Proporciona los siguientes detalles de autenticación según sea necesario:

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

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

      2. Haz clic en Continuar.

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

      4. Haz clic en Continuar.

      5. En Select Microsoft SharePoint actions to enable, selecciona las acciones de la categoría para habilitarlas en el conector.

9. Haz clic en Continuar.

   Nota: Si omites el proceso de agregar acciones en este paso, deberás crear un nuevo almacén de datos para agregarlas. Para ver la lista de acciones, consulta Cómo ver acciones.

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

11. Haz clic en Continuar.

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

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 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 Creando a Activo, el conector de Microsoft SharePoint estará listo para usarse.

En el caso de un conector de transferencia creado con Microsoft SharePoint, 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.

Después de crear el almacén de datos, crea una app, 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 búsqueda.

Habilita la sincronización en tiempo real para la transferencia de datos

Versión preliminar — Real-time sync

Esta función está sujeta a las “Condiciones de la Oferta de la Fase Previa a la DG” en la sección Condiciones del Servicio Generales 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.

Nota: La sincronización en tiempo real solo está disponible para el modo de conexión Ingesta 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 documentos que se admiten con la sincronización en tiempo real.

Entidades de Microsoft SharePoint	Crear	Actualizar	Borrar	Cambios de 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 consola Google Cloud , ve a la página Gemini Enterprise.

   Gemini Enterprise

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

3. Haz clic en el nombre del almacén de datos de Microsoft SharePoint para el que deseas 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 botón de activación Habilitar la sincronización en tiempo real.

7. En el campo Secreto del cliente, ingresa un valor. Este valor se usa para verificar los eventos de webhook de Microsoft SharePoint. Recomendamos usar una cadena de 20 caracteres.

8. Haz clic en Guardar.

   Espera a que el campo Sincronización en tiempo real cambie a En ejecució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 Microsoft SharePoint y enviar una búsqueda a Gemini Enterprise, ocurrirá lo siguiente:

• Gemini Enterprise envía tu 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 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 Microsoft).
• 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 Microsoft SharePoint. 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 Microsoft.

¿Qué sigue?

• Para proporcionar una interfaz de usuario para consultar tus datos de Microsoft SharePoint, crea una app y conéctala al almacén de datos de Microsoft SharePoint.
• Para ver la lista de acciones, consulta Cómo ver acciones.
• 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.