Panoramica

Il datastore Box per Gemini Enterprise ti consente di accedere ai tuoi dati Box e interagire con i record.

Versioni di Box supportate

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

Azioni supportate

Quando ldatastore Box è abilitato, 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.

Ambiti obbligatori

Per consentire a Gemini Enterprise di eseguire ricerche, azioni e importazione dati utilizzando il datastore Box, sono necessari i seguenti ambiti:

Modalità di connessione Ambito Purpose
Ricerca federata Read all files and folders stored in Box Necessario 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 Necessario per copiare i file e anche 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 l'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 amministratore non ha accesso intrinseco a tutti i file di proprietà degli utenti. 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 del flusso di eventi aziendale per monitorare le modifiche per l'importazione.
Manage groups Obbligatorio per recuperare l'elenco dei gruppi e dei relativi membri. Questo è fondamentale per controllo dell'accesso durante l'importazione.

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

Limitazioni

Il datastore Box per Gemini Enterprise presenta le seguenti limitazioni:

  • Quando crei una nuova applicazione o aggiungi un datastore a uno esistente, ti consigliamo di aggiungere un solo datastore con azioni appartenenti a un unico tipo di connettore, indipendentemente dalla modalità di connessione. Ad esempio, non associare due datastore Box con azioni abilitate alla stessa applicazione.
  • 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 e EU.

  • Il datastore federato Box utilizza le API Box per la ricerca. Di conseguenza, la qualità della ricerca dipende dai risultati forniti dalla ricerca di 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 l'datastore di importazione.

Passaggi successivi