Panoramica

Il datastore Microsoft SharePoint per Gemini Enterprise ti consente di cercare ed eseguire azioni sui tuoi dati di Microsoft SharePoint Online, inclusi documenti, elenchi e siti.

Versioni di Microsoft SharePoint supportate

Il datastore Microsoft SharePoint supporta l'ultima versione cloud di Microsoft SharePoint Online.

Azioni supportate

Quando il datastore Microsoft SharePoint è abilitato, gli utenti finali possono utilizzare i comandi in linguaggio naturale in Gemini Enterprise per eseguire le seguenti azioni.

Azione Descrizione
Crea cartella Crea una nuova cartella in un percorso specificato.
Aggiungi elenco Crea un nuovo elenco di dati strutturati (ad esempio attività, contatti) nel sito Microsoft SharePoint.
Carica documento Carica un documento in un sito o una raccolta di Microsoft SharePoint.
Scarica documento Scarica un documento da un sito o una raccolta Microsoft SharePoint.
Aggiungi pagina Crea una nuova pagina sul sito Microsoft SharePoint.
Estrarre il documento Estrai un documento da una raccolta Microsoft SharePoint.
Check-in nel documento Archivia un documento in una raccolta Microsoft SharePoint.
Rinominare un allegato o un documento Rinomina un allegato o un documento in una raccolta Microsoft SharePoint.
Spostare un allegato o un documento Sposta un documento da una raccolta Microsoft SharePoint a una raccolta, una cartella o un altro sito SharePoint di destinazione.

Autorizzazioni obbligatorie

Per consentire a Gemini Enterprise di eseguire la ricerca e l'importazione dati utilizzando il datastore Microsoft SharePoint, devi disporre delle seguenti autorizzazioni:

Autorizzazioni API Microsoft Graph

La tabella seguente descrive le autorizzazioni richieste per ogni modalità di connessione.

Nota:la tabella seguente illustra le autorizzazioni richieste per ogni modalità di connessione. Se attivi Azioni per la modalità di connessione Ricerca federata o Importazione dati, seleziona anche le autorizzazioni elencate nella riga Azioni.

Modalità di connessione Ambito Purpose
Ricerca federata N/D Non sono richieste autorizzazioni API Graph.
Importazione dati GroupMember.Read.All (Credenziali federate e token di aggiornamento OAuth 2.0) Consente al datastore di leggere le iscrizioni e le proprietà di base dei gruppi per tutti i gruppi senza un utente che ha eseguito l'accesso.
User.Read (Credenziali federate e token di aggiornamento OAuth 2.0) Consente al datastore di leggere il profilo degli utenti che hanno eseguito l'accesso. Consente inoltre al datastore di leggere le informazioni di base dell'azienda degli utenti che hanno eseguito l'accesso.
User.Read.All (Solo token di aggiornamento OAuth 2.0) Consente al datastore di leggere i profili utente.
Sites.FullControl.All (Opzione 1)
Sites.Selected (Opzione 2)		 (Credenziali federate e token di aggiornamento OAuth 2.0) L'opzione 1 consente al datastore di avere il controllo completo di tutte le raccolte di siti. L'opzione 2 consente al datastore di accedere a un sottoinsieme di raccolte di siti. Le raccolte di siti specifiche e le autorizzazioni concesse possono essere configurate in SharePoint Online.
User.Read.All (Opzione 1)
User.ReadBasic.All (Opzione 2)		 (Solo credenziali federate) L'opzione 1 consente al datastore di leggere i profili utente. L'opzione 2 consente al datastore di leggere un insieme di base di proprietà del profilo di altri utenti dell'organizzazione.
Azioni Sites.ReadWrite.All (Ricerca federata e importazione dati) Consente al datastore di modificare o eliminare documenti ed elementi di elenco in tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso.
Files.ReadWrite Consente al datastore di leggere, creare, aggiornare ed eliminare i file dell'utente che ha eseguito l'accesso.
Files.ReadWrite.All Consente al datastore di leggere, creare, aggiornare, eliminare, caricare e scaricare tutti i file a cui l'utente che ha eseguito l'accesso può accedere.
Sites.Manage.All Consente al datastore di creare o eliminare librerie di documenti ed elenchi in tutte le raccolte di siti per conto dell'utente.

Autorizzazioni API Microsoft SharePoint

La tabella seguente descrive le autorizzazioni richieste per ogni modalità di connessione.

Modalità di connessione Ambito Purpose
Ricerca federata Sites.Search.All (delegato) Consente al datastore di eseguire query di ricerca e di leggere le informazioni di base del sito per conto dell'utente attualmente connesso. I risultati di ricerca si basano sulle autorizzazioni dell'utente anziché su quelle dell'app.
AllSites.Read (opzione 1, delegata) Consente al datastore di leggere documenti ed elementi di elenco in tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso.
Sites.Selected (opzione 2, delegato) Consente al datastore di accedere a un sottoinsieme di raccolte di siti con un utente che ha eseguito l'accesso. Le raccolte di siti specifiche e le autorizzazioni concesse possono essere configurate in SharePoint Online.
Importazione dati (credenziali federate) Sites.FullControl.All (opzione 1, applicazione) Consente al datastore di avere il controllo completo di tutte le raccolte di siti.
Sites.Selected (opzione 2, applicazione) Consente al datastore di accedere a un sottoinsieme di raccolte di siti con un utente che ha eseguito l'accesso. Le raccolte di siti specifiche e le autorizzazioni concesse possono essere configurate in SharePoint Online.
Importazione dei dati (token di aggiornamento OAuth 2.0) AllSites.FullControl (opzione 1, delegata) Consente al datastore di avere il controllo completo di tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso.
Sites.Selected (opzione 2, delegato) Consente al datastore di accedere a un sottoinsieme di raccolte di siti con un utente che ha eseguito l'accesso. Le raccolte di siti specifiche e le autorizzazioni concesse possono essere configurate in SharePoint Online.
Azioni AllSites.Write (delegato) Consente al datastore di creare, leggere, aggiornare, eliminare, caricare e scaricare documenti ed elementi di elenco in tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso.

Per informazioni su come aggiungere le autorizzazioni per Microsoft SharePoint, vedi Configurare Microsoft SharePoint e impostare le autorizzazioni necessarie.

Limitazioni

Questa sezione descrive i problemi noti e le limitazioni che potrebbero influire sull'utilizzo del datastore Microsoft SharePoint.

  • Quando crei una nuova app o aggiungi un datastore a uno esistente, ti consigliamo di associare un solo datastore alle azioni appartenenti a un unico tipo di connettore.
  • L'applicazione di un perimetro di Controlli di servizio VPC ai datastore Microsoft SharePoint esistenti non è supportata. Per applicare i Controlli di servizio VPC, devi eliminare e ricreare i datastore. Per saperne di più sui Controlli di servizio VPC e su come utilizzare le azioni dopo averli attivati, consulta Proteggere l'app con i Controlli di servizio VPC.
  • Il datastore Microsoft SharePoint è supportato solo nelle località global, us e eu.

Di seguito sono riportate le limitazioni per il datastore federato Microsoft SharePoint:

  • Limitazioni della ricerca: i risultati di ricerca possono variare e non sono sempre esaustivi per tutti i tipi di file. I contenuti nelle cartelle archiviate o criptate potrebbero non essere accessibili per la ricerca. La ricerca federata non supporta la ricerca all'interno degli allegati.
  • Accesso delegato:l'accesso a siti o librerie condivisi potrebbe richiedere autorizzazioni specifiche non coperte dall'autorizzazione utente standard.
  • Layout Parser in modalità di ricerca federata:sebbene il layout parser sia standard, la sua efficacia sui PDF complessi (con tabelle, layout a più colonne o che richiedono l'OCR) è limitata in modalità di ricerca federata. Le chiamate API in tempo reale di questa modalità potrebbero non fornire i dati completi o il tempo necessario per l'analisi approfondita eseguita dal parser del layout durante l'importazione dati.
  • Funzionalità PDF non supportate:di conseguenza, le strutture PDF complesse potrebbero non essere analizzate o ricercabili completamente. Ciò include:
    • Layout di testo a più colonne
    • Dati all'interno di tabelle e grafici incorporati
    • Testo nei documenti scansionati che richiede il riconoscimento ottico dei caratteri (OCR)
    • Documenti con ordini di lettura non lineari o formattazione complessa.

Suggerimento

Per i dati di Microsoft SharePoint contenenti PDF con funzionalità complesse (come tabelle, layout a più colonne o contenuti dipendenti dall'OCR), consigliamo di utilizzare la modalità di importazione standard per una ricerca efficace. Questa modalità consente al parser del layout di elaborare e indicizzare in modo approfondito l'intero contenuto del documento.

Passaggi successivi