Nommer et gouverner ses capacités

Règles de nommage

• utilisez un verbe et un résultat : « Rechercher une commande » ;
• évitez les noms de fournisseurs ;
• séparez lecture et modification si leur risque diffère ;
• gardez une portée assez étroite pour être comprise sans explication.

Avant d’utiliser une capacité

1. vérifiez les connecteurs actifs ;
2. choisissez le fournisseur préféré en cas de conflit ;
3. contrôlez les modes dans Permissions ;
4. testez d’abord un parcours sans écriture ;
5. ajoutez ensuite la capacité à un workflow ou un agent.

Entretien

Réexaminez les capacités après le remplacement d’un connecteur, une modification de permissions ou une évolution du parcours métier. Supprimez les doublons et gardez des noms stables pour ne pas désorienter les équipes.

Exemple de catalogue clair

Préférez Rechercher une commande, Modifier une commande et Ajouter une note au ticket à Shopify, CRM ou Actions client. Le verbe indique ce que l’agent peut faire et la séparation rend visible la différence de risque.

Avant de publier une capacité, posez une question simple : « Si un collègue voit ce nom sans connaître le connecteur, comprend-il le résultat et l’impact ? » Si la réponse est non, resserrez le nom ou séparez les actions.