Descripción general

El almacén de datos de Microsoft SharePoint para Gemini Enterprise te permite buscar y realizar acciones en tus datos de Microsoft SharePoint Online , incluidos documentos, listas y sitios.

Versiones de Microsoft SharePoint compatibles

El almacén de datos de Microsoft SharePoint admite la versión más reciente en la nube de Microsoft SharePoint Online.

Acciones compatibles

Cuando el almacén de datos de Microsoft SharePoint está habilitado, los usuarios finales pueden usar comandos de lenguaje natural en Gemini Enterprise para realizar las siguientes acciones.

Acción Descripción
Crear carpeta Crea una carpeta nueva en una ruta de acceso especificada.
Agregar lista Crea una nueva lista de datos estructurados (por ejemplo, tareas, contactos) en el sitio de Microsoft SharePoint.
Subir documento Sube un documento a un sitio o biblioteca de Microsoft SharePoint.
Descargar documento Descarga un documento de un sitio o biblioteca de Microsoft SharePoint.
Agregar página Crea una página nueva en el sitio de Microsoft SharePoint.
Extraer documento Extrae un documento de una biblioteca de Microsoft SharePoint.
Registrar documento Registra un documento en una biblioteca de Microsoft SharePoint.
Cambiar el nombre del documento o archivo adjunto Cambia el nombre de un documento o archivo adjunto en una biblioteca de Microsoft SharePoint.
Mover el documento o archivo adjunto Mueve un documento de una biblioteca de Microsoft SharePoint a una biblioteca, carpeta o sitio de SharePoint de destino.

Permisos necesarios

Para permitir que Gemini Enterprise realice búsquedas y transferencias de datos con el almacén de datos de Microsoft SharePoint, necesitas los siguientes permisos:

Permisos de la API de Microsoft Graph

En la siguiente tabla, se describen los permisos necesarios para cada modo de conexión.

Nota: En la siguiente tabla, se describen los permisos necesarios para cada modo de conexión. Si habilitas Acciones para el modo de conexión de Búsqueda federada o Transferencia de datos, selecciona también los permisos que se indican en la fila Acciones.

Modo de conexión Alcance Purpose
Búsqueda federada N/A No se requieren permisos de la API de Graph.
Transferencia de datos GroupMember.Read.All (Credenciales federadas y token de actualización de OAuth 2.0) Permite que el almacén de datos lea las membresías y las propiedades básicas de los grupos para todos los grupos sin un usuario que haya accedido.
User.Read (Credenciales federadas y token de actualización de OAuth 2.0) Permite que el almacén de datos lea el perfil de los usuarios que accedieron. También permite que el almacén de datos lea la información básica de la empresa de los usuarios que accedieron.
User.Read.All (Solo token de actualización de OAuth 2.0) Permite que el almacén de datos lea los perfiles de los usuarios.
Sites.FullControl.All (Opción 1)
Sites.Selected (Opción 2)		 (Credenciales federadas y token de actualización de OAuth 2.0) La opción 1 permite que el almacén de datos tenga control total de todas las colecciones de sitios. La opción 2 permite que el almacén de datos acceda a un subconjunto de colecciones de sitios. Las colecciones de sitios específicas y los permisos otorgados se pueden configurar en SharePoint Online.
User.Read.All (Opción 1)
User.ReadBasic.All (Opción 2)		 (Solo credenciales federadas) La opción 1 permite que el almacén de datos lea los perfiles de los usuarios. La opción 2 permite que el almacén de datos lea un conjunto básico de propiedades de perfil de otros usuarios de la organización.
Acciones Sites.ReadWrite.All (Búsqueda federada y transferencia de datos) Permite que el almacén de datos edite o borre documentos y elementos de lista en todas las colecciones de sitios en nombre del usuario que accedió.
Files.ReadWrite Permite que el almacén de datos lea, cree, actualice y borre los archivos del usuario que accedió.
Files.ReadWrite.All Permite que el almacén de datos lea, cree, actualice, borre, suba y descargue todos los archivos a los que puede acceder el usuario que accedió.
Sites.Manage.All Permite que el almacén de datos cree o borre bibliotecas de documentos y listas en todas las colecciones de sitios en nombre del usuario.

Permisos de la API de Microsoft SharePoint

En la siguiente tabla, se describen los permisos necesarios para cada modo de conexión.

Modo de conexión Alcance Purpose
Búsqueda federada Sites.Search.All (Delegado) Permite que el almacén de datos ejecute consultas de búsqueda y lea información básica del sitio en nombre del usuario actual que accedió. Los resultados de la búsqueda se basan en los permisos del usuario en lugar de los permisos de la app.
AllSites.Read (Opción 1, delegado) Permite que el almacén de datos lea documentos y elementos de lista en todas las colecciones de sitios en nombre del usuario que accedió.
Sites.Selected (Opción 2, delegado) Permite que el almacén de datos acceda a un subconjunto de colecciones de sitios con un usuario que accedió. Las colecciones de sitios específicas y los permisos otorgados se pueden configurar en SharePoint Online.
Transferencia de datos (credenciales federadas) Sites.FullControl.All (Opción 1, aplicación) Permite que el almacén de datos tenga control total de todas las colecciones de sitios.
Sites.Selected (Opción 2, aplicación) Permite que el almacén de datos acceda a un subconjunto de colecciones de sitios con un usuario que accedió. Las colecciones de sitios específicas y los permisos otorgados se pueden configurar en SharePoint Online.
Transferencia de datos (token de actualización de OAuth 2.0) AllSites.FullControl (Opción 1, delegado) Permite que el almacén de datos tenga control total de todas las colecciones de sitios en nombre del usuario que accedió.
Sites.Selected (Opción 2, delegado) Permite que el almacén de datos acceda a un subconjunto de colecciones de sitios con un usuario que accedió. Las colecciones de sitios específicas y los permisos otorgados se pueden configurar en SharePoint Online.
Acciones AllSites.Write (Delegado) Permite que el almacén de datos cree, lea, actualice, borre, suba y descargue documentos y elementos de lista en todas las colecciones de sitios en nombre del usuario que accedió.

Para obtener información sobre cómo agregar los permisos para Microsoft SharePoint, consulta Configura Microsoft SharePoint y establece los permisos necesarios.

Limitaciones

En esta sección, se describen los problemas conocidos y las limitaciones que pueden afectar tu uso del almacén de datos de Microsoft SharePoint.

  • Cuando crees una app nueva o agregues un almacén de datos a una existente, te recomendamos que asocies solo un almacén de datos con acciones que pertenezcan a un solo tipo de conector.
  • No se admite la aplicación de un perímetro de los Controles del servicio de VPC en los almacenes de datos de Microsoft SharePoint existentes. Para aplicar los Controles del servicio de VPC, debes borrar y volver a crear los almacenes de datos. Para obtener más información sobre los Controles del servicio de VPC y cómo usar las acciones después de habilitarlos, consulta Protege tu app con los Controles del servicio de VPC.
  • El almacén de datos de Microsoft SharePoint solo se admite en las global, us, y eu ubicaciones.

Estas son las limitaciones del almacén de datos federado de Microsoft SharePoint:

  • Limitaciones de búsqueda: Los resultados de la búsqueda pueden variar y no siempre son integrales para todos los tipos de archivos. Es posible que no se pueda acceder al contenido de las carpetas archivadas o encriptadas para la búsqueda. La búsqueda federada no admite la búsqueda dentro de archivos adjuntos.
  • Acceso delegado: El acceso a sitios o bibliotecas compartidos puede requerir permisos específicos que no están cubiertos por la autorización estándar del usuario.
  • Analizador de diseño en el modo de búsqueda federada: Si bien el analizador de diseño es estándar, su eficacia en archivos PDF complejos (con tablas, diseños de varias columnas o que necesitan OCR) es limitada en el modo de búsqueda federada. Es posible que las llamadas a la API en tiempo real de este modo no proporcionen los datos completos o el tiempo necesario para el análisis profundo que realiza el analizador de diseño durante la transferencia de datos.
  • Funciones de PDF no compatibles: Por lo tanto, es posible que las estructuras de PDF complejas no se analicen por completo ni se puedan buscar. Esto incluye lo siguiente:
    • Diseños de texto de varias columnas
    • Datos dentro de tablas y gráficos incorporados
    • Texto en documentos escaneados que requieren reconocimiento óptico de caracteres (OCR)
    • Documentos con órdenes de lectura no lineales o formato complejo

Recomendación

Para los datos de Microsoft SharePoint que contienen archivos PDF con funciones complejas (como tablas, diseños de varias columnas o contenido dependiente de OCR), te recomendamos que uses el modo de transferencia estándar para realizar búsquedas efectivas. Este modo permite que el analizador de diseño procese y, luego, indexe en profundidad todo el contenido del documento.

¿Qué sigue?