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 è 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 in una raccolta di Microsoft SharePoint.
Scarica documento Scarica un documento da un sito o da una raccolta di Microsoft SharePoint.
Aggiungi pagina Crea una nuova pagina nel sito Microsoft SharePoint.
Estrai documento Estrai un documento da una raccolta di Microsoft SharePoint.
Archivia documento Archivia un documento in una raccolta di Microsoft SharePoint.
Rinomina allegato o documento Rinomina un allegato o un documento in una raccolta di Microsoft SharePoint.
Sposta allegato o documento Sposta un documento da una raccolta di Microsoft SharePoint a una raccolta, una cartella o un altro sito SharePoint di destinazione.
Annulla estrazione documento Annulla l'estrazione di un documento, ripristinandolo senza salvare le modifiche.
Condividi risorsa Condivide un documento, una cartella o una risorsa con i destinatari specificati o genera un link di condivisione.
Aggiorna proprietà file Aggiorna le proprietà dei metadati di un documento in una raccolta di Microsoft SharePoint.
Aggiorna pagina Aggiorna una pagina esistente nel sito Microsoft SharePoint.
Aggiorna elenco Aggiorna le impostazioni di un elenco di dati strutturati esistente nel sito Microsoft SharePoint.
Crea elemento elenco Crea un nuovo elemento in un elenco specificato nel sito Microsoft SharePoint.
Aggiorna elemento elenco Aggiorna i campi di un elemento esistente in un elenco specificato.
Elenca elenchi Recupera tutti gli elenchi e le raccolte di documenti in un sito Microsoft SharePoint specificato.
Scarica elemento elenco Restituisce un singolo elemento elenco, inclusi tutti i valori delle colonne.
Scarica campi elenco Restituisce lo schema di un elenco specificato, inclusi tutti i campi e le relative proprietà.

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 abiliti Azioni per la modalità di connessione Ricerca federata o Acquisizione dei dati, seleziona anche le autorizzazioni elencate nella riga Azioni.

Modalità di connessione Ambito Scopo
Ricerca federata N/D Non sono richieste autorizzazioni API Graph.
Acquisizione dei 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 acquisizione dei dati) Consente al datastore di modificare o eliminare documenti ed elementi elenco in tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso.
Sites.Read.All (Ricerca federata e acquisizione dei dati) Consente al datastore di leggere elenchi, elementi elenco e schemi di elenchi in tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso. Obbligatoria per le azioni elenca elenchi, scarica elemento elenco e scarica campi elenco.
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 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.
Acquisizione dei 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.
Acquisizione dei 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 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 abilitati, consulta Proteggere l'app con i Controlli di servizio VPC.
  • Il datastore Microsoft SharePoint è supportato solo nelle global, us ed eu località.

  • Prerequisito per la qualità della ricerca: per ottenere risultati di ricerca ottimali e sfruttare appieno le funzionalità di Knowledge Graph, ti consigliamo di configurare e sincronizzare il datastore People Search oltre al datastore Microsoft SharePoint.

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 completi 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 contenenti 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.

Risolvere i problemi relativi ai risultati di ricerca del connettore SharePoint

Se riscontri problemi con documenti mancanti, risultati errati o scarsa pertinenza della ricerca, controlla le seguenti aree di diagnostica:

  • Controlla il datastore People: assicurati che il datastore People Search sia configurato e sincronizzato se riscontri problemi di pertinenza o di corrispondenza delle entità.
  • Errori di autenticazione: gli errori di autenticazione persistenti, ad esempio "Errore durante il recupero del token di accesso all'API Graph", impediscono il funzionamento delle ricerche. Per risolvere il problema, controlla i log di Microsoft Entra ID per i dettagli e poi esegui di nuovo l'autenticazione della connessione.
  • Mancata corrispondenza dell'identità: se utilizzi Google Identity, verifica che l'indirizzo email Google dell'utente corrisponda esattamente al suo indirizzo email Microsoft SharePoint. Le mancate corrispondenze impediscono la restituzione dei risultati.
  • Ricerche di cartelle mirate (URL .aspx): la ricerca con URL del browser completi che terminano con /Forms/AllItems.aspx esegue una ricerca nell'intero sito, non solo nella cartella specifica. Utilizza sempre percorsi di cartelle assoluti per le ricerche mirate.
  • Limiti dei risultati: tieni presente che le ricerche federate potrebbero avere limiti al numero di documenti restituiti per query (in genere con un limite di circa 20 risultati).
  • Problemi di citazione: possono verificarsi citazioni errate intermittenti. Se il problema persiste, segnalalo all'assistenza e includi i token di diagnostica.
  • Compatibilità modello-connettore: assicurati di utilizzare le versioni più recenti dei modelli Gemini. Alcuni modelli precedenti (ad esempio 3.x) presentano problemi noti con gli strumenti di risoluzione per le azioni di SharePoint, ad esempio download_document in Agent Builder.

Passaggi successivi