Panoramica

Il datastore Microsoft SharePoint per Gemini Enterprise ti consente di cercare ed eseguire azioni sui 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 è attivo, 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 es. attività, contatti) sul sito Microsoft SharePoint.
Carica documento Carica un documento in un sito o in una raccolta Microsoft SharePoint.
Scarica documento Scarica un documento da un sito o da una raccolta Microsoft SharePoint.
Aggiungi pagina Crea una nuova pagina sul sito Microsoft SharePoint.
Estrai documento Estrai un documento da una raccolta Microsoft SharePoint.
Archivia documento Archivia un documento in una raccolta Microsoft SharePoint.
Rinomina allegato o documento Rinomina un allegato o un documento in una raccolta Microsoft SharePoint.
Sposta allegato o 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 illustra le autorizzazioni richieste per ogni modalità di connessione.

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

Modalità di connessione Ambito Scopo
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 appartenenze 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 sull'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 raccolte di documenti ed elenchi in tutte le raccolte di siti per conto dell'utente.

Autorizzazioni API Microsoft SharePoint

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

Modalità di connessione Ambito Scopo
Ricerca federata Sites.Search.All (Delegato) Consente al datastore di eseguire query di ricerca e di leggere le informazioni di base sul sito per conto dell'utente che ha eseguito l'accesso. I risultati di ricerca si basano sulle autorizzazioni dell'utente anziché su quelle dell'app.
AllSites.Read (Opzione 1, Delegato) 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 dati (token di aggiornamento OAuth 2.0) AllSites.FullControl (Opzione 1, Delegato) 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, consulta Configurare Microsoft SharePoint e impostare le autorizzazioni necessarie.

Limitazioni

Questa sezione illustra 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 una esistente, ti consigliamo di associare un solo datastore alle azioni appartenenti a un singolo 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 global, us ed eu località.

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

  • Limitazioni di 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 raccolte condivisi potrebbe richiedere autorizzazioni specifiche non coperte dall'autorizzazione utente standard.
  • Analizzatore di layout in modalità di ricerca federata: sebbene l'analizzatore di layout 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 dall'analizzatore di layout durante l'importazione dati.
  • Funzionalità PDF non supportate: di conseguenza, le strutture PDF complesse potrebbero non essere completamente analizzate o ricercabili. Sono inclusi:
    • Layout di testo a più colonne
    • Dati all'interno di tabelle e grafici incorporati
    • Testo nei documenti sottoposti a scansione che richiedono il riconoscimento ottico dei caratteri (OCR)
    • Documenti con ordini di lettura non lineari o formattazione complessa.

Suggerimento

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

Passaggi successivi