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 commande unique 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 par 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 client (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 ses prix, fichiers et limite de téléchargement, ou liste les produits filtrés par terme de recherche, statut, catégorie ou étiquette.

Remises

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

Rapports

• Rapport des ventes (edd/sales-report) renvoie les statistiques de ventes et de revenus pour une période prédéfinie ou une plage de dates personnalisée, et il peut être limité à un seul produit.
• Résumé des ventes (edd/sales-summary) renvoie les revenus nets et le nombre 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, nombre 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 comme une carte Croissance sur l'onglet IA, donc l'onglet est le moyen le plus rapide de savoir lesquelles de ces fonctionnalités votre propre boutique propose.

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 est connecté. Chaque capacité vérifie ce compte par rapport à la même autorisation que celle utilisée par l'écran d'administration correspondant, de sorte qu'un assistant connecté en tant que comptable de la boutique peut lire des rapports et ne peut toujours pas toucher à un produit.

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 les écrans Commandes et Clients exigent. 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 la création d'un produit nécessite l'autorisation de les publier.
• Les capacités de remise nécessitent l'autorisation de gérer les remises.
• Les capacités de rapport nécessitent l'autorisation de visualiser les rapports de la boutique.
• Les capacités de paramètres, taux de taxe, vérification de l'état et journal nécessitent l'autorisation de gérer les paramètres de la boutique.

Choisir le compte que vous connectez est donc le principal moyen de limiter ce qu'un assistant peut atteindre, et cela s'applique aussi bien aux lectures qu'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 de votre administrateur WordPress, allez dans Téléchargements » Outils, puis sélectionnez l'onglet IA.

Plus bas sur cet onglet, les cartes regroupent tout ce que votre boutique décrit actuellement, et la phrase à côté de l'en-tête le compte : combien de types d'informations un assistant peut rechercher, et combien de types de modifications 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.