Guide des capacités de l'IA dans Easy Digital Downloads

Souhaitez-vous savoir exactement ce qu'un assistant IA peut faire avec votre boutique avant d'en connecter un ? Easy Digital Downloads décrit chaque opération de la boutique à votre assistant sous forme de capacité nommée, de sorte que tout ce qu'il peut atteindre est listé plutôt que deviné. Chaque capacité couvre un travail, comme la lecture d'un rapport de ventes ou la création d'un code de remise.

Ce guide vous présente chaque capacité que votre boutique peut exposer, et ce que chacune lit ou modifie.

Avant de commencer, assurez-vous qu'Easy Digital Downloads est installé et activé sur votre site WordPress, et que vous avez connecté votre magasin à un assistant IA.

Prérequis : Easy Digital Downloads 3.7.1 ou plus récent, fonctionnant sur WordPress 6.9 ou plus récent.

Comment fonctionnent les capacités de la boutique ?

Chaque capacité est enregistrée auprès de l'API des capacités WordPress sous un nom que votre assistant voit, tel que edd/sales-report. Votre assistant lit cette liste, choisit la capacité qui correspond à votre demande et l'exécute sur les propres données de votre boutique.

Les capacités se divisent en deux groupes, et la différence est plus importante que tout autre détail sur cette page. Les capacités de lecture recherchent des informations et ne modifient rien. Les capacités d'écriture créent ou modifient des enregistrements, et elles ne s'exécutent que lorsque Autoriser l'IA à modifier les données de la boutique est activé.

Votre assistant voit également une courte étiquette sur chacun. Les capacités de lecture sont marquées comme lecture seule, et la poignée de capacités d'écriture dont les résultats ne peuvent pas être annulés sont marquées comme destructrices, ce qui est le signal que les assistants utilisent pour vous demander avant de les exécuter.

Avec cette division à l'esprit, voici ce que chaque groupe couvre.

Recherche d'informations sur la boutique

Ceux-ci fonctionnent dès que votre boutique est connectée, et aucun d'entre eux ne touche à vos données.

Commandes

• Lire les commandes (edd/order-read) recherche une seule commande par ID, y compris ses articles, ou liste les commandes filtrées par statut, client, produit, adresse e-mail ou plage de dates. Les listes contiennent les ventes, sauf si vous demandez des remboursements à la place.
• Lire les notes de commande (edd/order-note-read) liste les notes enregistrées sur une commande, les plus récentes en premier.

Clients

• Lire les clients (edd/customer-read) recherche un client par ID ou adresse e-mail, ou recherche et liste les clients. Les adresses e-mail et les données d'adresse ne sont incluses que pour les comptes autorisés à consulter les données sensibles de la boutique.
• Lire les notes clients (edd/customer-note-read) liste les notes enregistrées sur un client, les plus récentes en premier.

Produits

• Lire les produits (edd/product-read) recherche un produit par ID, y compris sa tarification, ses fichiers et sa limite de téléchargement, ou liste les produits filtrés par terme de recherche, statut, catégorie ou étiquette.

Remises

• Lire les réductions (edd/discount-read) recherche une réduction par ID ou code, ou liste les réductions filtrées par statut, type ou terme de recherche. Les réductions archivées sont exclues, sauf si vous demandez un statut.

Rapports

• Rapport des ventes (edd/sales-report) renvoie des statistiques de ventes et de revenus pour une période prédéfinie ou une plage de dates personnalisée, et peut être limité à un seul produit.
• Résumé des ventes (edd/sales-summary) renvoie les revenus nets et les décomptes de ventes pour ce mois, le mois dernier, aujourd'hui et depuis toujours.

Configuration de la boutique

• Paramètres de la boutique (edd/settings) renvoie un résumé en lecture seule de votre configuration : devise, passerelles de paiement, taxes, pages clés et informations de version.
• Taux de taxes (edd/tax-rates) liste vos taux de taxes et si les taxes sont activées, et la liste peut être filtrée par pays.
• Bilan de santé de la boutique (edd/health-check) renvoie un instantané de l'état de la boutique : versions logicielles, mode de la boutique, décomptes de commandes et de clients, et passerelles de paiement activées.

Journaux

• Journaux de téléchargement de fichiers (edd/download-log) liste les enregistrements de téléchargement de fichiers, filtrés par produit, client, commande ou plage de dates.
• Journaux d'e-mails (edd/email-log) liste les e-mails envoyés par votre boutique, filtrés par destinataire, ID d'e-mail, objet lié ou plage de dates.

Ceux-ci couvrent toutes les questions auxquelles un assistant peut répondre sans rien changer. Le groupe suivant est celui que le commutateur d'écriture régit.

Modifications de votre boutique

Celles-ci restent indisponibles jusqu'à ce que Autoriser l'IA à modifier les données du magasin soit activé, et chacune respecte toujours ce que le compte connecté est autorisé à faire.

Commandes

• Créer une commande (edd/order-create) enregistre une commande manuelle pour un client, en utilisant un identifiant client existant ou une adresse e-mail. Les prix des articles proviennent des produits, et un code de réduction facultatif s'applique à l'ensemble de la commande. Aucun paiement n'est collecté, les taxes ne sont pas calculées et les restrictions de réduction au niveau du produit ne sont pas appliquées. Le reçu du client et la notification de nouvelle vente de votre magasin sont envoyés, sauf si la requête demande une commande silencieuse. Celle-ci est marquée comme destructive.
• Mettre à jour le statut de la commande (edd/order-update-status) modifie le statut d'une commande, en déclenchant les mêmes hooks que dans l'administration. La complétion d'une commande envoie un reçu au client par e-mail et lui accorde l'accès au téléchargement. Le retour d'une commande complétée la soustrait des revenus du magasin et des totaux clients. Celle-ci est marquée comme destructive.
• Renvoyer le reçu de commande (edd/order-resend-receipt) renvoie le reçu d'achat à l'adresse e-mail indiquée sur la commande.
• Ajouter une note de commande (edd/order-note-add) ajoute une note interne à une commande. Les notes ne sont jamais envoyées au client.

Remarque : Les remboursements ne font pas partie de cette liste. Ils restent sur l'écran de commande dans votre administration, de sorte qu'un assistant ne peut pas en émettre un.

Clients

• Créer un client (edd/customer-create) ajoute un enregistrement client à partir d'une adresse e-mail, avec un nom facultatif. Il s'arrête si un client existe déjà avec cette adresse.
• Mettre à jour un client (edd/customer-update) modifie le nom, l'adresse e-mail principale ou le statut d'un client existant.
• Ajouter une note client (edd/customer-note-add) ajoute une note interne à un enregistrement client.

Produits

• Créer un produit (edd/product-create) ajoute un produit avec un prix unique facultatif. Les nouveaux produits sont des brouillons, sauf si la requête demande leur publication, donc rien n'atteint votre vitrine tant que vous ne l'avez pas examiné.
• Mettre à jour un produit (edd/product-update) modifie uniquement les champs nommés dans la requête : titre, prix unique, statut ou description.

Remises

• Créer une réduction (edd/discount-create) crée un code de pourcentage ou un montant fixe, avec des dates de début et de fin, des limites d'utilisation, un montant de commande minimum, et des exigences ou exclusions de produits. Les nouveaux codes sont inactifs, sauf si la requête indique le contraire, vous avez donc une chance de les examiner avant que les clients ne puissent les utiliser.
• Mettre à jour une réduction (edd/discount-update) modifie uniquement les champs nommés dans la requête : nom, montant, statut, limite d'utilisation, dates, montant de commande minimum ou le paramètre une fois par client.
• Supprimer une réduction (edd/discount-delete) supprime une réduction qui n'a jamais été utilisée. Un code avec des utilisations enregistrées est plutôt archivé. Celle-ci est marquée comme destructive.

Chaque commande et modification de client enregistre également une note sur l'enregistrement lui-même, nommant la capacité et le compte qu'il a utilisé, ce que Ce qu'un assistant IA connecté peut voir et modifier couvre en détail.

Capacités dépendantes d'autres fonctionnalités

Votre boutique ne décrit que ce qu'elle peut réellement faire, donc ces trois apparaissent lorsque la fonctionnalité derrière elles est en cours d'exécution et restent masquées lorsqu'elle ne l'est pas.

• Obtenir le lien de facture (edd/invoice-link) renvoie l'URL de la facture pour une commande, prête à être partagée avec le client. Elle apparaît lorsque les Factures sont disponibles.
• Lire les paniers abandonnés (edd/abandoned-cart-read) liste les paniers qui ont été abandonnés, leurs totaux et le nombre d'articles qu'ils contenaient. Elle apparaît lorsque la Récupération de panier est activée.
• Lire les campagnes (edd/campaign-read) signale quelles campagnes génèrent des ventes. Elle apparaît lorsque le Suivi de campagne est activé.

Les trois lisent des informations plutôt que de les modifier. Elles apparaissent également sous forme de carte Croissance dans l'onglet IA, donc l'onglet est le moyen le plus rapide de savoir lesquelles de ces fonctionnalités votre propre boutique propose.

Les licences de logiciel et les paiements récurrents ajoutent leurs propres capacités de la même manière. Chacun obtient sa propre section ci-dessous.

Capacités de licences de logiciel

Si vous vendez des logiciels avec Licences de logiciel, votre assistant peut vous aider avec les questions de licence les plus fréquentes des clients. Il peut vérifier quand une clé expire et voir sur quels sites une clé est utilisée. Il peut également libérer une activation lorsqu'un client passe à un nouveau site.

Ces cinq capacités apparaissent lorsque Licences de logiciel 3.9.8 ou plus récent est actif.

Recherche de licences

• Lire les licences (edd/license-read) recherche une licence par ID ou clé de licence. Il liste également les licences filtrées par statut, client, produit, commande ou plage de dates d'expiration. Chaque résultat affiche le produit, la date d'expiration et le nombre d'activations en cours d'utilisation.
• Lire les activations de licence (edd/license-activation-read) indique sur combien de sites une licence est activée, quelle est sa limite et s'il reste des activations. La liste des sites n'est incluse que pour les comptes autorisés à consulter les données sensibles de la boutique. Cette liste indique également quels sites sont des installations de développement locales.

Les clés de licence fonctionnent comme des mots de passe, votre assistant ne voit donc que leurs quatre derniers caractères. La clé complète n'est affichée qu'aux comptes autorisés à consulter les données sensibles de la boutique.

Modification de licences

Ces trois ne s'exécutent que lorsque Autoriser l'IA à modifier les données du magasin est activé.

• Désactiver un site de licence (edd/license-site-deactivate) supprime un site d'une licence et libère une activation. C'est celle à utiliser lorsqu'un client a changé d'hébergement ou a cessé d'utiliser votre produit sur un site. Le client peut réactiver ce site avec sa clé. Celle-ci est marquée comme destructive.
• Mettre à jour la limite d'activation d'une licence (edd/license-activation-limit-update) modifie le nombre de sites sur lesquels une licence peut être activée, ou la réinitialise à la valeur par défaut du produit. Une limite de zéro signifie illimité.
• Mettre à jour le statut d'une licence (edd/license-status-update) active ou désactive une licence. La désactivation d'une licence empêche la clé de fonctionner sur tous les sites. L'activation d'une licence expirée la laisse expirée, le client doit donc toujours la renouveler.

Chaque modification de licence ajoute également une entrée au journal de cette licence, nommant la capacité et le compte qu'elle a utilisé.

Lorsque la gestion des licences logicielles est active, une carte Licences apparaît également dans l'onglet IA, listant ce que votre assistant peut faire avec les licences.

Les paiements récurrents ajoutent un ensemble similaire de capacités pour les abonnements.

Capacités de paiements récurrents

Si vous vendez des abonnements avec Paiements récurrents, votre assistant peut répondre aux questions de facturation sans que vous ayez à ouvrir chaque abonnement. Il peut trouver l'abonnement d'un client, vérifier quand il est renouvelé et voir ce qui a été facturé jusqu'à présent.

Ces quatre capacités apparaissent lorsque Paiements récurrents 2.14.0 ou une version plus récente est actif.

Recherche d'abonnements

• Lire les abonnements (edd/subscription-read) recherche un abonnement par ID. Il liste également les abonnements filtrés par statut, client, produit, option de prix, passerelle de paiement ou plage de dates d'expiration. Les adresses e-mail des clients et les identifiants des passerelles de paiement ne sont inclus que pour les comptes autorisés à visualiser les données sensibles de la boutique.
• Lire les renouvellements d'abonnement (edd/subscription-renewal-read) liste les paiements de renouvellement d'un abonnement et ce qui a été facturé à ce jour.
• Lire les notes d'abonnement (edd/subscription-note-read) liste les notes enregistrées sur un abonnement.

Modification d'abonnements

Comme les autres capacités d'écriture, celle-ci ne s'exécute que lorsque Autoriser l'IA à modifier les données de la boutique est activé.

• Ajouter une note d'abonnement (edd/subscription-note-add) ajoute une note interne à un abonnement.

Remarque : L'annulation d'un abonnement ou la modification de sa facturation reste sur l'écran de l'abonnement dans votre administration, où vous la gérez vous-même.

Lorsque Paiements récurrents est actif, une carte Abonnements apparaît également dans l'onglet IA, listant ce que votre assistant peut faire avec les abonnements.

Chaque capacité de cette page, y compris les capacités de fonctionnalités, dépend également du compte auquel votre assistant se connecte.

Comment les autorisations décident de ce qui s'exécute

L'activation de l'accès en écriture ne confère pas à un assistant plus de pouvoir que le compte auquel il s'est connecté. Chaque capacité vérifie ce compte par rapport à la même autorisation que celle utilisée par l'écran d'administration correspondant. Un assistant connecté en tant que comptable de boutique peut lire vos commandes et rapports de ventes. Il ne peut pas créer de code de réduction ni lire les paramètres de votre boutique, car ce rôle n'a pas ces autorisations.

L'autorisation dont chaque groupe a besoin s'aligne avec le tableau de bord d'une manière facile à prévoir :

• Les capacités de commande et de client nécessitent l'autorisation de modifier les paiements, ce que requièrent les écrans Commandes et Clients. La lecture des clients et des notes clients nécessite plutôt l'autorisation de visualiser les rapports.
• Les capacités de produit nécessitent l'autorisation de modifier les produits, et leur création nécessite l'autorisation de les publier.
• Les capacités de réduction nécessitent l'autorisation de gérer les réductions.
• Les capacités de rapport nécessitent l'autorisation de visualiser les rapports de la boutique.
• Les capacités de paramètres, de taux de taxe, de vérification de l'état et de journal nécessitent l'autorisation de gérer les paramètres de la boutique.
• Les capacités de licence nécessitent l'autorisation de visualiser les licences, et les trois modifications de licence nécessitent l'autorisation de gérer les licences. Celles-ci correspondent à ce que requiert l'écran des licences.
• Les capacités d'abonnement nécessitent une autorisation pour afficher les abonnements, ce qui inclut également l'ajout d'une note d'abonnement.

Choisir le compte que vous connectez est donc le principal moyen de limiter ce à quoi un assistant peut accéder. Cela s'applique aux lectures comme aux modifications.

Si vous souhaitez qu'un assistant accède à tout sur cette page, connectez un compte avec le rôle de gestionnaire de boutique, qui détient toutes les autorisations ci-dessus. Pour une connexion plus ciblée, le rôle de comptable de boutique couvre les commandes, les clients et les rapports de ventes tout en laissant les remises, les paramètres de la boutique et les journaux hors de portée. Il retient également les adresses e-mail et postales des clients, car ce rôle ne peut pas consulter les données sensibles de la boutique.

La même répartition s'applique aux capacités des fonctionnalités. Un comptable de boutique peut lire les abonnements, mais il ne peut pas voir ni modifier les licences. Les gestionnaires de boutique et les employés de boutique peuvent faire les deux.

Consultez le Guide du débutant sur les rôles et permissions d'utilisateurs WordPress pour savoir comment définir ce qu'un compte est autorisé à faire. pour limiter ce à quoi un assistant peut accéder, et cela s'applique aux lectures comme aux modifications.

Vérification de ce que votre propre boutique expose

Plutôt que de travailler à partir de cette page, vous pouvez lire la liste en direct sur votre propre boutique. Depuis la barre latérale d'administration de WordPress, allez dans Téléchargements » Outils, puis sélectionnez l'onglet IA.

L'onglet IA s'ouvre sur un panneau qui répertorie les assistants pris en charge par votre boutique.

WPVibe, le plugin connecteur gratuit, s'installe depuis ce même panneau à côté du commutateur d'autorisation d'écriture, et Connecter votre boutique à un assistant IA couvre les deux.

Plus bas sur cet onglet, les cartes regroupent tout ce que votre boutique décrit actuellement.

La phrase à côté de l'en-tête le compte pour vous. Elle donne le nombre d'éléments qu'un assistant peut rechercher et le nombre de modifications qu'il peut apporter une fois que vous les autorisez.

Étant donné que ces décomptes sont générés à partir de ce qui est enregistré, ils constituent la réponse fiable pour votre boutique, et ils évoluent d'eux-mêmes à mesure que vous activez ou désactivez des fonctionnalités.

C'est tout ! Vous savez ce que fait chaque capacité, lesquelles modifient les données et comment lire la liste en direct pour votre propre boutique. Ensuite, consultez Ce qu'un assistant IA connecté peut voir et modifier pour les données derrière ces capacités, ou Dépannage de la connexion IA de votre boutique si une capacité est manquante dans la liste de votre assistant.

Questions fréquemment posées

Ci-dessous, nous avons répondu à certaines des questions les plus courantes sur les capacités de la boutique.