Panoramica

Il datastore Microsoft OneDrive per Gemini Enterprise consente di cercare ed eseguire azioni su file e cartelle.

Versioni di Microsoft OneDrive supportate

Il datastore Microsoft OneDrive supporta tutte le versioni ospitate di Microsoft OneDrive tramite l'API Microsoft Graph v1.0.

Azioni supportate

Quando il datastore Microsoft OneDrive è 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 in Microsoft OneDrive.
Copia file Copia un file da un'origine a una destinazione in Microsoft OneDrive.
Carica file Carica un file in una posizione specificata in Microsoft OneDrive.
Scarica file Scarica un file da Microsoft OneDrive in una posizione specificata.

Autorizzazioni obbligatorie

Per consentire a Gemini Enterprise di eseguire la ricerca e l'importazione dati utilizzando il datastore Microsoft OneDrive, 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 Files.Read.All (Delegata) Consente al datastore di leggere tutti i file a cui l'utente può accedere.
Sites.Read.All (Delegata) Consente al datastore di leggere documenti ed elementi di elenco in tutte le raccolte di siti a cui l'utente può accedere.
User.Read.All (Delegata) Consente al datastore di risolvere le posizioni delle unità utente per la rilevazione dei contenuti.
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 Microsoft OneDrive.
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 Files.ReadWrite.AppFolder (Delegata) Consente al datastore di leggere, creare, aggiornare ed eliminare i file nella cartella Microsoft OneDrive.
Files.ReadWrite Delegata: consente al datastore di leggere, scaricare, creare, caricare, aggiornare ed eliminare i file a cui l'utente può accedere.

Per informazioni su come aggiungere le autorizzazioni per Microsoft OneDrive, consulta Configurare Microsoft OneDrive e impostare le autorizzazioni necessarie.

Limitazioni

Questa sezione illustra i problemi noti e le limitazioni che potrebbero influire sull'utilizzo del datastore Microsoft OneDrive.

  • 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 OneDrive 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 OneDrive è supportato solo nelle global, us ed eu località.

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

  • Limitazioni di ricerca: i risultati di ricerca possono variare e non sono sempre esaustivi 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 file o cartelle di Microsoft OneDrive 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 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 richiedono il riconoscimento ottico dei caratteri (OCR)
    • Documenti con ordini di lettura non lineari o formattazione complessa.

Di seguito sono riportate le limitazioni per il datastore di importazione Microsoft OneDrive:

  • La sincronizzazione incrementale non rileva le azioni a livello di cartella come Copia, Sposta o Rinomina.

Suggerimento

Per i dati di Microsoft OneDrive contenenti PDF con funzionalità complesse (come tabelle, layout a più colonne o contenuti dipendenti dall'OCR), ti consigliamo di utilizzare la modalità di importazione dati 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