Qu'est-ce que l'API des capacités de WordPress ?

L'API WordPress Abilities est une manière standard pour les plugins d'indiquer aux outils d'IA ce qu'ils peuvent faire. Elle a été intégrée à WordPress 6.9. Je l'ai connectée à WP Mail SMTP et j'ai demandé à une IA de lire mes journaux d'e-mails. Elle a répondu en quelques secondes.

Jusqu'à présent, il n'existait aucun moyen partagé pour les outils externes de savoir ce que votre site pouvait faire. Chaque plugin parlait sa propre langue. Un agent IA devait deviner, ou vous deviez écrire du code personnalisé.

Dans ce guide, vous apprendrez ce que sont les capacités et comment elles s'appliquent aux outils d'IA. Vous verrez également exactement ce que WP Mail SMTP et WPForms permettent à l'IA de lire.

La majeure partie de ceci ne nécessite aucun code. Il y a aussi une section pour les développeurs vers la fin.

Qu'est-ce que l'API WordPress Abilities ?

L'API WordPress Abilities est un registre central où les plugins, thèmes et le cœur de WordPress déclarent ce qu'ils peuvent faire. Chaque fonctionnalité déclarée est appelée une « capacité ».

Une capacité est une unité de fonctionnalité claire. Pensez à « lire les 10 derniers e-mails » ou « obtenir les statistiques d'envoi du mois ». Chaque capacité a quatre parties :

• Entrée : les données dont elle a besoin pour s'exécuter
• Sortie : les données qu'elle renvoie
• Exécution : l'action qu'elle effectue
• Permission : la vérification pour savoir qui est autorisé à l'exécuter

Le registre est lisible par machine et par l'homme. Ainsi, un agent IA, un autre plugin ou un développeur peut le consulter et le comprendre. WordPress stocke chaque capacité en un seul endroit, appelé le WP_Abilities_Registry.

Comment fonctionne l'API Abilities ?

L'API Abilities fonctionne en conservant chaque capacité dans un seul registre que tout outil peut interroger. Un plugin enregistre ses capacités au démarrage de WordPress. Chacune porte ses propres règles.

Ces règles remplissent trois fonctions :

• Schéma JSON vérifie les types d'entrée et de sortie avant que quoi que ce soit ne s'exécute.
• Un rappel de permission confirme que l'utilisateur ou l'outil est autorisé à exécuter la capacité.
• Des indicateurs de métadonnées marquent une capacité comme lecture seule, destructive ou idempotente, afin que les outils connaissent les conséquences.

Il y a aussi un indicateur show_in_rest. Il permet à une capacité d'apparaître sur l'API REST de WordPress lorsqu'un développeur l'active. Cela maintient l'exposition délibérée, pas automatique.

Comment les capacités sont-elles connectées aux agents IA (l'adaptateur MCP) ?

Les capacités sont disponibles pour les agents IA via l'adaptateur WordPress MCP. MCP signifie Model Context Protocol. C'est le langage partagé que les outils d'IA utilisent pour communiquer avec les systèmes externes.

L'adaptateur MCP permet aux outils d'IA d'accéder à ces capacités. Il lit vos capacités enregistrées et les convertit en parties MCP :

• Outils : capacités qui exécutent une action
• Ressources : capacités qui renvoient des données à lire
• Invites : modèles prêts à l'emploi pour les tâches courantes

Il fonctionne sur HTTP pour les sites en direct, ou STDIO pour le développement local. La connexion utilise les mots de passe d'application WordPress. Une fois actif, les outils MCP comme Claude, ChatGPT, Cursor et VS Code peuvent découvrir et utiliser vos capacités.

Pourquoi l'API Abilities est-elle importante ?

L'API Abilities est importante car elle fournit à l'IA un moyen fiable d'accéder à votre site. Auparavant, il n'y avait pas de norme. Les outils devaient analyser les routes REST ou lire le code du plugin pour deviner ce qui était possible.

Maintenant, le résultat est simple :

• Un registre à découvrir : les outils trouvent toutes les capacités en un seul endroit.
• Lecture seule par défaut : la plupart des capacités ne font que lire des données, elles sont donc sûres à exposer.
• Pas de code personnalisé : vous évitez l'intégration sur mesure dont chaque plugin avait besoin auparavant.
• Sécurité cohérente : chaque capacité s'exécute dans le même modèle d'autorisations.

Pour les propriétaires de sites, cela signifie que vous pouvez poser de vraies questions à une IA sur votre site. Pour les développeurs, cela signifie que votre plugin bénéficie d'une assistance IA sans SDK séparé.

Réparez vos e-mails WordPress maintenant

Que peut faire WP Mail SMTP avec l'API Abilities ?

WP Mail SMTP utilise l'API Abilities pour permettre aux outils d'IA de lire vos données d'e-mail, en lecture seule. Un assistant connecté examine votre activité d'e-mail et répond aux questions. Il n'envoie jamais d'e-mails, ne supprime pas de données et ne modifie pas vos paramètres.

Voici ce qu'il expose :

• Parcourir et filtrer les e-mails enregistrés par statut, expéditeur, date et destinataire
• Extraire les détails complets d'un e-mail et son contenu lorsque vous avez besoin d'un examen plus approfondi
• Lire les statistiques d'envoi de vos rapports
• Vérifier les événements de débogage pour aider à résoudre un problème de livraison

Ces capacités lisent dans le journal des e-mails et les rapports, qui font partie de WP Mail SMTP Pro. Votre site nécessite WordPress 6.9 ou une version ultérieure et WP Mail SMTP 4.9 ou une version ultérieure.

Une fois connecté, vous pouvez poser des questions comme « Mes e-mails de réinitialisation de mot de passe ont-ils été envoyés aujourd'hui ? » Pour le voir en action, lisez notre guide sur la surveillance de vos e-mails WordPress avec l'IA.

Quelles capacités WPForms expose-t-il ?

WPForms expose des capacités de lecture et d'écriture pour vos entrées de formulaire. Un assistant IA peut créer des formulaires, lire les soumissions, les résumer et répondre aux questions à leur sujet.

Cela ouvre des questions rapides et utiles :

• « Combien d'entrées ont été reçues cette semaine ? »
• « Résumez les commentaires de mon formulaire d'enquête. »
• « Quel formulaire reçoit le plus de soumissions ? »

Les règles sont assez différentes pour WPForms. Vous pouvez éventuellement activer l'accès en écriture pour permettre à l'assistant de créer et de gérer des formulaires sur votre site. Il vous suffit de donner une invite pour le type de formulaire que vous souhaitez créer, et il le crée automatiquement pour vous.

Comment utiliser l'API Abilities avec WP Mail SMTP

Pour utiliser WP Mail SMTP avec des assistants IA, vous devrez d'abord mettre à jour le plugin vers la version 4.9 ou ultérieure. Ensuite, connectez un outil d'IA. Voici les étapes pour WP Mail SMTP :

1. Mettez à jour vers WordPress 6.9 ou une version ultérieure.
2. Mettez à jour vers WP Mail SMTP 4.9 ou une version ultérieure.
3. Allez dans WP Mail SMTP » Outils, puis ouvrez l'onglet IA MCP.
4. Installez et activez WPVibe, puis connectez votre assistant IA.

C'est la version courte. Pour le guide complet avec captures d'écran, suivez notre guide sur la connexion de votre WP Mail SMTP aux assistants IA.

Comment les développeurs enregistrent-ils une capacité ?

Les développeurs enregistrent une capacité avec la fonction wp_register_ability(). Vous l'appelez à l'intérieur d'une fonction accrochée à l'action wp_abilities_api_init. Voici un exemple simple :

add_action( 'wp_abilities_api_init', 'myplugin_register_abilities' );

function myplugin_register_abilities() {
    wp_register_ability(
        'myplugin/get-recent-orders',
        array(
            'label'               => __( 'Get recent orders', 'myplugin' ),
            'description'         => __( 'Returns the 10 most recent orders.', 'myplugin' ),
            'category'            => 'myplugin',
            'input_schema'        => array(
                'type'       => 'object',
                'properties' => array(
                    'limit' => array( 'type' => 'integer' ),
                ),
            ),
            'output_schema'       => array( 'type' => 'array' ),
            'execute_callback'    => 'myplugin_get_recent_orders',
            'permission_callback' => function () {
                return current_user_can( 'manage_options' );
            },
        )
    );
}

À quoi ressemble wp_register_ability() ?

La fonction prend deux éléments : un nom unique et un tableau de paramètres. Le nom utilise un format vendor/ability, comme myplugin/get-recent-orders. Le tableau de paramètres définit le reste :

• label et description : noms lisibles par l'homme pour la capacité
• category : un groupe auquel appartient la capacité
• input_schema et output_schema : Schéma JSON pour les données entrantes et sortantes
• execute_callback : la fonction qui exécute le travail
• permission_callback : la fonction qui accorde ou refuse l'accès

Comment les rappels de permission sécurisent-ils les capacités ?

Les rappels de permission décident qui peut exécuter une capacité. Le vôtre doit renvoyer une vérification current_user_can(), afin que seuls les bons utilisateurs puissent y accéder. L'exemple ci-dessus limite la capacité aux administrateurs.

Trois couches supplémentaires la renforcent. Le schéma JSON rejette les entrées de type incorrect. Les indicateurs de métadonnées avertissent les outils lorsqu'une capacité modifie des données. Et show_in_rest maintient l'exposition REST en option plutôt qu'automatique.

Ensuite, connectez votre site à ChatGPT

Vous savez maintenant ce qu'est l'API des capacités WordPress, comment elle atteint les outils IA et ce que vos plugins exposent via celle-ci.

La prochaine étape consiste à en utiliser une. Mon guide sur la connexion de votre site WordPress à ChatGPT vous guide, sans code requis. Une fois que vous avez mis à jour vers la dernière version de WP Mail SMTP et connecté votre site à l'aide d'un connecteur comme WPVibe, vous pouvez interroger un assistant sur vos journaux d'e-mails en langage clair.

Réparez vos e-mails WordPress maintenant

Prêt à créer votre formulaire ? Commencez dès aujourd'hui avec le plugin de création de formulaires WordPress le plus simple.  WPForms Pro  comprend de nombreux modèles gratuits et offre une garantie de remboursement de 14 jours.

Si cet article vous a aidé, suivez-nous sur Facebook et Twitter pour plus de tutoriels et guides WordPress gratuits.