Panoramica

Il datastore Box per Gemini Enterprise ti consente di cercare ed eseguire azioni sui dati e sui record di Box.

Versioni di Box supportate

Il datastore Box supporta la versione dell'API Box 2024.0.

Azioni supportate

Quando il datastore Box è attivo, gli utenti finali possono utilizzare i comandi in linguaggio naturale in Gemini Enterprise per eseguire la seguente azione.

Azione Descrizione
Copia file Crea un duplicato di un file all'interno di una cartella di destinazione, lasciando invariato il file originale.
Carica file Carica un file in una cartella specificata in Box.
Scarica file Scarica un file da Box.

Ambiti obbligatori

Per consentire a Gemini Enterprise di eseguire ricerche, azioni e importazione dati utilizzando il datastore Box, devi disporre dei seguenti ambiti:

Modalità di connessione Ambito Scopo
Ricerca federata Read all files and folders stored in Box Obbligatorio per recuperare commenti e attività e per visualizzare l'anteprima dei file per la ricerca.
Ricerca federata e azioni Write all files and folders stored in Box Obbligatorio per copiare, caricare e scaricare file, nonché per recuperare commenti e attività e per visualizzare l'anteprima dei file per la ricerca.
Importazione dati Read all files and folders stored in Box Obbligatorio per importazione dati.
Manage users Obbligatorio per recuperare l'elenco degli utenti, consentendo il recupero di file, commenti e attività dai singoli account utente per l'importazione. L'account di servizio dell'amministratore non ha accesso intrinseco a tutti i file di proprietà dell'utente. L'intestazione as-user consente al sistema di effettuare richieste API come utente specifico per accedere ai suoi dati.
Manage enterprise properties Necessario per la funzionalità di sincronizzazione incrementale, in quanto facilita l'utilizzo dello stream di eventi Enterprise per monitorare le modifiche per l'importazione.
Manage groups Obbligatorio per recuperare l'elenco dei gruppi e dei relativi membri. Questo è fondamentale per il controllo dell'accesso durante l'importazione.

Per informazioni su come aggiungere queste autorizzazioni per Box, consulta Configurare Box e impostare le autorizzazioni necessarie.

Limitazioni

Il datastore Box per Gemini Enterprise presenta le seguenti limitazioni:

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

  • Il datastore federato Box utilizza le API Box per la ricerca. Di conseguenza, la qualità della ricerca dipende dai risultati forniti dalla ricerca Box. Ciò può comportare limitazioni nella qualità della ricerca per le lingue diverse dall'inglese, perché le API Box potrebbero non essere completamente ottimizzate per queste lingue. Per ottenere una migliore qualità della ricerca in questi scenari, utilizza invece il datastore di importazione.

Passaggi successivi