Wie integriere ich das Common Commerce Protocol (UCP) mit KI-Agenten?

Agentisches Surfen wird schnell zum Mainstream.

Die Leute wollen nicht nur, dass KI-Agenten das tun Forschung Produkte mehr. Sie möchten, dass Agenten tatsächlich Dinge für sie kaufen: Optionen vergleichen, Bestellungen aufgeben, Zahlungen abwickeln und die gesamte Transaktion abschließen.

Da fingen die Dinge an zu brechen.

Der heutige Commerce-Stack ist fragmentiert. Jeder Händler, jede Plattform und jeder Zahlungsanbieter nutzt proprietäre Integrationen. Selbst wenn ein Agent klug genug ist, Entscheidungen zu treffen, hat er Schwierigkeiten, in großem Maßstab zu handeln, da er keine gemeinsame Möglichkeit hat, mit diesen Systemen zu kommunizieren.

Genau diese Lücke soll das Common Commerce Protocol (UCP) von Google schließen.

UCP schafft einen standardisierten, sicheren Weg für KI-Agenten, Händler, Plattformen und Zahlungsanbieter zur Kommunikation. Anstatt benutzerdefinierte Integrationen für jedes Geschäft oder jede Dienstleistung zu erstellen, können Agenten über ein gemeinsames Protokoll mit Handelssystemen interagieren, wodurch der agentengesteuerte Einkauf endlich praktisch, interoperabel und skalierbar wird.

Was ist das Common Commerce Protocol (UCP)?

Das Common Commerce Protocol ist ein offener Handelsstandard, der digitale Agenten mit Handelssystemen verbindet. Es bietet einen gemeinsamen Rahmen für die Suche nach Produkten, die Verwaltung von Warenkörben, die Ausführung von Zahlungen und die Abwicklung von Aufgaben nach dem Kauf. UCP ersetzt nicht bestehende E-Commerce-Plattformen oder Zahlungssysteme. Stattdessen fungiert es als gemeinsame Sprache, die es KI-Agenten, Anwendungen, Händlern und Zahlungsanbietern ermöglicht, reibungslos zu interagieren.

Die Kernidee hinter UCP

UCP ist in erster Linie eine Lösung für eine Integrationsherausforderung. In der Vergangenheit battle jeder KI-Assistent oder jede KI-Plattform auf einzigartige Integrationen mit jedem Händler oder Handelssystem angewiesen. Diese Methode battle nicht skalierbar.

• Ein einheitlicher Satz von Handelsaktionen
• Eindeutige Rollendefinitionen für Agenten, Händler und Zahlungsabwickler
• Versatile Schemata, die branchenübergreifend anwendbar sind
• Diese Arbeitsweise reduziert den Engineering-Aufwand erheblich und ermöglicht gleichzeitig eine schnellere Innovation

Warum ist UCP wichtig?

Das heutige E-Commerce-Ökosystem ist stark fragmentiert. Jeder Einkaufskanal wie Web sites, cell Apps und Plattformen von Drittanbietern erfordert individuelle Integrationen mit jedem Händler. Daher muss ein Einzelhändler, der über mehrere Kanäle verkauft, viele komplexe Integrationen verwalten. Diese Herausforderung wächst, da KI-Einkaufsagenten für Menschen zum alltäglichen Einkaufsmittel werden.

UCP löst dieses Downside durch die Einführung eines einzigen Standardprotokolls, das die gesamte Einkaufsreise abdeckt, von der Produktfindung über den Checkout bis hin zur Bestellverwaltung. Dies vereinfacht Integrationen und ermöglicht es dem Ökosystem, mehrere wichtige Vorteile zu erschließen.

• Einheitliche Integration: Reduziert komplexe N×N-Commerce-Integrationen auf einen einzigen Integrationspunkt für KI-Agenten und -Schnittstellen.
• Geteilte Sprache: Definiert gemeinsame Schemata und APIs, damit alle Handelssysteme konsistent durchgängig kommunizieren können.
• Erweiterbarer, modularer Aufbau: Verwendet modulare Komponenten, die sich weiterentwickeln lassen, ohne bestehende Integrationen zu zerstören.
• Safety-First-Ansatz: Gewährleistet sichere, tokenisierte Zahlungen mit überprüfter Benutzereinwilligung für jede Transaktion.

Für Kunden bedeutet dies reibungslosere Interaktionen und weniger Warenkorbabbrüche. Käufer können schnell vom Stöbern oder Chatten zum Abschluss eines Kaufs übergehen, oft ohne erneute Eingabe von Daten. Wie Google erklärt, ist UCP so konzipiert, dass Verbraucher sicher mit Google Pay bezahlen können, wobei Zahlungs- und Versandinformationen bereits in Google Pockets gespeichert sind.

Lesen Sie auch: High 10 der Agent AI Chrome-Erweiterungen

Warum hat Google UCP eingeführt?

Der Handel hat sich langsam aber sicher in den Bereich von Chat und Robotern verlagert. Heutzutage verlangen die Nutzer von KI-Systemen, dass sie agieren, statt nur zu informieren. Google hat UCP eingeführt, um diesen Wandel voranzutreiben und gleichzeitig die Türen offen und das Ökosystem stabil zu halten. Als Agentic Commerce werden KI-Systeme bezeichnet, die in der Lage sind, eigenständig kommerzielle Arbeiten zu erledigen. Solche Agenten sind in der Lage:

• Produkte suchen und bewerten
• Passen Sie die Auswahl je nach Geschmack des Benutzers an
• Kaufen Sie sicher ein
• Bearbeiten Sie Retouren, geben Sie Rückerstattungen und bieten Sie Help an

Wie funktioniert das Common Commerce Protocol (UCP)?

UCP funktioniert, indem es die Handelsreise in eine klare Abfolge von Aktionen unterteilt, denen KI-Agenten folgen können. Jeder Schritt stellt eine spezifische Interaktion dar, von der Entdeckung eines Produkts über den Abschluss der Transaktion bis hin zur Abwicklung der nächsten Schritte. Zusammen definieren diese Schritte, wie ein Agent einen Kauf auf kontrollierte und vorhersehbare Weise abwickelt. Lassen Sie uns dies aufschlüsseln und jeden Schritt einzeln betrachten:

Schritt 1: Richten Sie den Enterprise-Server ein und fügen Sie Beispielprodukte zu Ihrem Store hinzu

Um Unternehmen den Einstieg zu erleichtern, hat Google ein Beispiel-Repository eingerichtet. Das Repository enthält einen Python-Server, der zum Hosten von Enterprise-APIs verwendet werden kann, sowie ein UCP SDK, das Beispielproduktdaten und Referenzimplementierungen bereitstellt. Diese Komponenten arbeiten zusammen, um dem Benutzer zu helfen, zu visualisieren und zu verstehen, wie ein UCP-kompatibler Unternehmensserver konfiguriert und getestet werden kann.

Konfigurieren des Enterprise-Servers:

mkdir sdk
git clone https://github.com/Common-Commerce-Protocol/python-sdk.git sdk/python
pushd sdk/python
uv sync
popd
git clone https://github.com/Common-Commerce-Protocol/samples.git 
cd samples/relaxation/python/server
uv sync

Am Beispiel eines Blumenladens spielt Google zu Demonstrationszwecken die Rolle des Unternehmens. Darüber hinaus stellen wir eine einfache Produktdatenbank auf SQLite-Foundation zur Verfügung, die die Katalogdaten für die Demoumgebung enthält, die mit den Beispieldaten identisch sind. Diese Konfiguration ermöglicht es den Entwicklern, realistische Produktinformationen zum Testen von UCP-Workflows zu verwenden, ohne dass eine vollständige Produktionsdatenbank erforderlich ist.

Schritt 2: Bereiten Sie Ihren Unternehmensserver für die Annahme von Anfragen von Agenten vor

Starten Sie als Nächstes den Enterprise-Server, der die Enterprise-APIs auf Port 8182 hostet und eine Verbindung zur Demoproduktdatenbank herstellt. Der Server läuft im Hintergrund, sodass Clientanwendungen und KI-Agenten ohne Unterbrechung eine Verbindung herstellen können. Führen Sie den folgenden Befehl aus, um den Enterprise-Server zu starten:

uv run server.py  
--products_db_path=/tmp/ucp_test/merchandise.db  
--transactions_db_path=/tmp/ucp_test/transactions.db  
--port=8182 & 
SERVER_PID=$! 

Schritt 3: Entdecken Sie mit Ihrem Agenten die geschäftlichen Möglichkeiten

Unternehmen stellen unter /.well-known/ucp ein JSON-Manifest zur Verfügung, das ihre verfügbaren Dienste und Funktionen auflistet. Dadurch können KI-Agenten Funktionen, Endpunkte und Zahlungskonfigurationen dynamisch erkennen, ohne auf hartcodierte Integrationen angewiesen zu sein.

Führen Sie nun den folgenden Befehl aus, damit Ihr Agent die Geschäftsdienste und -funktionen ermitteln kann:

export SERVER_URL=http://localhost:8182 
export RESPONSE=$(curl -s -X GET $SERVER_URL/.well-known/ucp) 
echo $RESPONSE 
Response:  
{ 
"ucp": { 
"model": "2026-01-11", 
"companies": { "dev.ucp.procuring": { "model": "2026-01-11", "spec": "https://ucp.dev/specs/procuring", "relaxation": { "schema": "https://ucp.dev/companies/procuring/openapi.json", "endpoint": "http://localhost:8182/" } } }, 
"capabilities": ( 
{ "identify": "dev.ucp.procuring.checkout", "model": "2026-01-11", "spec": "https://ucp.dev/specs/procuring/checkout", "schema": "https://ucp.dev/schemas/procuring/checkout.json" }, 
{ "identify": "dev.ucp.procuring.low cost", "model": "2026-01-11", "spec": "https://ucp.dev/specs/procuring/low cost", "schema": "https://ucp.dev/schemas/procuring/low cost.json", "extends": "dev.ucp.procuring.checkout" }, 
{ "identify": "dev.ucp.procuring.achievement", "model": "2026-01-11", "spec": "https://ucp.dev/specs/procuring/achievement", "schema": "https://ucp.dev/schemas/procuring/achievement.json", "extends": "dev.ucp.procuring.checkout" } 
) 
}, 
"cost": { 
"handlers": ( 
{ "id": "shop_pay", "identify": "com.shopify.shop_pay", "model": "2026-01-11", "spec": "https://shopify.dev/ucp/handlers/shop_pay", "config_schema": "https://shopify.dev/ucp/handlers/shop_pay/config.json", "instrument_schemas": ( "https://shopify.dev/ucp/handlers/shop_pay/instrument.json" ), "config": { "shop_id": "d124d01c-3386-4c58-bc58-671b705e19ff" } }, 
{ "id": "google_pay", "identify": "google.pay", "model": "2026-01-11", "spec": "https://instance.com/spec", "config_schema": "https://instance.com/schema", "instrument_schemas": ( "https://ucp.dev/schemas/procuring/varieties/gpay_card_payment_instrument.json" 
), "config": { "api_version": 2, "api_version_minor": 0, "merchant_info": { "merchant_name": "Flower Store", "merchant_id": "TEST", "merchant_origin": "localhost" }, "allowed_payment_methods": ( { "kind": "CARD", "parameters": { "allowedAuthMethods": ( "PAN_ONLY", "CRYPTOGRAM_3DS" ), "allowedCardNetworks": ( "VISA", "MASTERCARD" ) }, "tokenization_specification": ( { "kind": "PAYMENT_GATEWAY", "parameters": ( { "gateway": "instance", "gatewayMerchantId": "exampleGatewayMerchantId" } ) } ) } ) } }, 
{ "id": "mock_payment_handler", "identify": "dev.ucp.mock_payment", "model": "2026-01-11", "spec": "https://ucp.dev/specs/mock", "config_schema": "https://ucp.dev/schemas/mock.json", "instrument_schemas": ( "https://ucp.dev/schemas/procuring/varieties/card_payment_instrument.json" ), "config": { "supported_tokens": ( "success_token", "fail_token" ) } } 
) 
} 
} 

Schritt 4: Rufen Sie bei Ihrem Agenten eine Checkout-Funktion auf

Führen Sie diesen Befehl aus, damit Ihr Agent eine Checkout-Sitzung mit den Beispielprodukten erstellt:

export RESPONSE=$(curl -s -X POST "$SERVER_URL/checkout-sessions" -H 'Content material-Sort: utility/json' -H 'UCP-Agent: profile="https://agent.instance/profile"' -H 'request-signature: check' -H 'idempotency-key: 0b50cc6b-19b2-42cd-afee-6a98e71eea87' -H 'request-id: 6d08ae4b-e7ea-44f4-846f-d7381919d4f2' -d '{"line_items":({"merchandise":{"id":"bouquet_roses","title":"Purple Rose"},"amount":1}),"purchaser":{"full_name":"John Doe","electronic mail":"(electronic mail protected)"},"foreign money":"USD","cost":{"devices":(),"handlers":({"id":"shop_pay","identify":"com.shopify.shop_pay","model":"2026-01-11","spec":"https://shopify.dev/ucp/handlers/shop_pay","config_schema":"https://shopify.dev/ucp/handlers/shop_pay/config.json","instrument_schemas":("https://shopify.dev/ucp/handlers/shop_pay/instrument.json"),"config":{"shop_id":"d124d01c-3386-4c58-bc58-671b705e19ff"}},{"id":"google_pay","identify":"google.pay","model":"2026-01-11","spec":"https://instance.com/spec","config_schema":"https://instance.com/schema","instrument_schemas":("https://ucp.dev/schemas/procuring/varieties/gpay_card_payment_instrument.json"),"config":{"api_version":2,"api_version_minor":0,"merchant_info":{"merchant_name":"Flower Store","merchant_id":"TEST","merchant_origin":"localhost"},"allowed_payment_methods":({"kind":"CARD","parameters":{"allowedAuthMethods":("PAN_ONLY","CRYPTOGRAM_3DS"),"allowedCardNetworks":("VISA","MASTERCARD")},"tokenization_specification":({"kind":"PAYMENT_GATEWAY","parameters":({"gateway":"instance","gatewayMerchantId":"exampleGatewayMerchantId"})})})}},{"id":"mock_payment_handler","identify":"dev.ucp.mock_payment","model":"2026-01-11","spec":"https://ucp.dev/specs/mock","config_schema":"https://ucp.dev/schemas/mock.json","instrument_schemas":("https://ucp.dev/schemas/procuring/varieties/card_payment_instrument.json"),"config":{"supported_tokens":("success_token","fail_token")}})}}') && echo $RESPONSE 

Sobald die Checkout-Sitzung erstellt ist, erhält Ihr Agent Zugriff auf eine vom Server ausgegebene Checkout-ID, die weiter für Aktualisierungen der Checkout-Sitzung verwendet werden kann:

RESPONSE: 
{ 
"ucp": { "model": "2026-01-11", "capabilities": ( { "identify": "dev.ucp.procuring.checkout", "model": "2026-01-11" } ) }, 
"id": "cb9c0fc5-3e81-427c-ae54-83578294daf3", 
"line_items": ( { 
"id": "2e86d63a-a6b8-4b4d-8f41-559f4c6991ea", 
"merchandise": { "id": "bouquet_roses", "title": "Bouquet of Purple Roses", "value": 3500 }, 
"amount": 1, 
"totals": ( { "kind": "subtotal", "quantity": 3500 }, { "kind": "whole", "quantity": 3500 } ) 
} ), 
"purchaser": { "full_name": "John Doe", "electronic mail": "(electronic mail protected)" }, 
"standing": "ready_for_complete", 
"foreign money": "USD", 
"totals": ( { "kind": "subtotal", "quantity": 3500 }, { "kind": "whole", "quantity": 3500 } ), 
"hyperlinks": (), 
"cost": { "handlers": (), "devices": () }, 
"reductions": {} 
} 

Schritt 5: Wenden Sie bei Ihrem Agenten Rabatte auf die Checkout-Anfrage an

Führen Sie diesen Befehl aus, um Ihrem Agenten zu ermöglichen, Rabatte auf die Checkout-Sitzung anzuwenden, indem Sie die Checkout-ID aus dem vorherigen Schritt verwenden:

export CHECKOUT_ID=$(echo $RESPONSE | jq -r '.id') && export LINE_ITEM_1_ID=$(echo $RESPONSE | jq -r '.line_items(0).id') && export RESPONSE=$(curl -s -X PUT "$SERVER_URL/checkout-sessions/$CHECKOUT_ID" -H 'Content material-Sort: utility/json' -H 'UCP-Agent: profile="https://agent.instance/profile"' -H 'request-signature: check' -H 'idempotency-key: b9ecd4b3-0d23-4842-8535-0d55e76e2bad' -H 'request-id: 28e70993-e328-4071-91de-91644dc75221' -d "{"id":"$CHECKOUT_ID","line_items":({"id":"$LINE_ITEM_1_ID","merchandise":{"id":"bouquet_roses","title":"Purple Rose"},"amount":1}),"foreign money":"USD","cost":{"devices":(),"handlers":()},"reductions":{"codes":("10OFF")}}") && echo $RESPONSE | jq 

Ihr Agent erhält die folgende Antwort mit dem angewendeten Rabatt:

RESPONSE:  
{ 
"ucp": { "model": "2026-01-11", "capabilities": ( { "identify": "dev.ucp.procuring.checkout", "model": "2026-01-11" } ) }, 
"id": "cb9c0fc5-3e81-427c-ae54-83578294daf3", 
"line_items": ( { 
"id": "2e86d63a-a6b8-4b4d-8f41-559f4c6991ea", 
"merchandise": { "id": "bouquet_roses", "title": "Bouquet of Purple Roses", "value": 3500 }, 
"amount": 1, 
"totals": ( { "kind": "subtotal", "quantity": 3500 }, { "kind": "whole", "quantity": 3500 } ) } ), 
"purchaser": { "full_name": "John Doe", "electronic mail": "(electronic mail protected)" }, 
"standing": "ready_for_complete", 
"foreign money": "USD", 
"totals": ( { "kind": "subtotal", "quantity": 3500 }, { "kind": "low cost", "quantity": 350 }, { "kind": "whole", "quantity": 3150 } ), 
"hyperlinks": (), 
"cost": { "handlers": (), "devices": () }, 
"reductions": { 
"codes": ( "10OFF" ), 
"utilized": ( { "code": "10OFF", "title": "10% Off", "quantity": 350, "automated": false, "allocations": ( { "path": "subtotal", "quantity": 350 } ) } ) 
} 
} 

Schlüsselkomponenten des Common Commerce Protocol

Ein UCP-Server, der häufig das Händler-Backend ist, stellt einen oder mehrere Dienste offen. Jeder Dienst entspricht spezifischen Fähigkeiten, die sich in Funktionsbereiche wie Produkterkennung oder Checkout unterscheiden lassen. Gängige Beispiele sind ucp.procuring.catalog, ucp.procuring.checkout und ucp.procuring.orders. Händler entscheiden sich für die von ihnen benötigten Funktionen, während die KI-Agenten entsprechend den aktivierten Funktionen mit den Händlern kommunizieren.

Fähigkeiten und Kerndienst

Erweiterungen: Funktionen ermöglichen auch die Verwendung von Erweiterungen zur Bereitstellung spezieller Funktionen. Durch Erweiterungen haben Händler die Möglichkeit, Funktionen wie Coupon-Rabatte oder ausgefeilte Versandmethoden hinzuzufügen, ohne die primären Schemata ändern zu müssen.

Entdeckung

Jedes UCP-fähige Unternehmen stellt ein Manifest unter https:///.well-known/ucp bereit. Hier finden Sie eine Liste der verfügbaren Dienste, unterstützten Funktionen, API-Endpunkte, möglicher Versionen, Erweiterungen und Particulars zu den Zahlungsabwicklern.

Transporte

UCP ist nicht auf einen bestimmten Transport beschränkt. Dieselben Funktionsnutzlasten können über REST, JSON RPC oder agentennative Protokolle wie Mannequin Context Protocol (MCP) und Agent2Agent (A2A) oder sogar nicht native Protokolle übertragen werden.

Zahlungen

UCP ist über seine steckbaren Zahlungsabwickler, darunter Stripe, Google Pay und Store Pay, in verschiedene Zahlungsanbieter integriert. Die Zahlungstokens werden beim Bezahlvorgang verschlüsselt und weitergeleitet.

Zusammengenommen ermöglichen diese Faktoren UCP, KI-Einkaufsdialoge in tatsächliche Transaktionen umzuwandeln. Die normale Transaktion ist wie folgt:

1. Der Agent erhält das UCP-Manifest des Händlers
2. Es bestimmt die relevanten Funktionen (z. B. Kasse)
3. Es ruft diese APIs zusammen mit den Bestelldetails des Käufers auf und wählt einen Zahlungsabwickler aus
4. UCP kümmert sich um alles Weitere (einschließlich der besprochenen Rabatte oder Erfüllungsoptionen).

Vorteile für das Handelsökosystem

• Einzelhändler und Händler: Mit UCP können Händler über KI-gesteuerte Einkaufsoberflächen verkaufen, ohne die Kontrolle über Branding, Daten oder Checkout zu verlieren. Sie bleiben der Service provider of Document und erreichen Nutzer über den KI-Modus der Google-Suche, Chatbots und Sprachassistenten mit einer einzigen Integration.
• KI-Plattformen und Agenten: KI-Plattformen wie Google AI Mode, Gemini und Microsoft Copilot können Handelsfunktionen anbieten, ohne für jeden Einzelhändler individuelle Integrationen erstellen zu müssen. Eine einheitliche API beschleunigt das Händler-Onboarding und ermöglicht skalierbaren, agentengesteuerten Handel.
• Entwickler: UCP ist Open Supply und entwicklerfreundlich, mit klarer Dokumentation, SDKs und Referenzimplementierungen. Entwickler können mit vertrauten Instruments wie REST und JSON erstellen und nur die Funktionen übernehmen, die sie benötigen.
• Zahlungsanbieter: Zahlungsanbieter können mithilfe des modularen, tokenisierten Zahlungsflusses von UCP eine einmalige Integration durchführen und mit vielen Händlern zusammenarbeiten. Dadurch entfällt die Notwendigkeit plattformspezifischer Integrationen.
• Verbraucher: UCP ermöglicht es Benutzern, direkt über KI-Assistenten zu stöbern und einzukaufen, ohne zwischen Apps oder Web sites wechseln zu müssen, wodurch ein schnelleres und nahtloseres Einkaufserlebnis entsteht.

Abschluss

Das Common Commerce Protocol könnte den digitalen Handel im KI-Zeitalter neu gestalten. Es vereint KI-Agenten, Händler und Zahlungen unter einem Normal, behält dabei die Kontrolle des Händlers und ermöglicht nahtloses Einkaufen über Chat, Suche und Sprache. Da KI-Assistenten immer mehr Kaufentscheidungen beeinflussen, zielt UCP darauf ab, den Handel offen, sicher und skalierbar zu halten.

Was halten Sie von Agent-Pushed-Purchasing? Teilen Sie Ihre Gedanken in den Kommentaren unten mit.

Hallo! Ich bin Vipin, ein leidenschaftlicher Fanatic für Datenwissenschaft und maschinelles Lernen mit fundierten Kenntnissen in Datenanalyse, Algorithmen für maschinelles Lernen und Programmierung. Ich verfüge über praktische Erfahrung in der Modellerstellung, der Verwaltung unübersichtlicher Daten und der Lösung realer Probleme. Mein Ziel ist es, datengesteuerte Erkenntnisse anzuwenden, um praktische Lösungen zu schaffen, die zu Ergebnissen führen. Ich bin bestrebt, meine Fähigkeiten in einer kollaborativen Umgebung einzubringen und gleichzeitig weiterhin in den Bereichen Knowledge Science, maschinelles Lernen und NLP zu lernen und mich weiterzuentwickeln.