Best PracticesAnwendungsfälle

Commerce-Agent

Copy page



Erstelle einen Shopping-Agenten und einen Händler-Agenten auf Claude mit Claude for commerce, einem Open-Source-Blueprint mit funktionierenden Implementierungen auf der Messages API, dem Claude Agent SDK und Claude Managed Agents.

Dieser Leitfaden zeigt, wie du Commerce-Agenten auf Claude erstellst: einen Shopping-Agenten, den Kunden in deiner App nutzen, und einen Händler-Agenten für die Menschen, die den Shop betreiben, ob das nun das eigene Betriebspersonal des Unternehmens oder die Verkäufer auf seiner Plattform sind. Dafür nutzt er Claude for commerce, einen Open-Source-Blueprint. Dieser enthält eine funktionierende Implementierung jedes Agenten auf der Messages API, dem Claude Agent SDK und Claude Managed Agents. Dazu kommen ausführbare Beispiele für Einzelhandel, Reisen, Telekommunikation und Unterhaltung sowie ein Claude Code-Plugin, das dasselbe Design für deine eigenen Systeme aufsetzt.

Der Code, die Einrichtungsanleitung und die Sicherheitsdokumentation befinden sich im Claude for commerce-Repository auf GitHub. Der Engineering-Beitrag Ein Leitfaden zur Anatomie effektiver Commerce-Agenten erklärt, wie die Agenten aufgebaut sind und warum. Er behandelt das Design mit einem einzelnen Agenten und Skills, UI-Komponenten als Tools, vom Harness durchgesetzte Sicherheit, „prompt caching" (Prompt-Caching), Memory und „evals" (Evaluierungen).

Der Shopping-Agent

Der Shopping-Agent befindet sich in deiner App und erreicht deine Systeme über eine einzige Backend-Schnittstelle. Diese implementierst du auf Basis deiner Katalog-, Warenkorb-, Präferenz-, Bestell-, Richtlinien- und Fulfillment-Dienste. Keine Methode dieser Schnittstelle gibt eine Bestellung auf oder bewegt Geld. In einer Unterhaltung kann der Agent:

• den Katalog durchsuchen, Finalisten vergleichen und aus einem beschriebenen Bedarf eine Auswahlliste und eine Empfehlung ableiten.
• eine abgestimmte Zusammenstellung von Artikeln für ein Ziel wie eine Reise, eine Veranstaltung oder einen Raum planen und sie an ein Budget anpassen.
• Produkte, Vergleiche, Pläne, Bestellstatus und den Warenkorb als UI-Komponenten anzeigen, die in der Unterhaltung gerendert werden.
• den Warenkorb füllen und an deinen Checkout übergeben.
• Fragen zu Bestellungen, Lieferungen, Rücksendungen und Richtlinien anhand deiner eigenen Bestell- und Richtliniensysteme beantworten.
• sich merken, worum ein Kunde ihn bittet, und dies in späteren Sitzungen anwenden.

Fünf Skills werden bei Bedarf geladen. Sie decken Suche und Entdeckung, Kaufrecherche, Planung auf ein Ziel hin, Kundenservice sowie Memory und Personalisierung ab. Regeln, die der Agent in den meisten Turns benötigt, befinden sich stattdessen im „system prompt" (System-Prompt). Dazu gehören Grounding, Warenkorb- und Checkout-Semantik sowie Präsentation.

Der Agent nennt Produkte, Preise, Verfügbarkeit und Shop-Bedingungen nur auf Basis von Tool-Ergebnissen in der Unterhaltung. Schreibvorgänge im Warenkorb akzeptieren nur Produkt-IDs, die ein Katalog- oder Bestell-Tool in dieser Sitzung zurückgegeben hat. Der Checkout bereitet eine Zusammenfassung vor, die der Kunde in deiner App bestätigt. Wenn du einen gehosteten Checkout verwendest, gibt dein Backend dessen URL zurück, und der Host rendert sie, ohne sie durch das Modell zu leiten.

Der Händler-Agent

Der Händler-Agent unterstützt die Menschen, die den Shop betreiben. Er erreicht deine Analyse-, Katalog-, Bestands-, Preis- und Kampagnensysteme über seine eigene Backend-Schnittstelle und kann:

• erklären, wie es dem Unternehmen geht: warum sich eine Kennzahl verändert hat, welches Segment dafür verantwortlich war und wie die Entwicklung im Vergleich zu einem vergleichbaren Zeitraum verläuft. Ein optionaler Analyse-Delegat führt schreibgeschützte Abfragen innerhalb eines Zeit- und Größenbudgets aus.
• eine tägliche Übersicht darüber präsentieren, was Aufmerksamkeit erfordert, einschließlich niedriger Lagerbestände, Ladenhüter und Bestellausnahmen.
• Listing-Inhalte verbessern und Katalogdaten anhand von Material korrigieren, das der Betreiber bereitstellt.
• Preisänderungen und Werbeaktionen innerhalb der „guardrails" (Leitplanken) des Shops empfehlen, mit einer Margenvorschau.
• Marketingkampagnen mit Zielgruppen, Platzierungen und Budget entwerfen.

Seine fünf Skills decken Performance-Insights, Bestand und Betrieb, Katalog und Listings, Preise und Werbeaktionen sowie Marketingkampagnen ab.

Jeder Schreibvorgang, den der Händler-Agent vorschlägt, ist eine vorgemerkte Änderung mit einer serverseitig generierten ID, die der Betreiber als Vorschaukarte sieht. Das gilt für Listing-Aktualisierungen, Preisänderungen, Bestandsaktionen, Werbeaktionen und Kampagnen gleichermaßen. Leitplanken wie maximale Preisänderung, Rabatthöhe von Werbeaktionen, Nachbestellmenge, Kampagnenbudget und geschützte Felder werden geprüft, wenn die Änderung vorgemerkt wird, und erneut, wenn sie angewendet wird. Die Änderung wird erst angewendet, nachdem eine Person sie außerhalb der Unterhaltung genehmigt hat. Beim Messages API-Pfad geschieht das über eine Schaltfläche im Händlerportal, im Agent SDK über eine Bestätigungsabfrage in der Konsole und bei Claude Managed Agents über eine Always-ask-Berechtigungsrichtlinie für das Apply-Tool. Eine im Chat eingetippte Genehmigung genehmigt nichts.

Branchenbeispiele

Jedes Beispiel enthält eine Kunden-Storefront und ein Händlerportal mit fiktiven Daten.

Wo es läuft

Die Laufzeitumgebungen für die Messages API und das Agent SDK laufen mit der Claude API, Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry oder über dein eigenes Gateway. Der Claude Managed Agents-Pfad läuft auf der Claude API. Der Deployment-Leitfaden des Repositorys zeigt, wo jeder Pfad seine Plattform auswählt und welches Modell-ID-Format er jeweils erwartet.

Eigene Agenten mit dem Claude Code-Plugin erstellen

Der Blueprint wird mit einem Claude Code-Plugin ausgeliefert. Das Plugin liest das geklonte Repository als Referenz und erstellt einen Agenten für deine eigenen Systeme. Seine vier Befehle decken den Weg von null bis zu einem getesteten Agenten ab:

Das Plugin enthält außerdem sechs Skills zu Architektur, Prompt-Caching, UI als Tools, Vertrauen und Sicherheit, Evals und Händlerbetrieb. Sie werden geladen, sobald eine Claude Code-Unterhaltung zu ihnen passt. Installationsanweisungen findest du in der README des Repositorys.

Du kannst die Referenz stattdessen auch manuell anpassen. Implementiere dazu die Shopping- oder Händler-Backend-Schnittstelle auf Basis deiner Dienste. Deaktiviere mit den Konfigurationsflags die Systeme, die du nicht hast, sodass ihre Tools und Prompt-Zeilen wegfallen. Lege dann deinen Markennamen, Assistentennamen und Tonfall fest. Der Backend-Leitfaden des Repositorys führt durch Identität und Anmeldedaten, geordnete Abläufe, Checkout-Übergabe und Produkte mit Optionen. Ein Pilotprojekt kann Suche und Produktdetails implementieren und den Rest als Stub anlegen.

Erste Schritte