Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Intégration à Box Agent
Avec le connecteur Box Agent, vous pouvez accéder aux fonctionnalités de Box AI, gérer des fichiers et des dossiers, et organiser le contenu dans des hubs directement dans Amazon Quick via le langage naturel.
Amazon Quick prend en charge les méthodes d'authentification suivantes pour Box Agent.
-
Application OAuth par défaut — Utilise une application OAuth AWS gérée. Aucune information d'identification supplémentaire n'est requise. Vous vous authentifiez directement avec votre compte Box.
-
Application OAuth personnalisée : utilise une application OAuth 2.0 gérée par le client enregistrée dans la Box Developer Console. Cette option donne à votre organisation le contrôle total de la configuration OAuth.
Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultezMéthodes d’authentification.
Avant de commencer
Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.
-
Un compte Box avec accès aux fichiers et aux dossiers.
-
Pour l'application OAuth personnalisée : accès à la console Box Developer pour créer une application personnalisée. Pour plus d'informations, consultez la section Configuration d'OAuth 2.0
dans la documentation Box. -
Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultezConfiguration des intégrations dans la console.
Configuration du connecteur dans Amazon Quick
Se connecter depuis l'onglet Disponible
Si vous souhaitez utiliser l'authentification par défaut de l'application OAuth, vous pouvez vous connecter directement depuis l'onglet Disponible sans configuration supplémentaire.
-
Dans la console Amazon Quick, choisissez Connectors.
-
Dans l'onglet Disponible, recherchez Box Agent et choisissez Connect.
-
Complétez le flux de connexion à Box et accordez les autorisations demandées.
Pour configurer un connecteur avec l'application OAuth personnalisée à la place, utilisez l'onglet Créer pour votre équipe, comme décrit ci-dessous.
Créez à partir de l'onglet Créer pour votre équipe
Si vous utilisez l'authentification personnalisée de l'application OAuth, créez-en une dans la Box Developer Console avant de configurer Amazon Quick. Pour les instructions de configuration, consultez la section Configuration d'OAuth 2.0
-
Dans la console Amazon Quick, choisissez Connectors.
-
Choisissez l'onglet Créer pour votre équipe.
-
Recherchez et choisissez Box Agent.
Note
Si un connecteur Box Agent existe déjà, une boîte de dialogue contenant vos connecteurs existants s'affiche. Pour utiliser un connecteur existant, choisissez-le. Pour en créer un nouveau, choisissez Non, créer un nouveau.
-
Entrez un nom pour votre connecteur. Choisissez éventuellement + Ajouter une description pour ajouter une description.
-
Pour Type de connexion, sélectionnez Réseau public.
-
Pour la configuration OAuth, choisissez l'une des options suivantes :
-
Pour l'application OAuth par défaut :
Aucune information d'identification supplémentaire n'est requise. Choisissez Next (Suivant) pour continuer.
-
Pour l'application OAuth personnalisée, configurez les champs suivants :
-
URL de base (facultatif) — URL de base de l'API Box. Exemple :
https://mcp.box.com -
ID client : ID client de votre application Box.
-
Secret client : secret client de votre application Box.
-
-
-
Choisissez Suivant.
-
Une fenêtre d'autorisation Box s'ouvre. Vérifiez les autorisations demandées et choisissez Accorder l'accès à Box.
-
Sur la page Révision, passez en revue les actions disponibles pour le connecteur. Choisissez Suivant.
-
Sur la page Publier, choisissez qui peut accéder au connecteur. Vous pouvez autoriser l'accès à tous les membres de votre organisation ou rechercher des équipes ou des groupes spécifiques.
-
Choisissez Publier.
Actions disponibles
Après avoir configuré le connecteur, les actions suivantes sont disponibles.
| Catégorie | Action | Description |
|---|---|---|
| AI | Questions et réponses sur l'IA (Hub) | Posez une question à un Box Hub à l'aide de Box AI. |
| AI | Questions et réponses sur l'IA (fichier unique) | Posez une question à un seul fichier à l'aide de Box AI. |
| AI | AI Q&A (plusieurs fichiers) | Posez une question à plusieurs fichiers à l'aide de Box AI. |
| AI | Extrait AI (Freeform) | Extrayez les métadonnées des fichiers à l'aide de Box AI au format libre. |
| AI | Extrait AI (structuré) | Extrayez les métadonnées structurées des fichiers à l'aide de Box AI sur la base de champs personnalisés ou d'un modèle de métadonnées. |
| Fichiers | Obtenir le contenu du fichier | Extrayez et renvoyez le contenu du fichier au format texte pour les fichiers de moins de 50 Mo. |
| Fichiers | Obtenir les détails du fichier | Obtenez des informations complètes sur les fichiers, notamment les métadonnées, les autorisations et les détails de version. |
| Fichiers | Mettre à jour les propriétés du fichier | Mettez à jour les métadonnées des fichiers, notamment le nom, la description, les balises et les collections. |
| Fichiers | Charger un fichier | Importez un nouveau fichier dans Box. |
| Fichiers | Version du fichier de téléchargement | Téléchargez une nouvelle version d'un fichier existant. |
| Fichiers | Rechercher des fichiers | Recherchez des fichiers à l'aide de mots clés avec prise en charge des filtres de métadonnées et du filtrage des extensions de fichiers. |
| Dossiers | Create Folder | Créez un nouveau dossier dans Box. |
| Dossiers | Obtenir les détails du dossier | Récupérez des informations complètes sur les dossiers, y compris les métadonnées et les paramètres de collaboration. |
| Dossiers | Contenu du dossier de liste | Répertoriez les fichiers, les dossiers et les liens Web dans un dossier. |
| Dossiers | Mettre à jour les propriétés du dossier | Mettez à jour les métadonnées du dossier, notamment le nom, la description, les balises et les collections. |
| Dossiers | Dossiers de recherche | Recherchez des dossiers par nom à l'aide de la correspondance de mots clés. |
| Hubs | Créer un hub | Créez un nouveau hub pour organiser le contenu. |
| Hubs | Obtenir les détails du hub | Récupérez des informations sur un hub spécifique. |
| Hubs | Obtenir des articles du Hub | Récupérez des éléments dans un hub, notamment des fichiers, des dossiers et des liens Web. |
| Hubs | Liste des hubs | Répertoriez tous les hubs accessibles à l'utilisateur actuel. |
| Hubs | Hub de mise à jour | Mettez à jour le titre ou la description d'un hub. |
| Hubs | Ajouter des articles au Hub | Ajoutez des fichiers, des dossiers ou des liens Web à un hub. |
| Commentaires et tâches | Créer un commentaire sur le fichier | Créez un nouveau commentaire sur un fichier. |
| Commentaires et tâches | Liste des commentaires sur les fichiers | Répertoriez tous les commentaires d'un fichier. |
| Commentaires et tâches | Lister les tâches | Répertoriez toutes les tâches associées à un fichier. |
| Utilisateurs | Qui suis-je | Renvoie des informations sur l'utilisateur actuellement authentifié. |
Gestion et résolution des problèmes
Pour obtenir des instructions sur la modification, le partage ou la suppression de votre connecteur, consultezGestion des intégrations existantes.
-
Échec de la fenêtre contextuelle d'authentification : vérifiez que votre navigateur autorise les fenêtres contextuelles provenant du domaine de la console Amazon Quick.
-
Informations d'identification client non valides (application OAuth personnalisée) : vérifiez que l'ID client et le secret du client correspondent aux valeurs de votre application Box Developer Console.
-
Autorisations insuffisantes : vérifiez que votre compte Box a accès aux fichiers, dossiers ou hubs auxquels vous essayez d'accéder.
