Panoramica

Il datastore Microsoft SharePoint per Gemini Enterprise ti consente di cercare ed eseguire azioni sui tuoi dati 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 Estrarre un documento da una raccolta Microsoft SharePoint.
Esegui il check-in del 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.
Elimina il documento di estrazione Annulla l'estrazione di un documento, ripristinandolo senza salvare le modifiche.
Condividere una 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 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 di 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 di 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 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 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 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 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, Ottieni elemento elenco e Ottieni 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 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 elencare elementi in tutte le raccolte di siti per conto dell'utente che ha eseguito l'accesso.
Sites.Selected (opzione 2, delegata) 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, 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, delegata) 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 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 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 delle persone oltre al datastore Microsoft SharePoint.

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. Sono inclusi:
    • 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.

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 People: assicurati che il datastore People Search sia configurato e sincronizzato se riscontri problemi di pertinenza o corrispondenza delle entità.
  • Errori di autenticazione:gli errori di autenticazione persistenti, ad esempio "Errore durante il recupero del token di accesso all'API Graph", impediranno il funzionamento delle ricerche. Per risolvere il problema, controlla i log di Microsoft Entra ID per i dettagli, poi esegui nuovamente l'autenticazione della connessione.
  • Mancata corrispondenza dell'identità:se utilizzi Google Identity, verifica che l'email Google dell'utente corrisponda esattamente alla sua email Microsoft SharePoint. Le mancate corrispondenze impediscono la restituzione dei risultati.
  • Ricerche mirate di cartelle (URL .aspx): la ricerca con URL completi del browser che terminano con /Forms/AllItems.aspx viene eseguita sull'intero sito, non solo sulla 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 il 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à connettore-modello:assicurati di utilizzare le versioni più recenti dei modelli Gemini. Alcuni modelli meno recenti (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