Agentic Commerce

Agentic Commerce ist eine Erweiterung für Shopware, die du über Erweiterungen > Meine Erweiterungen installieren kannst.

Die Erweiterung stellt derzeit die folgenden Komponenten bereit:

Universal Commerce Protocol (UCP) – ermöglicht KI-Commerce-Agenten, deinen Shop automatisch zu erkennen und über eine standardisierte Schnittstelle mit ihm zu interagieren.
Product Feed-Verkaufskanal – stellt Produktdaten für externe Systeme und KI-Agenten über einen dedizierten Verkaufskanal bereit.

Hinweis: Dieses Feature befindet sich derzeit im Beta-Status. Der Funktionsumfang ist in dieser Version noch eingeschränkt und kann in zukünftigen Updates weiter ausgebaut werden.

Es kann sich in Verhalten und Umfang noch ändern. Wir freuen uns über dein Feedback, um die Funktion gezielt weiterzuentwickeln.

UCP (Universal Commerce Protocol)

Über Einstellungen > Handel > UCP verwaltest du die Verkaufskanäle, die über das Universal Commerce Protocol (UCP) für KI-Commerce-Agenten freigegeben werden sollen.

UCP ermöglicht es kompatiblen KI-Agenten, deinen Shop automatisch zu erkennen und über eine standardisierte Schnittstelle auf ausgewählte Funktionen und Produktdaten zuzugreifen. Dabei entscheidest du selbst, welche Verkaufskanäle für Agenten verfügbar sind.

Verkaufskanal-Übersicht

Im oberen Bereich findest du eine Übersicht über die aktuelle UCP-Konfiguration. Dort werden die verwendete Shopware-Version sowie die Anzahl der verfügbaren, aktiven und inaktiven Verkaufskanäle angezeigt.

Aktive Verkaufskanäle

In diesem Bereich werden alle Verkaufskanäle angezeigt, die aktuell über UCP freigegeben sind. Nur diese Verkaufskanäle werden im öffentlichen UCP-Profil veröffentlicht und können von kompatiblen KI-Agenten genutzt werden.

Für jeden aktiven Verkaufskanal werden zusätzliche Informationen angezeigt, darunter die Anzahl der aktivierten UCP-Funktionen sowie die verfügbaren Übertragungswege.

Über UCP konfigurieren öffnest du die Einstellungen des jeweiligen Verkaufskanals und legst fest, welche Funktionen und Übertragungswege für Agenten verfügbar sind.

Mit Verkaufskanal konfigurieren wechselst du direkt in die allgemeinen Einstellungen des ausgewählten Verkaufskanals.

Inaktive Verkaufskanäle

Dieser Bereich listet alle Verkaufskanäle auf, die derzeit nicht über UCP veröffentlicht werden. Sie bleiben für KI-Agenten unsichtbar, bis du sie aktivierst.

Um einen Verkaufskanal für UCP freizugeben, klicke auf Aktivieren. Der Kanal wird anschließend in die Liste der aktiven Verkaufskanäle übernommen und im UCP-Profil veröffentlicht.

Hinweis: Aktiviere nur Verkaufskanäle, deren Inhalte und Funktionen tatsächlich von KI-Agenten genutzt werden sollen. Nicht freigegebene Verkaufskanäle bleiben außerhalb des öffentlichen UCP-Profils.

Freigabe und Profil

Aktiviere die Option Diesen Verkaufskanal über UCP freigeben, um den Verkaufskanal für KI-Agenten sichtbar zu machen.

Über die Quelle der Profil-URL legst du fest, welche Domain für die Veröffentlichung des UCP-Profils verwendet wird. Die Profil-URL dient Agenten als Einstiegspunkt zur Erkennung und Nutzung des Verkaufskanals.

Optional kannst du eine Weiterleitungs-URL hinterlegen. Diese wird verwendet, um Agenten nach bestimmten Interaktionen auf eine definierte Zielseite weiterzuleiten.

Sicherheit und Auslieferung

In diesem Bereich konfigurierst du die Sicherheits- und Auslieferungseinstellungen des Verkaufskanals.

Signatur-Richtlinie: Definiert, ob und wie Anfragen und Antworten kryptografisch signiert werden.
Idempotenz-Schlüssel für Schreibanfragen erzwingen: Verhindert die mehrfache Ausführung identischer Schreiboperationen.
Discovery Budget: Begrenzt die Anzahl der Discovery-Aufrufe für die automatische Erkennung von Profilen und Funktionen.
Remote Profile Hosts: Legt fest, welche externen UCP-Profile kontaktiert werden dürfen.
Agent- und Webhook-Hosts: Beschränkt die Kommunikation auf definierte Hosts.
Embedded Frame Ancestors und erlaubte Embedded Origins: Definieren, welche Ursprünge eingebettete Inhalte laden oder darstellen dürfen.
Webhook-URL überschreiben: Ermöglicht die Verwendung einer individuellen Webhook-Adresse.

Funktionen

Hier legst du fest, welche UCP-Funktionen für Agenten verfügbar sind. Aktiviere nur Funktionen, die für den jeweiligen Verkaufskanal vollständig eingerichtet und getestet wurden.

Folgende Funktionen stehen derzeit zur Verfügung:

Katalog – Bereitstellung von Produktinformationen.
Warenkorb – Erstellen und Verwalten von Warenkörben.
Rabatte – Anwenden und Verwalten von Rabatten.
Checkout – Durchführung des Bestellabschlusses.
Bestellungen – Erstellen und Abrufen von Bestellungen.
Payment Tokenization – Verarbeitung tokenisierter Zahlungsinformationen.
Identity Linking – Verknüpfung von Kundenidentitäten über verschiedene Systeme hinweg.

Übertragungswege

Übertragungswege bestimmen, über welche Protokolle Agenten mit dem Verkaufskanal kommunizieren können. Welche Übertragungswege verfügbar sind, hängt von der verwendeten Shopware-Version und den unterstützten UCP-Funktionen ab.

REST
A2A
Embedded
MCP (wird erst ab Version 6.7.12.0 zur Verfügung stehen)

Signaturschlüssel

Für die sichere Kommunikation verwendet UCP kryptografische Signaturschlüssel. In diesem Bereich kannst du neue Schlüssel erzeugen, bestehende Schlüssel verwalten und den aktiven Schlüssel festlegen.

Vor dem produktiven Einsatz sollte mindestens ein aktiver Signaturschlüssel vorhanden sein.

Profilvorschau

Die Profilvorschau zeigt das generierte UCP-Profil des Verkaufskanals in strukturierter Form an. Dadurch kannst du überprüfen, welche Funktionen, Endpunkte und Signaturschlüssel für Agenten veröffentlicht werden.

Agentic Commerce Product Feed

Der Verkaufskanal Agentic Commerce dient dir als zentraler Einstiegspunkt für KI-getriebene Produktdistribution. Damit kannst du deine Produkte über einen standardkonformen JSONL-Feed auf Plattformen wie ChatGPT verfügbar machen.

Gleichzeitig hast du die Möglichkeit, die geschäftlichen Auswirkungen von KI-generiertem Traffic zu messen, z. B. in Bezug auf Bestellungen, Kunden und Umsatz.

Der Verkaufskanal ist als skalierbare Grundlage konzipiert. Das bedeutet, dass du neben ChatGPT künftig auch weitere KI-Plattformen nahtlos anbinden kannst und so einen zukunftssicheren Ansatz für KI-basierten Commerce nutzt.

Die Registrierung für den ChatGPT-Marktplatz ist derzeit nur in den USA verfügbar. In Europa kann die Funktion aktuell nicht genutzt werden.

Verkaufskanal anlegen

Im Menü deiner Shopware-Administration findest du den Punkt Verkaufskanäle. Über das Plussymbol (1) kannst du einen neuen Agentic Commerce-Verkaufskanal (2) anlegen. Du gelangst anschließend in die Grundeinstellungen.

Allgemein

Grundeinstellungen

Template (1): Wähle ein passendes Template aus.
Aktuell steht dir das OpenAI-Template (JSONL) sowie das Google Shopping-Template (XML)zur Verfügung, mit denen du direkt starten kannst.
Name (2): Vergib einen eindeutigen Namen für den Verkaufskanal.
Verkaufskanal als Favorit markieren (3): Markiere den Verkaufskanal optional als Favorit, um ihn schneller wiederzufinden.

OpenAI-Einstellungen

In Shopware sind Eigenschaften wie Farbe oder Größe keine vordefinierten Systemeigenschaften. Wenn du solche Angaben nutzen möchtest, musst du sie zunächst als Eigenschaften in deinem Shop anlegen. Standardmäßig stehen nur grundlegende Dimensionen wie Höhe, Länge, Breite oder Gewicht inklusive Einheit zur Verfügung.

Damit KI-Plattformen diese Informationen korrekt verarbeiten können, ordnest du in den OpenAI-Einstellungen deine vorhandenen Eigenschaften den entsprechenden Feldern (z. B. Farbe, Größe oder Größensystem) zu. Diese Zuordnung ist notwendig, da es keine einheitliche Struktur für solche Eigenschaften gibt.

Auch die URL zur Rückgaberichtlinie ist verpflichtend. Da Shopware keine zentrale Seite für Rückgaben vorgibt und gesetzliche Anforderungen je nach Region variieren (z. B. Widerrufsrecht in der EU), musst du hier eine eigene Seite angeben. Auf dieser sollte klar beschrieben sein, unter welchen Bedingungen Produkte zurückgegeben werden können.

URL zur Rückgaberichtlinie (1): Gib die URL zur Rückgaberichtlinie an, damit KI-Plattformen deine Rückgabebedingungen anzeigen können.
Zuweisung für Variantenfarbe (2): Ordne eine Eigenschaft für die Variantenfarbe zu.
Zuweisung für Variantengrößen (3): Ordne eine Eigenschaft für die Variantengrößen zu.
Zuweisung für Variantengrößensystem (4): Lege das Größensystem für Varianten fest.
Zuweisung für Variantengeschlecht (5): Ordne eine Eigenschaft für das Variantengeschlecht zu.
Zuweisung für Variantenmaterial (6): Ordne eine Eigenschaft für das Material der Varianten zu.
Custom-Varianten-Zuweisung (7): Definiere bei Bedarf eine Custom-Varianten-Zuweisung für zusätzliche Attribute.

Google-Einstellungen

Im Bereich Google-Einstellungen ordnest du die in deinem Shop verwendeten Varianten-Eigenschaften den von Google unterstützten Attributen zu. Dadurch können Varianteninformationen im Product Feed korrekt übertragen und von Google verarbeitet werden.

Für die folgenden Google-Attribute kannst du jeweils eine passende Varianten-Eigenschaft auswählen:

Zustand
Farbe
Größe
Größensystem
Geschlecht
Altersgruppe
Material

Zusätzlich kannst du über die Custom-Varianten-Zuweisung weitere Varianten-Eigenschaften individuellen Google-Attributen zuordnen, falls diese nicht durch die vordefinierten Felder abgedeckt werden.

Tracking-Codes

Affiliate-Code (1): Trage einen Affiliate-Code ein, um Bestellungen und Kunden diesem Verkaufskanal zuzuordnen.
Kampagnen-Code (2): Optional kannst du einen Kampagnen-Code hinzufügen, um Traffic und Conversions genauer zu analysieren.

Storefront-Verkaufskanal

Storefront-Verkaufskanal (1): Wähle den Storefront-Verkaufskanal, aus dem die Produktdaten bezogen werden sollen.
Storefront-Domain (2): Lege die passende Storefront-Domain fest, die in den Produkt-URLs verwendet wird.
Währung (3): Hier kannst du die gewünschte Währung auswählen. Dieses Feld wird erst angezeigt, sobald ein Storefront-Verkaufskanal und eine Storefront-Domain ausgewählt wurden.
Sprache (4): Die Sprache wird automatisch anhand des gewählten Verkaufskanals festgelegt. Dieses Feld wird erst angezeigt, sobald ein Storefront-Verkaufskanal und eine Storefront-Domain ausgewählt wurden.
Kundengruppe (5): Dieses Feld wird automatisch anhand des ausgewählten Verkaufskanals ausgefüllt.

Produktexport

Varianten als eigene Produkte exportieren (1): Aktiviere optional Varianten als eigene Produkte exportieren, wenn jede Variante einzeln im Feed erscheinen soll.
Generierungsintervall (2): Wähle das Generierungsintervall (z. B. „Live“), um festzulegen, wie aktuell der Feed ist.
Per Scheduler generieren (3): Aktiviere diese Option, um den Export automatisch zeitgesteuert durch das System erstellen zu lassen. Ist die Option deaktiviert, wird der Feed erst beim Aufruf der Feed-URL generiert, was beim ersten Aufruf nach Ablauf des Intervalls zu längeren Ladezeiten führen kann.
Dynamische Produktgruppe (4): Wähle eine dynamische Produktgruppe, um festzulegen, welche Produkte in den Feed aufgenommen werden.

Status festlegen

Aktiv (1): Aktiviere den Verkaufskanal über die Option Aktiv, damit er für API-Verbindungen und Feeds erreichbar ist.
Wartungsmodus (2): Nutze optional den Wartungsmodus, um den Verkaufskanal vorübergehend zu deaktivieren, während du Änderungen vornimmst.
Allowlist für IP-Adressen (3): Trage bei Bedarf IP-Adressen in die Allowlist ein, um bestimmten Nutzern weiterhin Zugriff zu gewähren.
Standard-Wartungsseiten-Layout ändern (4): Über den Link kannst du das Layout der Wartungsseite anpassen.

Verkaufskanal löschen

Über die Schaltfläche Verkaufskanal löschen kannst du den Verkaufskanal dauerhaft entfernen.

Beachte, dass dieser Vorgang nicht rückgängig gemacht werden kann.

Integration

OpenAI-Verbindung einrichten

Rufe die Seite chatgpt.com/merchants auf und registriere dich als Merchant.
Kopiere die Export-URL deines Feeds und übermittle sie an OpenAI gemäß der Produkt-Feed-Dokumentation.
Stelle sicher, dass die Export-URL öffentlich erreichbar ist.

Hinweise zur OpenAI-Verbindung

Der Export stellt einen JSONL-Feed bereit, der von OpenAI regelmäßig abgerufen wird, um deine Produkte zu indexieren.
Änderungen an Produkten werden automatisch im Feed berücksichtigt, abhängig vom gewählten Generierungsintervall.
Stelle sicher, dass die Feed-URL dauerhaft erreichbar ist und keine Authentifizierung erfordert.
Wenn der Feed nicht öffentlich zugänglich ist, können deine Produkte nicht auf KI-Plattformen erscheinen.
Nach dem Einreichen der URL kann es etwas dauern, bis deine Produkte in den Suchergebnissen von ChatGPT sichtbar sind.
Überprüfe bei Problemen, ob der Feed korrekt generiert wird und gültige Produktdaten enthält.

Google Merchant Center verbinden

Im Reiter Integration findest du die Export-URL deines Google Product Feeds. Diese URL kannst du im Google Merchant Center als Datenquelle hinterlegen, damit Google die Produktdaten deines Shops regelmäßig importieren kann.

Um den Feed mit dem Google Merchant Center zu verbinden, gehe wie folgt vor:

Erstelle ein Google Merchant Center-Konto und verifiziere die URL deines Shops.
Öffne im Google Merchant Center die Einstellungen für die Datenquellen und lege eine neue Produktquelle an.
Wähle einen geplanten Abruf über eine URL und hinterlege die im Verkaufskanal angezeigte Export-URL.
Stelle sicher, dass die Export-URL öffentlich erreichbar ist und keine Authentifizierung erfordert.
Überprüfe nach dem ersten Import die von Google erkannten Produktdaten und passe die Feed-Konfiguration bei Bedarf an.

Hinweis: Die Export-URL wird automatisch von Shopware generiert. Änderungen am Produktsortiment werden über den Feed bereitgestellt und können von Google bei der nächsten Synchronisierung übernommen werden.

Template

Feed-Template anpassen

Im Bereich Kopfzeile kannst du optionale Einträge definieren, die einmalig am Anfang des Feeds ausgegeben werden.
Die Produktzeile enthält die eigentliche Logik für den Export deiner Produktdaten und wird für jedes Produkt im Feed ausgeführt.
Im Bereich Fußzeile kannst du optional Inhalte ergänzen, die am Ende des Feeds ausgegeben werden.
Das Template basiert auf der Shopware-Template-Syntax (Twig), sodass du Produktdaten flexibel anpassen und erweitern kannst.
Nutze Template testen, um die Funktionalität deines Templates zu überprüfen.
Über Vorschau generieren kannst du dir eine Beispielausgabe des Feeds anzeigen lassen.
Mit Auf Standard zurücksetzen stellst du das ursprüngliche Template wieder her.

Statistiken

Statistiken auswerten

Im Bereich Vermittelte Bestellungen siehst du, wie viele Bestellungen über den Agentic-Commerce-Verkaufskanal generiert wurden.
Vermittelte Kunden zeigt dir, wie viele neue Kunden über KI-Plattformen gewonnen wurden.
Der vermittelte Umsatz gibt dir einen Überblick über den generierten Umsatz durch diesen Verkaufskanal.
Über den Zeitraum-Filter (z. B. „Letzte 30 Tage“) kannst du die Auswertung flexibel anpassen.