Aperçu

Le data store Box pour Gemini Enterprise vous permet de rechercher et d'effectuer des actions sur vos données et enregistrements Box.

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 le fichier Crée une copie d'un fichier dans un dossier de destination sans modifier le fichier d'origine.
Importer un fichier Importe un fichier dans un dossier spécifié dans Box.
Télécharger le fichier Télécharge un fichier depuis Box.

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 fédérée Read all files and folders stored in Box Obligatoire pour extraire les commentaires et les tâches, et pour prévisualiser les fichiers pour la recherche.
Recherche fédérée et actions Write all files and folders stored in Box Obligatoire pour copier, importer et télécharger des fichiers, ainsi que pour extraire les commentaires et les tâches, et pour 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 Obligatoire pour extraire la liste des utilisateurs, ce qui permet de récupérer les fichiers, les commentaires et les tâches à partir des comptes utilisateur individuels pour l'ingestion. Le compte de service administrateur ne dispose pas d'un accès inhérent à tous les fichiers appartenant à l'utilisateur. L'en-tête "as-user" permet au système d'effectuer des requêtes API en tant qu'utilisateur spécifique pour accéder à ses données.
Manage enterprise properties Nécessaire pour la fonctionnalité de synchronisation incrémentale, car elle facilite l'utilisation du flux d'événements Enterprise pour suivre les modifications en vue de l'ingestion.
Manage groups Obligatoire pour extraire la liste des groupes et de leurs membres. Ceci 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 que vous ajoutez un data store à une application existante, il est recommandé d'associer un seul data store à des actions appartenant à un seul type de connecteur.
  • L'application d'un périmètre VPC Service Controls aux datastores Box existants n'est pas acceptée. 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 obtenir une meilleure qualité de recherche dans ces scénarios, utilisez plutôt le data store d'ingestion.

Étape suivante