Aperçu

Le data store Box pour Gemini Enterprise vous permet d'accéder à vos données Box et d'interagir avec les enregistrements.

Versions Box compatibles

Le data store Box est compatible avec la version 2024.0 de l'API Box.

Action compatible

Lorsque le data store Box est activé, les utilisateurs finaux peuvent utiliser des commandes en langage naturel dans Gemini Enterprise pour effectuer l'action suivante.

Action Description
Copier un fichier Crée une copie d'un fichier dans un dossier de destination, sans modifier le fichier d'origine.

Niveaux d'accès requis

Pour permettre à Gemini Enterprise d'effectuer des recherches, des actions et l'ingestion de données à l'aide du data store Box, vous avez besoin des niveaux d'accès suivants :

Mode de connexion Scope (Portée) Purpose
Recherche unifiée Read all files and folders stored in Box Nécessaire pour récupérer les commentaires et les tâches, et pour prévisualiser les fichiers pour la recherche.
Recherche et actions fédérées Write all files and folders stored in Box Nécessaire pour copier les fichiers, récupérer les commentaires et les tâches, et prévisualiser les fichiers pour la recherche.
Ingestion de données Read all files and folders stored in Box Obligatoire pour l'ingestion de données.
Manage users Nécessaire pour récupérer la liste des utilisateurs, ce qui permet de récupérer les fichiers, les commentaires et les tâches des comptes utilisateur individuels pour l'ingestion. Le compte de service administrateur n'a pas accès à tous les fichiers appartenant aux utilisateurs. L'en-tête "as-user" permet au système d'envoyer des requêtes d'API en tant qu'utilisateur spécifique pour accéder à ses données.
Manage enterprise properties Nécessaire pour la fonctionnalité de synchronisation incrémentielle, car elle facilite l'utilisation du flux d'événements Enterprise pour suivre les modifications à ingérer.
Manage groups Obligatoire pour récupérer la liste des groupes et de leurs membres. C'est essentiel pour le contrôle des accès lors de l'ingestion.

Pour savoir comment ajouter ces autorisations pour Box, consultez Configurer Box et définir les autorisations nécessaires.

Limites

Le data store Box pour Gemini Enterprise présente les limites suivantes :

  • Lorsque vous créez une application ou ajoutez un data store à une application existante, nous vous recommandons d'ajouter un seul data store avec des actions appartenant à un seul type de connecteur, quel que soit le mode de connexion. Par exemple, n'associez pas deux data stores Box avec des actions activées à la même application.
  • L'application d'un périmètre VPC Service Controls aux data stores Box existants n'est pas prise en charge. Pour appliquer VPC Service Controls, vous devez supprimer et recréer les datastores. Pour en savoir plus sur VPC Service Controls et sur l'utilisation des actions après l'activation de VPC Service Controls, consultez Sécuriser votre application avec VPC Service Controls.
  • Le data store Box n'est compatible qu'avec les emplacements Global, US et EU.

  • Le data store fédéré Box utilise les API Box pour la recherche. Par conséquent, la qualité de la recherche dépend des résultats fournis par la recherche Box. Cela peut entraîner des limites dans la qualité de la recherche pour les langues autres que l'anglais, car les API Box ne sont peut-être pas entièrement optimisées pour ces langues. Pour améliorer la qualité de la recherche dans ces scénarios, utilisez plutôt le data store d'ingestion.

Étapes suivantes