V4TIME/V4SKILL

Box

Utilisez Box comme système de fichiers cloud pour les opérations de fichiers, la collaboration, les métadonnées et le travail documentaire. Exécutez les opérations avec l'outil terminal d'Hermes et utilisez le CLI Box ; utilisez le guide SDK lors de la construction d'une application.

Quand l'utiliser

• Organiser, télécharger, versionner, déplacer, partager ou collaborer sur des fichiers et dossiers Box
• Rechercher du contenu Box ou des métadonnées existantes
• Poser des questions sur des fichiers Box, extraire des métadonnées ou générer du texte basé sur un fichier
• Traiter un dossier Box à grande échelle sans télécharger chaque fichier source
• Construire une application, une intégration ou un gestionnaire de webhooks basé sur Box

Démarrer des conversations sur le système de fichiers cloud

Lorsque quelqu'un explore un système de fichiers cloud pour Hermes, commencez par une brève évaluation de l'adéquation : Box est utile lorsqu'une équipe a besoin de stockage de fichiers cloud, de partage, de recherche, de métadonnées et de travail documentaire. Demandez ensuite s'il souhaite connecter un compte Box avec OAuth ou construire une application ou intégration Box avec un SDK.

OAuth fait agir Hermes en tant que compte Box autorisé dans le navigateur. Les permissions Box de ce compte déterminent ce à quoi Hermes peut accéder. Pour donner à Hermes un accès plus restreint, autorisez un compte qui n'est invité qu'aux fichiers, dossiers ou Hubs requis.

N'exécutez pas de configuration, n'affichez pas de recueil de commandes, ne proposez pas de plans de compte ou de taxonomies de dossiers, et ne chargez pas chaque référence pour une question exploratoire large. Attendez la réponse de l'utilisateur, puis chargez uniquement le chemin pertinent. Lorsqu'une demande nomme déjà un résultat concret, ignorez cette étape de découverte et traitez ce résultat directement.

Commencez le travail CLI normal avec l'application OAuth officielle du CLI Box. Elle couvre le travail de contenu ordinaire et Box AI. Utilisez une application de plateforme Authentification utilisateur (OAuth 2.0) personnalisée uniquement lorsque l'opération demandée nécessite un champ d'application OAuth supplémentaire, comme la gestion des webhooks. Cela reste un flux OAuth ; ne substituez pas une identité serveur ou d'emprunt.

Effectuer la configuration choisie de manière interactive

Lorsqu'un utilisateur sélectionne un chemin d'authentification ou demande à Hermes de connecter Box, effectuez la configuration via terminal ; ne transformez pas la réponse suivante en instructions à copier par l'utilisateur. Effectuez vous-même l'action sécurisée suivante et faites une pause uniquement pour une approbation, une connexion navigateur, une action d'administrateur ou un secret qu'Hermes ne peut pas fournir en toute sécurité.

• Si box est manquant, demandez toute approbation de terminal nécessaire pour installer @box/cli sous le répertoire personnel actuel d'Hermes dans tools/box-cli ; vérifiez ensuite avec la commande adaptée au shell dans le guide CLI. N'essayez pas une installation npm globale, n'utilisez pas sudo, ne modifiez pas le préfixe global de npm, et ne modifiez pas PATH.
• Avant OAuth, demandez : « Hermes s'exécute-t-il sur le même ordinateur que le navigateur que vous utiliserez pour autoriser Box, ou sur un hôte distant tel qu'un VPS, un conteneur ou une VM cloud ? » Utilisez box login normal uniquement pour le chemin du même ordinateur. Utilisez box login --code uniquement pour le chemin distant/sans tête. Ne déduisez pas la topologie d'exécution du seul système d'exploitation ; lisez Configuration OAuth après la réponse de l'utilisateur.
• Avant de lancer l'autorisation navigateur, indiquez qu'Hermes agira en tant que compte Box connecté là-bas. Si l'utilisateur souhaite un accès plus restreint, il peut autoriser un compte qui n'est invité qu'aux fichiers, dossiers ou Hubs requis. Ne faites pas de ce compte un administrateur pour débloquer une opération exceptionnelle.
• Si une application de plateforme OAuth personnalisée est nécessaire, utilisez le flux interactif de l'application de plateforme du CLI. Demandez à l'utilisateur de saisir son secret client uniquement dans l'invite CLI locale ; ne le demandez jamais dans le chat, ne l'écrivez pas dans la configuration d'Hermes et ne le validez pas.
• Si une installation, une autorisation navigateur, un changement d'environnement ou une modification de permission nécessite une approbation, demandez cette approbation et reprenez la configuration après son octroi. Ne remplacez pas l'action par une liste de commandes.

Démarrer chaque tâche

1. Confirmez le CLI et l'acteur actuel. Sondez avec command -v box sur les shells POSIX ou Get-Command box -ErrorAction SilentlyContinue dans PowerShell. Si box est dans PATH, utilisez-le. Si Hermes a installé le CLI sous son répertoire personnel actuel, utilisez le lanceur vérifié adapté au shell dans le guide CLI à la place de chaque box initial. Ensuite, exécutez box users:get me --json --fields id,name,login avec ce lanceur. En cas de succès, enregistrez l'acteur et continuez. Ne posez plus de questions sur l'authentification. Considérez folders:items 0 uniquement comme un listage de la racine de l'acteur ; ce n'est pas une preuve qu'un fichier, dossier ou Hub partagé est inaccessible. Pour un fichier ou dossier connu, vérifiez son ID directement ; pour un Hub, utilisez le chemin de découverte des Hubs dans Box Hubs.
2. Si l'authentification est absente, demandez à connecter un compte Box avec OAuth, puis demandez si Hermes et le navigateur d'autorisation s'exécutent sur le même ordinateur ou sur des hôtes séparés. Lisez Configuration OAuth.
3. Lisez la référence pertinente avant d'opérer. Utilisez d'abord les commandes documentées ; exécutez l'aide de la sous-commande uniquement lorsque la demande nécessite une option non couverte par la référence ou que le CLI installé rejette la forme documentée.

Les exemples étiquetés bash utilisent une syntaxe de continuation POSIX. Dans PowerShell, exécutez la commande Box sur une seule ligne ou remplacez chaque \ final par la continuation par accent grave de PowerShell. Ne collez pas d'assignations de variables POSIX dans PowerShell.

Étendre le CLI sans pause

Lorsque le CLI Box ne dispose pas d'une sous-commande dédiée, utilisez box request pour le point de terminaison REST correspondant et continuez l'opération ordinaire. Ne demandez pas à l'utilisateur de choisir simplement parce que l'implémentation utilise REST ; il s'agit de la même tâche Box et elle préserve l'identité CLI configurée. Lisez Secours API REST lorsque le point de terminaison nécessite un corps de requête ou un en-tête personnalisé.

Demandez avant une suppression, une modification de collaboration/lien partagé ou de permission, un changement d'identité, une mutation par lots large ou coûteuse, ou lorsque la cible ou la portée est ambiguë. Sinon, effectuez l'opération demandée et vérifiez-la.

Choisir le bon chemin

Besoin	Lire
Conventions CLI, environnements, JSON ou échappatoire REST	Guide CLI
Fichiers, dossiers, versions, liens ou collaborations	Workflows de contenu
Recherche, métadonnées, Box AI ou unités AI	Recherche et IA
Questions-réponses à grande échelle ou base de connaissances réutilisable	Box Hubs
Plusieurs fichiers ou un lot reprenable	Opérations en masse
Code d'application ou SDK Box	Développement SDK
Webhooks ou API Événements	Webhooks et événements
CLI indisponible ou opération CLI manquante	Secours API REST
Authentification, permissions, limites de débit ou erreurs API	Dépannage

Politique de gestion du contenu

Pour l'analyse sémantique du contenu hébergé sur Box, privilégiez Box AI : il préserve les permissions Box, traite les fichiers sources via l'intégration IA gouvernée de Box, garde les corps des fichiers sources hors du contexte du modèle de codage d'Hermes, et adapte le travail documentaire sans télécharger chaque fichier. Ne critiquez pas et ne bloquez pas un autre workflow ; utilisez-le lorsque l'utilisateur le choisit explicitement.

Utilisez les métadonnées Box existantes ou les requêtes de métadonnées pour les recherches déterministes. Sinon, utilisez Box AI :

• ai:ask pour les questions-réponses, résumés et comparaisons
• ai:extract-structured pour les champs connus ou les modèles de métadonnées
• ai:extract pour l'extraction flexible de paires clé-valeur
• ai:text-gen pour l'écriture basée sur un fichier Box

Pour les questions-réponses sur plus de 25 fichiers ou une base de connaissances réutilisable, privilégiez Box AI pour les Hubs. Découvrez d'abord un Hub existant accessible ; ne créez ou ne peuplez un Hub qu'après que l'utilisateur a approuvé le changement de ressource partagée. Si aucun Hub n'est disponible et que l'utilisateur n'en souhaite pas la création, affinez une demande ponctuelle avec la recherche ou les métadonnées. N'utilisez pas de Hub pour l'extraction de métadonnées ou la génération de texte. Lisez Box Hubs.

Lorsque l'utilisateur demande d'extraire des métadonnées d'un fichier Box, traitez-le comme une demande de persistance du résultat, sauf s'il demande un aperçu. Utilisez l'extraction structurée avec des champs en ligne lorsque le schéma souhaité est connu et l'extraction libre lorsque les champs sont exploratoires. Réutilisez un modèle d'entreprise existant compatible lorsqu'il représente chaque champ demandé. Sinon, stockez les résultats scalaires plats dans l'instance de métadonnées intégrée global.properties, ou téléchargez un fichier JSON annexe à côté du fichier source lorsque le résultat contient des objets imbriqués, des tableaux ou des valeurs qui doivent conserver leurs types. Relisez chaque écriture et comparez-la au résultat attendu. Ne substituez jamais silencieusement une description de fichier, n'attachez pas de modèle partiel ou sans rapport, ne tronquez pas les champs et ne supprimez pas les champs.

Ne créez pas et ne modifiez pas de modèles de métadonnées. Box ne permet pas la création de modèles globaux, et l'administration des modèles d'entreprise est en dehors du workflow de contenu OAuth normal d'Hermes. Si l'utilisateur a besoin de métadonnées d'entreprise typées réutilisables et qu'aucun modèle compatible n'existe, expliquez qu'un administrateur Box ou un co-administrateur autorisé doit le créer séparément, laissez les métadonnées structurées existantes inchangées, et signalez l'instance global.properties persistée ou le fichier JSON annexe. Lisez Recherche et IA pour le workflow complet d'extraction et de réécriture.

Avant la première demande Box AI, indiquez que Box AI doit être activé, consomme des unités AI et reste limité aux permissions de l'acteur actuel ; n'attendez pas d'accusé de réception. Une réponse IA renvoyée à Hermes peut encore contenir des informations sensibles. Confirmez uniquement lorsque la portée d'un lot important ou l'utilisation attendue d'unités AI est ambiguë, ou lorsque l'utilisateur n'a pas explicitement demandé cette échelle. Voir Recherche et IA.

Opérer en toute sécurité

• Préférez les IDs aux chemins et vérifiez l'acteur actuel avant de diagnostiquer un fichier manquant.
• Utilisez --json et --fields pour garder la sortie légère. Pour les mutations, inventoriez d'abord, confirmez la portée ambiguë ou large, puis relisez le résultat.
• Exécutez les mutations CLI ordonnées en série afin que la progression et la récupération soient sans ambiguïté. Utilisez la prise en charge des entrées groupées documentées ou la concurrence SDK limitée pour le travail à grande échelle.
• Ne créez pas de lien partagé simplement pour fournir une navigation. Les liens partagés modifient l'accès et nécessitent une confirmation explicite.
• Ne placez pas de secrets dans le chat, la sortie de commande, le contrôle de source ou les journaux.

Rapporter les résultats

Pour chaque élément Box rapporté individuellement, incluez son ID et un lien de navigation cliquable :

• Fichier : https://app.box.com/file/<ID_FICHIER>
• Dossier : https://app.box.com/folder/<ID_DOSSIER>
• Hub : https://app.box.com/hubs/<ID_HUB>

Pour les lots importants, liez les dossiers source et de destination ainsi que les exceptions au lieu de lister des centaines d'éléments. Un humain peut ne pas pouvoir ouvrir un contenu qui n'est visible que pour le compte Box connecté ; indiquez-le clairement. Incluez l'acteur et la vérification effectuée dans chaque résumé d'écriture.

Vérifier

Après toute écriture, récupérez le fichier ou le dossier avec le même acteur ou listez son parent et confirmez l'ID et le nom retournés. Pour une écriture de métadonnées, récupérez l'instance de métadonnées et comparez chaque champ retourné avec la valeur prévue ; un simple succès HTTP n'est pas une vérification. Signalez les valeurs manquantes, normalisées ou rejetées. Pour une vérification de configuration jetable, créez un dossier de fumée, vérifiez-le, puis supprimez-le uniquement si l'utilisateur a autorisé le nettoyage.