Panoramica

Il datastore di Microsoft OneDrive per Gemini Enterprise ti 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 è 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 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.
Copia cartella Copia una cartella da un'origine a una destinazione in Microsoft OneDrive.
Sposta file Sposta un file da un'origine a una destinazione in Microsoft OneDrive.
Sposta cartella Sposta una cartella da un'origine a una destinazione in Microsoft OneDrive.
Rinomina file Rinomina un file in Microsoft OneDrive.
Rinomina cartella Rinomina una cartella in Microsoft OneDrive.
Condividi file o cartella Condivide un file o una cartella con i destinatari specificati o genera un link di condivisione.
Aggiorna le proprietà del file Aggiorna le proprietà dei metadati di un file in Microsoft OneDrive.

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 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 Files.Read.All (Delegato) Consente al datastore di leggere tutti i file a cui l'utente può accedere.
Sites.Read.All (Delegata) Consente al datastore di leggere i documenti e gli elementi dell'elenco in tutte le raccolte di siti a cui l'utente può accedere.
User.Read.All (Delegato) Consente al datastore di risolvere le posizioni di Drive degli utenti per il rilevamento dei contenuti.
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 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 Delegato: consente al datastore di leggere, scaricare, creare, caricare, aggiornare ed eliminare i file a cui l'utente può accedere.
Files.ReadWrite.All (Delegato) Consente al datastore di leggere e aggiornare i file in tutti i Drive a cui l'utente ha accesso. Obbligatorio per le azioni di modifica di file e cartelle (copia, spostamento, ridenominazione, condivisione, aggiornamento delle proprietà) che operano sui file archiviati in unità diverse da Microsoft OneDrive dell'utente.

Per informazioni su come aggiungere le autorizzazioni per Microsoft OneDrive, consulta Configura Microsoft OneDrive e imposta le autorizzazioni necessarie.

Limitazioni

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

  • 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 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 Proteggi la tua app con i Controlli di servizio VPC.
  • Il datastore Microsoft OneDrive è supportato solo nelle località global, us e eu.

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

  • 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 file o cartelle di Microsoft OneDrive 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. È incluso quanto segue:

    • 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.

Di seguito sono riportate le limitazioni per il datastore di importazione di 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), consigliamo di utilizzare la modalità di importazione dati per una ricerca efficace. Questa modalità consente al parser del layout di elaborare e indicizzare in modo approfondito l'intero contenuto del documento.

Passaggi successivi