Connecter votre IA

Laisser un assistant IA gérer vos rabais#

Ce que fait Connecter votre IA#

Connecter votre IA (Connect AI) vous permet de pointer votre propre assistant IA vers xDiscount et de demander des rabais en langage courant au lieu de remplir vous-même le formulaire de rabais.

L’écran Paramètres (Settings) le dit en deux lignes :

Connectez votre propre assistant IA pour créer et gérer des rabais. Tout ce qu’il crée arrive en brouillon, il ne peut jamais publier un rabais sans vous.

Vous apportez votre propre assistant. Nous ne stockons aucune clé de fournisseur et ne facturons rien de plus pour cela.

Comment ça fonctionne, en bref :

1. xDiscount génère une clé pour votre boutique.
2. Vous collez cette clé dans votre client IA comme jeton bearer (bearer token), pointé vers le point de terminaison /mcp de l’URL de cette application.
3. Votre assistant peut ensuite lire vos rabais et vos chiffres de performance, et créer et modifier des rabais. Tout ce qu’il crée arrive en Brouillon (Draft), quel que soit le statut demandé.
4. Vous révisez ce qu’il a fait dans Rabais (Discounts) et vous le passez vous-même à Actif (Active).

Apportez votre propre IA. xDiscount n’inclut aucun abonnement à une IA et ne stocke aucune clé de fournisseur d’IA. Vous utilisez, et payez, votre propre client : n’importe lequel qui parle MCP et qui permet de définir un jeton bearer.

Quels forfaits l’incluent#

Connecter votre IA est inclus dans tous les forfaits, le forfait Gratuit compris. La section Connecter votre IA (Connect AI) des Paramètres offre toujours Générer une clé (Generate a key). Les forfaits diffèrent par le nombre de rabais qui peuvent être actifs et par le nombre de commandes avec rabais incluses, jamais par cette fonction.

Le forfait est quand même vérifié quand vous demandez une clé et à chaque appel d’outil que fait votre assistant, donc si un forfait qui retient la fonction était un jour introduit, l’accès s’arrêterait aussitôt. Révoquer (Revoke) est toujours offert, quel que soit votre forfait.

Générer et gérer votre clé#

Générer une clé#

La clé commence toujours par xdmcp_, elle est donc facile à reconnaître plus tard dans les réglages de votre client.

La bannière vous dit pourquoi il faut se dépêcher :

Collez-la dans votre client MCP comme jeton bearer. Nous ne gardons qu’une empreinte, nous ne pouvons donc pas vous la montrer plus tard. Si vous la perdez, générez-en une nouvelle.

C’est à prendre au pied de la lettre. xDiscount ne stocke qu’une empreinte à sens unique de votre clé, pas la clé elle-même. Personne, pas même le soutien technique, ne peut vous la relire. Elle est affichée exactement une fois, dans votre navigateur, et plus jamais.

Pointer votre client IA vers xDiscount#

Chaque client formule cela différemment, mais tous ont besoin des deux mêmes choses :

Rien dans la connexion ne nomme votre boutique. xDiscount déduit quelle boutique appelle à partir de la clé elle-même, il n’y a donc aucun champ de boutique à remplir et aucun moyen pour une clé d’atteindre les rabais d’un autre marchand.

Vérifier si la connexion est réellement établie#

Une fois qu’une clé existe, la section Connecter votre IA affiche une pastille :

Quand la clé a été utilisée, vous voyez aussi Dernière utilisation (Last used) avec la date. La pastille ne dit délibérément pas « Connecté » du simple fait qu’une clé a été générée, sinon vous partiriez chercher une panne dans votre assistant alors que la configuration n’était tout simplement pas terminée.

Remplacer ou révoquer une clé#

Pour la remplacer : cliquez sur Générer une nouvelle clé (Generate a new key). Il n’y a jamais qu’une seule clé par boutique, la nouvelle remplace donc immédiatement l’ancienne. Tout client qui utilise encore l’ancienne clé cesse de fonctionner, mettez donc votre client à jour avec la nouvelle valeur.

Pour la révoquer : cliquez sur Révoquer (Revoke), le bouton rouge à côté. L’accès s’arrête dès la requête suivante, et la pastille, la date de création et la date de dernière utilisation sont toutes effacées.

Révoquez quand :

• Vous avez cessé d’utiliser ce client IA
• Vous avez collé la clé quelque part où vous n’auriez pas dû
• Vous voulez couper l’accès de l’IA pendant un temps

Ce que votre assistant peut faire#

Il y a douze outils. Votre client les liste par nom, et voici ce que chacun fait réellement.

Les quatre outils à confirmation sont signalés à votre client comme destructeurs, donc les clients qui prennent en charge les invites d’approbation vous demandent avant de les exécuter. Cette invite vient de votre client, pas de xDiscount, et un client sans étape d’approbation n’en produira pas.

Remarquez ce qui n’est pas dans la liste : rien de ce qu’un assistant peut appeler ne choisit les produits auxquels un rabais s’applique. Il peut créer le rabais, définir sa valeur, sa programmation, sa priorité et ses conditions. Vous choisissez vous-même les produits dans Rabais.

Exemples de demandes :

• « Quels rabais ai-je, et lesquels sont en service ? »
• « Créez un rabais de 15 % qui court du 1er décembre au 24 décembre. »
• « Ajoutez une condition pour qu’il ne s’applique que lorsque le panier contient au moins 3 articles. »
• « Montrez-moi les 30 derniers jours de performance. »
• « Dépubliez la vente d’été. »

Les garde-fous#

Tout ce qu’un assistant crée est un brouillon#

Un rabais que votre assistant crée arrive en Brouillon (Draft), il ne fait donc rien au paiement tant que vous ne l’avez pas dit. Ouvrez-le dans Rabais, choisissez les produits auxquels il s’applique, vérifiez la valeur, la programmation et les conditions, puis mettez Statut (Status) à Actif (Active) et cliquez sur Enregistrer (Save).

C’est imposé à l’entrée. Quel que soit le statut que l’assistant demande, un rabais qu’il crée est écrit en brouillon. Le mettre en service est un outil distinct, publishDiscount, signalé à votre client comme destructeur, donc la publication est toujours une étape délibérée en soi, et votre client vous demande d’abord confirmation s’il prend en charge les approbations.

Un rabais en service doit être dépublié avant qu’un assistant puisse le modifier#

Si vous demandez à votre assistant de changer un rabais qui est actuellement ACTIVE, la demande est refusée avec :

Ce rabais est en service. Dépubliez-le d’abord. Modifier un rabais actif changerait ce que vos clients paient sans que personne ne l’ait approuvé.

Cela couvre tous les outils de modification : updateProductDiscount, setDiscountRules, addTargets et removeTargets. La correction est exactement ce que dit le message. Dépubliez-le, faites le changement, republiez-le, pour que rien de ce que vos clients paient ne change sans une étape délibérée.

Les limites de votre forfait s’appliquent toujours#

La voie de l’IA emprunte le même chemin d’enregistrement que les écrans d’administration : la même validation, la même protection de charge utile de 10 000 octets, la même limite de forfait. Demander à un assistant de publier un rabais de trop reçoit le même refus que si vous cliquiez sur Enregistrer :

Votre forfait Gratuit inclut 3 rabais actifs, et vous en avez 3. Mettez-en un en pause ou archivez-en un, ou passez à un forfait supérieur pour en ajouter d’autres.

Les brouillons ne sont jamais bloqués par la limite. Seul ce qui est en service au paiement compte.

Une seule boutique, toujours#

Aucun outil n’accepte un nom ou un identifiant de boutique. La boutique est déduite de votre clé et revérifiée sur chaque enregistrement lu ou écrit, donc un appel d’outil ne peut jamais toucher que des rabais qui appartiennent à la boutique dont la clé l’a fait.

Messages que vous pourriez voir#