Claude Commerce Agents : les agents e-commerce d'Anthropic

Un client écrit « une tente deux places à moins de 250 dollars » dans le chat de ta boutique. L'agent lui propose une sélection, compare, remplit le panier. De l'autre côté, ton équipe demande « pourquoi les ventes ont baissé cette semaine ? » et reçoit une réponse chiffrée, plus des corrections de fiches produits prêtes à valider.

C'est ce que montre Claude Commerce Agents, un dépôt publié par Anthropic sur GitHub le 1er septembre 2026. Il affiche 3 044 étoiles et 588 copies (forks) au 25 septembre, sous licence Apache 2.0, donc réutilisable dans un projet commercial.

Le dépôt est un plan de référence : du code qui montre comment Anthropic construit un agent de vente sérieux, avec ses règles de sécurité. À toi de l'adapter ensuite à ton catalogue et à tes outils.

Pourquoi c'est utile

• Tu pars d'un modèle officiel. Le dépôt vient d'Anthropic, l'éditeur de Claude.
• Deux agents couvrent les deux côtés de la boutique. Un pour tes clients, un pour ton équipe.
• Les garde-fous sont déjà écrits. Aucun paiement, et aucune modification de la boutique sans validation humaine.
• Quatre secteurs de démo. Commerce de détail, voyage, télécoms et billetterie, pour voir l'agent dans un cas proche du tien.
• Un plugin Claude Code t'aide à l'adapter. Il te pose des questions sur ton site, puis génère le projet.

Deux agents, deux publics

Le premier, le shopping agent, s'intègre à ton site ou à ton appli, face au client. Il cherche, compare, construit un plan d'achat (tout le matériel d'un week-end de camping, par exemple), remplit le panier, répond aux questions de commande et de retour, et se souvient de ce que le client lui a dit.

Le second, le merchant agent, travaille pour ton équipe dans le back-office. Il explique les chiffres, améliore les fiches produits, surveille le stock, propose des prix et des promotions, et rédige des campagnes marketing.

Chaque agent repose sur cinq skills, des fichiers d'instructions que Claude charge selon la demande (on en présente dix dans notre sélection de skills Claude Code).

Côté client, la skill customer-care prend le relais après l'achat : colis en retard, article abîmé, remboursement. Côté équipe, performance-insights répond à « pourquoi ce chiffre a bougé » en allant lire les données avant de répondre.

Les garde-fous

C'est la partie la plus intéressante, même si tu ne comptes pas utiliser le code. Anthropic y montre comment empêcher un agent de faire une bêtise, et la plupart des règles sont appliquées par le code lui-même, en plus des consignes données au modèle.

Les principales :

• Aucun paiement. Le shopping agent ne passe aucune commande et ne débite aucune carte. Il prépare le panier et le transmet à ta page de paiement.
• Validation humaine côté équipe. Chaque modification du merchant agent (un prix, une fiche, un réassort) est mise en attente. Elle ne s'applique que si une personne la valide dans l'interface. Un « oui » tapé dans le chat ne suffit pas.
• Des plafonds chiffrés. Écart de prix, profondeur de promotion, budget de campagne : les limites sont vérifiées quand la modification est préparée, puis de nouveau au moment de l'appliquer.
• Pas de produit inventé. L'agent ne peut ajouter au panier qu'un produit qu'un outil lui a réellement renvoyé pendant la conversation.
• Les textes extérieurs sont isolés. Avis clients, descriptions fournisseurs : le code les nettoie et les place dans un cadre à part avant que l'agent les lise, et ses consignes lui demandent de les lire comme du simple contenu. C'est la parade à l'injection de prompt, une instruction cachée dans un texte pour détourner l'IA.

Le document de sécurité du dépôt liste chaque règle avec le fichier qui l'applique. Si tu travailles sur un agent client, même avec une autre technologie, lis-le.

Trois façons de le faire tourner

Le même agent (mêmes instructions, mêmes skills, mêmes outils) tourne de trois manières :

• L'API Messages, l'appel classique à Claude. C'est la version de référence, la plus complète.
• Le Claude Agent SDK, la boîte à outils d'Anthropic pour construire des agents, qui gère la boucle de travail à ta place.
• Managed Agents, la version hébergée par Anthropic, qui appelle ton propre serveur MCP (un connecteur standard entre une IA et tes outils).

Le README explique aussi comment le déployer sur Google Cloud Vertex AI, AWS Bedrock ou Microsoft Foundry, utile si ton entreprise impose déjà l'un de ces clouds.

Lancer la démo, puis ton agent

Il te faut Python 3.11 ou plus récent, Node 22 et une clé API Anthropic. Tu clones le dépôt, tu installes les dépendances, tu ajoutes ta clé et tu lances une démo, par exemple la boutique retail : l'API démarre sur le port 8000 et la vitrine sur le port 3000. L'option --merchant ouvre le back-office à la place, --all lance les deux.

Pour construire ton propre agent, installe le plugin commerce-builder dans Claude Code. Sa commande /scaffold-commerce-agent te questionne sur ta stack (catalogue, panier, commandes), te relit le plan, puis génère le projet. Trois autres commandes suivent : ajouter un parcours, écrire les tests de qualité (les « evals ») et comparer un agent que tu fais déjà tourner à la référence.

À savoir avant de te lancer

Personne ne le maintient. Le README le dit clairement : c'est une implémentation de référence, qui n'est pas maintenue et n'accepte pas de contributions. Tu la copies, tu la fais tienne, tu l'entretiens.

Il faut coder. Il faut brancher l'agent sur ton catalogue, ton panier et tes commandes en écrivant les méthodes d'une interface prévue pour ça. Sans développeur, tu t'arrêtes à la démo.

Tout est fictif. Marques, produits et personnes des démos sont inventés, la seule entreprise s'appelle ACME. Les exemples sont en anglais et en dollars.

L'API est payante. Chaque conversation consomme des tokens Claude. Le dépôt montre comment mettre en cache la partie fixe des instructions pour alléger la facture, mais prévois un budget de test.

La sécurité de production reste à ta charge. Les démos n'ont pas d'authentification. Les règles métier, les autorisations et la conformité relèvent de ton propre déploiement.

Pour qui c'est

• Équipe e-commerce avec un développeur : tu pars d'une base solide pour ton agent de vente.
• Responsable e-commerce ou marketing : lance la démo pour voir ce qu'un agent sait faire aujourd'hui, et ce qu'il ne doit jamais faire seul.
• Agence ou freelance : le plugin et les evals te donnent une méthode pour livrer un agent client propre.
• Développeur d'agents, même hors commerce : validation humaine, plafonds et textes isolés se transposent à n'importe quel agent qui agit pour une entreprise.

Bottom line

Claude Commerce Agents est une leçon d'architecture signée Anthropic : un agent qui aide tes clients et ton équipe, sans payer à ta place ni toucher à ta boutique sans ton accord. Même sans boutique, le document de sécurité vaut la lecture. Tout est sur github.com/anthropics/commerce-agents, avec les quatre démos et le plugin Claude Code.