API WordPress des capacités : 47 actions de gros pour les agents IA

Imaginez une agence qui s'occupe d'une douzaine de boutiques de gros WooCommerce. Un client souhaite que son assistant IA approuve les devis. Un autre souhaite une liste hebdomadaire des meilleurs clients de gros sans que personne ne se connecte. Avant l'API des capacités de WordPress, chaque demande signifiait écrire et maintenir un point de terminaison personnalisé.

Les capacités changent cela. Les plugins peuvent désormais publier une liste nommée d'actions, chacune avec ses propres entrées et vérification de permissions, et les agents IA peuvent les trouver et les exécuter. La partie difficile pour un développeur est de savoir ce qu'une suite de plugins réelle expose, et comment la contrôler.

Ce guide couvre ce que Wholesale Suite enregistre comme capacités, qui peut exécuter chaque groupe, comment les appels sont enregistrés et comment tout désactiver. Il est basé sur la documentation et le code des plugins eux-mêmes.

Ce qu'est l'API des capacités de WordPress

L'API des capacités de WordPress (WordPress 6.9+) est un registre central où les plugins déclarent des actions nommées avec des entrées, des sorties et des vérifications de permissions définies. Les agents IA et les outils d'automatisation peuvent ensuite découvrir ces actions et les exécuter de manière cohérente et prévisible.

Selon la documentation de l'API des capacités de WordPress, chaque capacité a quelques parties principales :

• Un nom unique : Il suit un modèle namespace/nom-capacité, plus une étiquette et une description lisibles par l'homme.
• Schémas d’entrée et de sortie : JSON Schema décrit ce que l’outil attend et ce qu’il renvoie, afin qu’un agent sache comment l’appeler.
• Une catégorie : Les outils apparentés sont regroupés.
• Un rappel de permission : Cette vérification facultative détermine si l’utilisateur actuel peut exécuter l’outil.
• Un rappel d’exécution : C’est la fonction PHP qui effectue le travail.

Considérez cela comme un menu de restaurant. La cuisine prépare toujours les plats, mais les clients commandent à partir d’une liste fixe de plats avec des descriptions claires. L’API Abilities donne à chaque plugin le même format de menu, afin que tout agent puisse le lire. L’enregistrement est couvert dans la documentation officielle. Pour une agence, la question utile est ce qu’une suite de plugins de production met sur ce menu.

Comment les outils parviennent à un agent IA ou à une automatisation

Les outils résident dans WordPress, donc un assistant IA a besoin d’un pont pour y accéder. Ce pont est MCP (Model Context Protocol). Selon le manuel de l’adaptateur MCP de WordPress, l’adaptateur MCP traduit les outils WordPress en outils MCP, afin que les assistants comme Claude et ChatGPT puissent les découvrir et les invoquer.

WooCommerce utilise la même couche. Selon la documentation du développeur MCP de WooCommerce, WooCommerce enregistre ses propres outils de produits et de commandes sur l’API Abilities et l’adaptateur MCP. Cette fonctionnalité est encore en aperçu développeur.

Un magasin Wholesale Suite a deux voies d’accès à un agent :

• StoreAgent : L’onglet IA / MCP dans Wholesale Suite connecte StoreAgent pour vous. Son commutateur Activer l’accès en écriture MCP contrôle les outils d’écriture, mais uniquement pour les connexions StoreAgent.
• Un plugin adaptateur MCP : Si vous utilisez un adaptateur à la place, l’adaptateur décide de ce que l’assistant peut faire. Le commutateur StoreAgent n’a aucun effet là-bas.

Dans tous les cas, chaque appel s’exécute en tant qu’utilisateur WordPress authentifié, de sorte que l’agent n’obtient jamais plus d’accès que ce que ce compte possède. Pour une vue d’ensemble de l’intégration, consultez notre guide sur l’intégration système IA pour Wholesale Suite.

Quelles actions de gros Wholesale Suite expose

Wholesale Suite enregistre 47 outils dans quatre plugins. Parmi ceux-ci, 17 sont en lecture seule et 30 apportent des modifications. Vous avez besoin de WordPress 6.9 ou plus récent, ou de WooCommerce 10.9 ou plus récent, car l’un ou l’autre fournit l’API Abilities.

WooCommerce Wholesale Prices 2.3.0 est le commutateur qui active cela. Il ajoute la prise en charge de l’API Abilities et active les outils pour chaque plugin Wholesale Suite. Les quatre plugins se décomposent comme suit :

Plugin (version minimale)	Outils	Exemples en lecture seule	Exemples en écriture	Qui peut exécuter les écritures
WooCommerce Wholesale Prices (2.3.0, gratuit)	3	Obtenir le prix de gros, Lister les clients de gros	Définir le prix de gros	Gestionnaire de boutique ou Administrateur
WooCommerce Wholesale Prices Premium (2.1.3)	15	Lister les rôles de gros, Obtenir un aperçu des prix, Obtenir le prix effectif	Définir la règle de commande minimum, Définir la règle de remise sur quantité, Créer un rôle de gros	Administrateur uniquement (les 12 écritures)
WooCommerce Wholesale Order Form (3.1.2)	8	Lister les formulaires de commande, Obtenir les analyses des formulaires de commande	Dupliquer le formulaire de commande, Supprimer le formulaire de commande	Gestionnaire de boutique ou Administrateur
WooCommerce Wholesale Quotes (1.0.3)	21	Lister les devis, Obtenir les statistiques des devis	Approuver le devis, Convertir le devis en commande, Mettre à jour en masse le statut du devis	Gestionnaire de boutique ou Administrateur (paramètres : Administrateur uniquement)
Total	47	17 lecture seule	30 apporter des modifications

Wholesale Lead Capture et Wholesale Payments n’enregistrent encore aucune capacité. Pour chaque capacité avec sa description et sa permission, consultez la liste complète des capacités d’IA de Wholesale Suite.

WooCommerce Wholesale Prices (3)

Le plugin gratuit couvre les bases. Un agent peut obtenir ou définir un prix de gros sur un produit ou une variation, et lister les clients de gros avec la date de leur dernière commande et leur dépense totale.

WooCommerce Wholesale Prices Premium (15)

Premium ajoute les règles de tarification. Trois capacités de lecture listent les rôles, comptent les règles de tarification par niveau et calculent le prix effectif qu’un client paie. Ses 12 capacités d’écriture couvrent les remises globales, par catégorie et par quantité, les remises sur le sous-total du panier, les commandes minimales, les remises sur les frais d’expédition, de paiement et d’exonération de taxe, la création de rôles, l’attribution de rôles, la visibilité des produits et les prix par rôle.

WooCommerce Wholesale Order Form (8)

Quatre capacités de lecture listent les formulaires, montrent la configuration d’un formulaire, retournent les analyses combinées et vous donnent le shortcode d’intégration. Les quatre autres créent, dupliquent, mettent à jour ou suppriment des formulaires de commande.

WooCommerce Wholesale Quotes (21)

Quotes a le plus grand ensemble. Les agents peuvent lire les devis, les messages, l’historique, les liens publics, les statistiques, les limites de taux et les paramètres. Sur le côté droit, ils peuvent modifier les articles, approuver, refuser, annuler, convertir les devis en commandes, mettre à jour en masse jusqu’à 50 devis, envoyer des messages et supprimer des devis.

Le modèle de permissions

Chaque appel de capacité s’exécute en tant qu’utilisateur WordPress qui a authentifié la connexion. Le compte avec lequel vous vous connectez décide donc de ce que l’agent peut manipuler.

Wholesale Suite divise l’accès en deux niveaux :

• Gestionnaires de boutique et Administrateurs : Tous deux peuvent utiliser chaque capacité de lecture, la capacité gratuite Définir le prix de gros, toutes les capacités de formulaire de commande et la plupart des capacités de devis.
• Administrateurs uniquement : Les 12 capacités d’écriture Premium et les deux capacités de paramètres de devis. Ils modifient les règles, les paramètres et les rôles des utilisateurs à l’échelle du magasin, de sorte qu’une connexion de gestionnaire de boutique peut lire les prix Premium mais ne peut pas les modifier.

Certaines capacités de lecture fonctionnent également pour les clients. Un client de gros peut lire le prix de son propre rôle. Tout client connecté peut utiliser cinq capacités de lecture de devis sur ses propres devis uniquement : Lister les devis, Obtenir le devis, Lister les messages de devis, Lister l’historique des devis et Obtenir le lien public du devis.

Les capacités qui écrasent ou suppriment des données sont marquées comme destructrices. Cela indique à l’assistant de demander avant de les exécuter, mais l’assistant décide comment il demande. Les capacités d’écriture modifient les données en direct, et certaines, comme Supprimer le devis et Supprimer le formulaire de commande, ne peuvent pas être annulées.

Notre conseil pour les sites clients : connectez-vous en tant que rôle ayant le moins de privilèges possible pour accomplir la tâche. Un agent de reporting n’a besoin que du rôle de gestionnaire de boutique. Si vous avez besoin d’un rappel sur la façon dont les rôles s’empilent, lisez comment les rôles de clients WooCommerce fonctionnent pour le commerce de gros.

Journal de journalisation et interrupteurs d'arrêt

Wholesale Suite vous offre deux outils de gouvernance : un journal de chaque appel de capacité, et des interrupteurs qui désactivent les capacités. Les deux sont conçus pour les développeurs qui gèrent les sites clients.

Le journal d'audit des capacités

Sur WordPress 7.1 ou plus récent, Wholesale Suite enregistre chaque appel de capacité. Vous trouverez les entrées sous WooCommerce > Statut > Journaux en choisissant la source wwp-abilities-audit. Cela vous donne un enregistrement à vérifier lorsqu'un client demande ce qu'un agent a modifié. Les appels réussis sont enregistrés au niveau Info et les appels échoués au niveau Erreur, donc si vos paramètres de journalisation WooCommerce ne conservent que les avertissements et les erreurs, les appels réussis n'apparaîtront pas.

Pour que les capacités continuent de fonctionner mais pour arrêter le journal, définissez la constante WWP_DISABLE_ABILITIES_AUDIT ou utilisez le filtre wwp_disable_abilities_audit.

Désactiver les capacités

Chaque plugin a son propre interrupteur. Ajoutez la constante à wp-config.php, ou utilisez le filtre correspondant dans le code. Vous n'avez besoin que de l'un des deux.

// All Wholesale Suite plugins (set in wp-config.php)
define( 'WWP_DISABLE_ABILITIES', true );
// Premium abilities only
define( 'WWPP_DISABLE_ABILITIES', true );
// Order Form abilities only
define( 'WWOF_DISABLE_ABILITIES', true );
// Quotes abilities only
define( 'WWQ_DISABLE_ABILITIES', true );
// Filter version of the suite-wide switch
add_filter( 'wwp_disable_abilities', '__return_true' );

L'interrupteur WooCommerce Wholesale Prices est à l'échelle de la suite. Il désactive les capacités de chaque plugin Wholesale Suite, pas seulement les siennes. Les trois autres filtres suivent le même schéma : wwpp_disable_abilities, wwof_disable_abilities et wwq_disable_abilities.

Ce que nous avons vu : le détail qui vaut la peine d'être construit est l'attribution d'un rôle de grossiste à un utilisateur. Il remplace tous les rôles qu'un utilisateur détient, y compris Shop Manager ou Editor, bien qu'il ne touche pas à votre dernier Administrateur. Toute automatisation qui déplace les clients entre les niveaux doit d'abord vérifier leurs rôles actuels. La mise à jour du devis fonctionne de la même manière avec les articles, car la liste que vous envoyez remplace la liste entière des articles.

Cas d'utilisation d'automatisation pour les agences

Les capacités sont plus utiles lorsque vous associez une demande client à une courte chaîne d'actions nommées. Voici quatre scénarios que vous pourriez construire :

• Résumé hebdomadaire (lecture seule) : Imaginez un client qui souhaite un résumé le lundi. Un agent peut exécuter la liste des clients grossistes, triée par dépenses à vie, puis obtenir les statistiques des devis de la semaine passée. Rien ne change, donc une connexion Shop Manager est suffisante.
• Tri des devis : Un agent liste les devis par statut, marque ceux qui nécessitent une intervention humaine, puis utilise la mise à jour en masse du statut des devis sur un maximum de 50 à la fois. Approuver et Refuser envoient les e-mails habituels au client. Annuler n'envoie aucun.
• Audit des prix avant le lancement : Avant qu'une modification de prix ne soit effective, exécutez Obtenir un aperçu des prix et Obtenir le prix effectif pour quelques clients tests. Gardez à l'esprit qu'Obtenir le prix effectif exclut les remises sur quantité du panier, les remises sur le sous-total du panier et les prix de vente programmés.
• Entretien du formulaire de commande : Utilisez Dupliquer le formulaire de commande pour copier un formulaire en brouillon avant de le modifier, afin que le formulaire en direct reste intact.

Tous les travaux ne nécessitent pas un agent. Pour les changements de niveau basés sur des règles, tels que faire passer un client à un niveau supérieur après qu'il ait dépensé un montant défini, l'automatisation des rôles de grossiste est intégrée et ne nécessite aucune connexion IA.

API des capacités par rapport à l'API REST Wholesale Suite

Utilisez l'API REST pour la synchronisation système à système, et utilisez les capacités lorsqu'un agent ou un outil d'automatisation doit découvrir des actions avec des vérifications d'autorisation intégrées.

L'API REST Wholesale Suite REST API utilise les espaces de noms wholesale/v1 et wwlc/v1. Elle offre des points de terminaison de lot, ainsi que des points de terminaison de remise Premium et d'analyse. Cela en fait un bon choix pour une synchronisation ERP ou une mise à jour de catalogue en masse, où votre propre code sait quel point de terminaison appeler.

Les capacités conviennent à un travail différent. Chacune se décrit elle-même, vérifie les autorisations de l'appelant et est enregistrée sur WordPress 7.1+. Un agent peut déterminer ce qui est disponible par lui-même, sans que vous ayez à écrire un point de terminaison personnalisé pour chaque client.

Une création d'agence peut utiliser les deux : REST pour la synchronisation planifiée, capacités pour les requêtes ad hoc via un assistant.

Créez des boutiques de gros prêtes pour les agents avec l'API WordPress Abilities

L'API WordPress Abilities offre aux agences quelque chose qu'elles n'avaient pas auparavant : une couche d'action documentée et vérifiée par autorisation que chaque boutique client partage. Au lieu de maintenir des points de terminaison uniques par client, vous obtenez une liste connue d'actions de gros, un journal de ce qui a été exécuté et un interrupteur pour tout désactiver.

Vos prochaines étapes :

• Découvrez ce qu'est l'API Abilities afin de pouvoir l'expliquer aux clients.
• Choisissez vos capacités de gros par plugin.
• Connectez-vous avec le rôle le moins privilégié qui couvre chaque tâche.
• Configurez le journal d'audit et les interrupteurs d'arrêt avant de remettre un site.
• Choisissez entre les capacités et REST pour chaque intégration.

Prêt à créer des boutiques de gros prêtes pour les agents avec l'API WordPress Abilities ? Le bundle Wholesale Suite inclut les plugins premium derrière les quatre ensembles de capacités et couvre des sites illimités, ce qui convient aux agences gérant plusieurs boutiques clientes.

Questions fréquemment posées sur l'API WordPress Abilities