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) sul 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 di Microsoft SharePoint.
Aggiungi pagina Crea una nuova pagina sul sito di Microsoft SharePoint.
Estrai documento Esegui il check-out di un documento da una raccolta di Microsoft SharePoint.
Archivia documento Archiviare un documento in una raccolta di Microsoft SharePoint.
Rinomina l'allegato o il 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 o cartella di destinazione o a un altro sito di SharePoint.
Elimina documento di check-out Annulla un check-out su 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 le proprietà del file Aggiorna le proprietà dei metadati di un documento in una raccolta di Microsoft SharePoint.
Aggiorna pagina Aggiorna una pagina esistente sul sito Microsoft SharePoint.
Aggiorna elenco Aggiorna le impostazioni di un elenco di dati strutturati esistente sul sito Microsoft SharePoint.
Crea elemento dell'elenco Crea un nuovo elemento in un elenco specificato sul 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.
Ottieni voce elenco Restituisce un singolo elemento dell'elenco, inclusi tutti i valori delle colonne.
Ottieni campi elenco Restituisce lo schema di un elenco specificato, inclusi tutti i relativi 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 necessarie 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 Acquisizione dei dati, seleziona anche le autorizzazioni elencate nella riga Azioni.

Modalità di connessione Ambito Purpose
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 iscrizioni e le proprietà di base di 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 di 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 di elenchi e schemi di elenchi in tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso. Obbligatorio per le azioni Elenca elenchi, Recupera elemento dell'elenco e Recupera campi dell'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 necessarie 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 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 i documenti e gli elementi dell'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 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 Configura Microsoft SharePoint e imposta 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 un'app esistente, ti consigliamo di associare un solo datastore alle azioni appartenenti a un singolo tipo di connettore.
  • L'applicazione di un perimetro dei 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 Proteggi la tua app con i Controlli di servizio VPC.
  • Il datastore Microsoft SharePoint è supportato solo nelle località global, us e eu.

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

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

  • Limitazioni della ricerca: i risultati di ricerca possono variare e non sono sempre completi per tutti i tipi di file. I contenuti delle 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.
  • Parser di layout in modalità di ricerca federata: sebbene il parser di layout sia standard, la sua efficacia su 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 o il tempo completi necessari 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 completamente analizzate o ricercabili. Sono inclusi:
    • Layout di testo a più colonne
    • Dati all'interno di tabelle e grafici incorporati
    • Testo in documenti scansionati 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), 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.

Risoluzione dei 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 Persone: assicurati che il datastore di ricerca delle persone sia configurato e sincronizzato se riscontri problemi di pertinenza o di corrispondenza delle entità.
  • Errori di autenticazione: gli errori di autenticazione persistenti, come "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 autentica nuovamente la 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 completi del browser che terminano con /Forms/AllItems.aspx esegue una ricerca nell'intero sito, non solo nella cartella specifica. Utilizza sempre i percorsi assoluti delle cartelle per le ricerche mirate.
  • Limiti dei risultati: tieni presente che le ricerche federate potrebbero avere limiti sul numero di documenti restituiti per query (in genere 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à con il modello di connettore: assicurati di utilizzare le versioni più recenti del modello Gemini. Alcuni modelli meno recenti (ad esempio 3.x) presentano problemi noti di risoluzione degli strumenti per le azioni di SharePoint, come download_document in Agent Builder.

Passaggi successivi