Bonnes pratiquesCas d'utilisation

Agent de commerce

Copy page



Créez un agent d'achat et un agent marchand sur Claude à l'aide de Claude for commerce, un blueprint open source comprenant des implémentations fonctionnelles sur l'API Messages, le Claude Agent SDK et Claude Managed Agents.

Ce guide explique comment créer des agents de commerce sur Claude. Le premier est un « shopping agent » (agent d'achat) que les clients utilisent dans votre application. Le second est un « merchant agent » (agent marchand) destiné aux personnes qui gèrent la boutique, qu'il s'agisse du personnel opérationnel de l'entreprise ou des vendeurs de sa plateforme. Le guide s'appuie pour cela sur Claude for commerce, un « blueprint » (plan de référence) open source. Celui-ci comprend une implémentation fonctionnelle de chaque agent sur l'API Messages, le Claude Agent SDK et Claude Managed Agents. Il fournit aussi des exemples exécutables pour le commerce de détail, le voyage, les télécommunications et le divertissement, ainsi qu'un plugin Claude Code qui génère la même conception sur vos propres systèmes.

Le code, les instructions de configuration et la documentation de sécurité se trouvent dans le dépôt Claude for commerce sur GitHub. L'article d'ingénierie Un guide de l'anatomie des agents de commerce efficaces explique comment les agents sont construits et pourquoi. Il aborde notamment la conception à agent unique avec des skills, les composants d'interface utilisateur en tant qu'outils, la sécurité imposée par le « harness » (environnement d'exécution), la « prompt caching » (mise en cache des prompts), la mémoire et les « evals » (évaluations).

L'agent d'achat

L'agent d'achat réside dans votre application. Il accède à vos systèmes via une interface backend unique que vous implémentez au-dessus de vos services de catalogue, de panier, de préférences, de commandes, de politiques et d'exécution des commandes. Aucune méthode de cette interface ne passe de commande ni ne déplace d'argent. Au cours d'une conversation, l'agent peut :

• Rechercher dans le catalogue, comparer les finalistes et transformer un besoin décrit en une liste restreinte et une recommandation.
• Planifier un ensemble coordonné d'articles en vue d'un objectif tel qu'un voyage, un événement ou l'aménagement d'une pièce, et l'adapter à un budget.
• Afficher les produits, les comparaisons, les plans, le statut des commandes et le panier sous forme de composants d'interface utilisateur rendus dans la conversation.
• Remplir le panier et passer le relais à votre processus de paiement.
• Répondre aux questions sur les commandes, les livraisons, les retours et les politiques à partir de vos propres systèmes de commandes et de politiques.
• Se souvenir de ce qu'un client lui demande de retenir et l'appliquer lors de sessions ultérieures.

Cinq « skills » (compétences) se chargent à la demande. Elles couvrent la recherche et la découverte, la recherche préalable à l'achat, la planification en vue d'un objectif, le service client, ainsi que la mémoire et la personnalisation. Les règles dont l'agent a besoin à la plupart des tours se trouvent plutôt dans le « system prompt » (invite système). C'est le cas du « grounding » (ancrage), de la sémantique du panier et du paiement, et de la présentation.

L'agent n'énonce les produits, les prix, la disponibilité et les conditions de la boutique qu'à partir des résultats d'outils présents dans la conversation. Les écritures dans le panier n'acceptent que les identifiants de produits renvoyés par un outil de catalogue ou de commande au cours de cette session. Le paiement prépare un récapitulatif que le client confirme dans votre application. Si vous utilisez un paiement hébergé, votre backend renvoie son URL et l'hôte l'affiche sans la faire transiter par le modèle.

L'agent marchand

L'agent marchand assiste les personnes qui gèrent la boutique. Il accède à vos systèmes d'analyse, de catalogue, d'inventaire, de tarification et de campagnes via sa propre interface backend, et il peut :

• Expliquer comment se porte l'entreprise : pourquoi une métrique a évolué, quel segment en est à l'origine, et quel est le rythme par rapport à une période comparable. Un délégué d'analyse facultatif exécute des requêtes en lecture seule dans les limites d'un budget de temps et de taille.
• Présenter un résumé quotidien de ce qui requiert de l'attention, notamment les stocks faibles, les produits à rotation lente et les exceptions de commande.
• Améliorer le contenu des fiches produits et corriger les données du catalogue à partir des éléments fournis par l'opérateur.
• Recommander des changements de prix et des promotions dans le respect des « guardrails » (garde-fous) de la boutique, avec un aperçu de la marge.
• Rédiger des campagnes marketing avec des audiences, des emplacements et un budget.

Ses cinq skills couvrent les analyses de performance, l'inventaire et les opérations, le catalogue et les fiches produits, la tarification et les promotions, ainsi que les campagnes marketing.

Chaque écriture proposée par l'agent marchand est une modification préparée dotée d'un identifiant généré par le serveur, que l'opérateur voit sous forme de carte d'aperçu. Cela vaut pour une mise à jour de fiche produit, un changement de prix, une action d'inventaire, une promotion ou une campagne. Les garde-fous sont vérifiés lorsque la modification est préparée, puis à nouveau lorsqu'elle est appliquée. Ils portent par exemple sur la variation de prix maximale, la profondeur des promotions, la taille des réapprovisionnements, le budget des campagnes et les champs protégés. La modification n'est appliquée qu'après qu'une personne l'a approuvée en dehors de la conversation. Selon le parcours, cette approbation passe par un bouton dans le portail marchand (API Messages), par une invite de confirmation dans la console (Agent SDK), ou par une politique d'autorisation always-ask sur l'outil d'application (Claude Managed Agents). Une approbation saisie dans le chat n'approuve rien.

Exemples par secteur

Chaque exemple comprend une vitrine client et un portail marchand reposant sur des données fictives.

Où il s'exécute

Les environnements d'exécution de l'API Messages et de l'Agent SDK fonctionnent avec l'API Claude, Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, ou via votre propre passerelle. Le parcours Claude Managed Agents s'exécute sur l'API Claude. Le guide de déploiement du dépôt indique où chaque parcours sélectionne sa plateforme et quel format d'identifiant de modèle chacun attend.

Créez le vôtre avec le plugin Claude Code

Le blueprint est fourni avec un plugin Claude Code qui utilise le dépôt cloné comme référence et construit un agent sur vos propres systèmes. Ses quatre commandes couvrent tout le parcours, de zéro jusqu'à un agent testé :

Le plugin comprend également six skills, qui se chargent chaque fois qu'une conversation Claude Code y correspond. Elles portent sur l'architecture, la mise en cache des prompts, l'interface utilisateur en tant qu'outils, la confiance et la sécurité, les évaluations et les opérations marchandes. Les instructions d'installation se trouvent dans le README du dépôt.

Vous pouvez aussi adapter la référence manuellement. Pour cela, implémentez l'interface backend d'achat ou marchande au-dessus de vos services. Désactivez ensuite les systèmes dont vous ne disposez pas à l'aide des indicateurs de configuration, afin que leurs outils et leurs lignes de prompt disparaissent. Enfin, définissez le nom de votre marque, le nom de votre assistant et votre ton. Le guide backend du dépôt détaille l'identité et les identifiants, les flux ordonnés, le transfert vers le paiement et les produits avec options. Un projet pilote peut se limiter à implémenter la recherche et les détails des produits, et simuler le reste.

Premiers pas