Il datastore Microsoft SharePoint per Gemini Enterprise fornisce l'accesso ai tuoi dati Microsoft SharePoint Online, consentendoti di interagire con 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 ldatastore 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 es. attività, contatti) nel sito SharePoint. |
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 all'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 all'datastore di leggere il profilo degli utenti che hanno eseguito l'accesso. Consente inoltre all'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 all'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 all'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 all'datastore di leggere i profili utente. L'opzione 2 consente all'datastore di leggere un insieme di base di proprietà del profilo di altri utenti dell'organizzazione. | |
| Azioni | Sites.ReadWrite.All |
(Ricerca federata e importazione dei dati) Consente all'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 all'datastore di leggere, creare, aggiornare ed eliminare tutti i file a cui l'utente che ha eseguito l'accesso può accedere. | |
Sites.Manage.All |
Consente all'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 all'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 all'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 all'datastore di avere il controllo completo di tutte le raccolte di siti. |
Sites.Selected (opzione 2, applicazione) |
Consente all'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 all'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 all'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 ed eliminare documenti ed elenchi di elementi 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 applicazione o aggiungi un datastore a uno esistente, ti consigliamo di aggiungere un solo datastore con azioni appartenenti a un unico tipo di connettore, indipendentemente dalla modalità di connessione. Ad esempio, non associare due datastore Microsoft SharePoint con azioni attivate alla stessa applicazione.
- L'applicazione di un perimetro 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,USeEU.
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.
Passaggi successivi
- Per creare e configurare un datastore con Microsoft SharePoint, vedi Configurare un datastore Microsoft SharePoint.