Universal Commerce Protocol (UCP) to otwarty standard agentycznego handlu ogłoszony przez Google w styczniu 2026 roku. Jego cel jest prosty: pozwolić agentom AI — takim jak Google Gemini, ChatGPT czy Copilot — przeprowadzać zakupy bezpośrednio w sklepach internetowych, bez wchodzenia na stronę i bez klikania przez człowieka. Merchant podłącza się raz do protokołu i staje się dostępny dla wszystkich agentów, które go obsługują.
Dla właścicieli sklepów na WooCommerce oznacza to jedno konkretne pytanie: co trzeba zrobić, żeby mój sklep był widoczny i operowalny dla agentów AI?
W tym artykule przejdziemy przez to krok po kroku — od podstaw po bardziej zaawansowane scenariusze.
Dlaczego domyślny WooCommerce nie wystarczy
WooCommerce w standardowej konfiguracji serwuje dane jako HTML — strony zaprojektowane dla przeglądarki i ludzkiego oka. Agent AI tego nie „czyta” tak jak człowiek. Nie widzi layoutu, nie rozumie kompozycji strony, nie wyciąga sensu z wizualnej hierarchii.
Żeby przeprowadzić zakup, agent potrzebuje danych w ustrukturyzowanej, jednoznacznej formie: aktualnej ceny, stanu magazynowego, dostępnych wariantów, opcji dostawy, polityki zwrotów. Musi wiedzieć, czy produkt jest dostępny w tej chwili — nie na podstawie tekstu „W magazynie”, ale na podstawie pola z wartością liczbową.
UCP to właśnie ta dodatkowa warstwa — dedykowane API, które wystawia dane sklepu w formacie czytelnym maszynowo i umożliwia agentowi przeprowadzenie pełnej transakcji.
Bez tej warstwy sklep może nadal pojawiać się w statycznych listach produktów w AI Mode Google, ale zawodzi na etapie wykonania: agent nie jest w stanie kupić nic w imieniu użytkownika. A to właśnie zakupy agentyczne — nie tylko rekomendacje — są tym, co UCP wprowadza jako nowy kanał sprzedaży.
Najprostszy start: wtyczka UCP
Dla większości sklepów WooCommerce najszybszą drogą do zgodności z UCP jest wtyczka UCP for WooCommerce, dostępna za darmo na oficjalnym repozytorium WordPress.org.
Po instalacji i aktywacji wtyczka automatycznie tworzy endpoint /.well-known/ucp na domenie sklepu. To właśnie ten adres odpytuje agent AI jako pierwszy krok — żeby sprawdzić, jakie możliwości sklep obsługuje. Wtyczka wypełnia go danymi na podstawie aktywnej konfiguracji WooCommerce: dostępnych metod wysyłki, stref dostawczych, obsługiwanych bramek płatniczych.
Poza profilem sklepu wtyczka obsługuje kilka kluczowych funkcji:
AI-optimized catalog — produkty są serwowane z metadanymi zoptymalizowanymi pod agenta, włącznie z opcją dodania tzw. Quick Facts i FAQ bezpośrednio do karty produktu. To nie wpływa na widok dla klientów, ale wzbogaca dane dostępne dla agentów.
Checkout sessions — wtyczka tworzy i obsługuje sesje checkout inicjowane przez agenta, korzystając ze standardowej logiki WooCommerce: te same reguły podatkowe, te same strefy wysyłki, te same bramki płatnicze.
Obsługa kodów rabatowych — agent może zastosować kupon podczas sesji, dokładnie tak jak robiłby to ludzki kupujący.
OAuth 2.0 Identity Linking — kupujący zalogowany na platformie AI może uzyskać te same korzyści lojalnościowe, co gdyby był zalogowany bezpośrednio na stronie sklepu.
Multi-transport — wtyczka obsługuje REST API, MCP (Model Context Protocol) i Embedded Protocol, co oznacza kompatybilność z różnymi typami agentów.
Ważna informacja techniczna: wtyczka korzysta z zewnętrznych schematów JSON z ucp.dev — centralnego repozytorium specyfikacji protokołu. Schematy są dołączane do odpowiedzi API, żeby agenty wiedziały jak parsować dane. Do serwera ucp.dev nie są wysyłane żadne dane klientów ani dane sklepu — to czysto statyczny hosting schematów.
Jak wygląda zakup od strony agenta
Żeby lepiej zrozumieć, co dzieje się po wdrożeniu UCP, warto prześledzić ścieżkę zakupową z perspektywy agenta.
Użytkownik pyta Gemini: „Kup mi lekką walizkę kabinową do 150 zł z dostawą do Krakowa.” Agent przeszukuje dostępnych merchantów obsługujących UCP, odnajduje sklep, odpytuje endpoint /.well-known/ucp i sprawdza, czy sklep obsługuje checkout i dostawę do podanego adresu. Odpowiedź wygląda mniej więcej tak:
{
"ucp.version": "2026-01-11",
"capabilities": ["checkout", "fulfillment", "discount"],
"payment.handlers": ["google_pay", "stripe"]
}
Możliwości się pokrywają — agent kontynuuje. Pobiera dane produktu w czasie rzeczywistym: cenę, warianty, dostępność. Tworzy sesję checkout z wybranym produktem, adresem dostawy i metodą płatności. Jeśli wszystkie dane są kompletne, sesja przechodzi do statusu ready_for_complete i agent finalizuje zamówienie. WooCommerce tworzy zamówienie dokładnie tak samo jak przy zwykłym zakupie przez stronę — ta sama baza, ten sam fulfillment, to samo powiadomienie e-mail do klienta.
Jeśli na którymś etapie sklep wymaga decyzji użytkownika — na przykład przy wyborze konkretnego terminu dostawy — sesja przechodzi do statusu requires_escalation. Agent przekazuje sterowanie użytkownikowi wraz z linkiem continue_url, który przenosi go dokładnie do miejsca, gdzie agent skończył. Transakcja nie przepada.
Co UCP widzi w Twoim sklepie — i skąd bierze dane
Jeden z najważniejszych aspektów UCP z punktu widzenia merchantów: agent zawsze widzi dane z aktywnej konfiguracji WooCommerce, w czasie rzeczywistym.
To znaczy, że jeśli produkt jest dostępny w tej chwili — agent to widzi. Jeśli stock wynosi zero — agent to widzi i nie przeprowadzi zakupu produktu, którego nie ma. Jeśli zmieniłeś cenę albo dodałeś nową strefę wysyłki — zmiana jest natychmiast widoczna bez żadnej dodatkowej synchronizacji.
Z tego wynika też ważna kwestia jakości danych: to, co agent może powiedzieć użytkownikowi o Twoim produkcie, zależy bezpośrednio od tego, jak dobrze uzupełnione masz dane w WooCommerce. Niekompletne opisy, brakujące atrybuty, brak informacji o materiale czy wymiarach — to wszystko przekłada się na gorszą pozycję w rekomendacjach agentów, bo agent nie może zweryfikować dopasowania produktu do potrzeb użytkownika.
Pułapki i na co uważać
Wdrożenie UCP przez wtyczkę jest stosunkowo proste, ale kilka rzeczy może sprawić kłopoty.
Konflikty z innymi wtyczkami to najczęstszy problem. WooCommerce ma ogromny ekosystem rozszerzeń i część z nich modyfikuje dane produktów, ceny albo logikę podatkową w sposób, który nie jest widoczny przez REST API. Jeśli używasz wtyczki zmieniającej ceny w zależności od roli użytkownika, dynamicznych rabatów grupowych albo niestandardowej logiki podatkowej — sprawdź, czy te zmiany są dostępne przez standardowe endpointy WooCommerce. Jeśli nie, agent będzie widział inne ceny niż rzeczywiste.
Cache to drugi potencjalny problem. Jeśli serwujesz odpowiedzi API z agresywnym cache’owaniem, agent może otrzymać nieaktualne dane o stanie magazynowym albo cenie. Endpointy UCP powinny zwracać dane zawsze świeże — bez cache’u albo z bardzo krótkim TTL.
Pluginy modyfikujące checkout — wszelkie rozszerzenia, które dodają niestandardowe pola w procesie zakupu (np. „data urodzenia”, „wiadomość do sprzedającego”), mogą powodować, że agent nie będzie w stanie samodzielnie dokończyć transakcji. W takich przypadkach sesja zostaje oznaczona jako requires_escalation, co jest poprawnym zachowaniem — ale warto wiedzieć, że tak się stanie.
Brak konta w Merchant Center — żeby Twoje produkty pojawiały się w Google AI Mode i Gemini Shopping jako „gotowe do zakupu przez agenta”, potrzebujesz aktywnego konta w Google Merchant Center z feedem produktowym. Sam endpoint UCP to za mało. Merchant Center jest bramą wejściową do ekosystemu Google.
Kiedy warto myśleć o wdrożeniu bardziej zaawansowanym
Wtyczka UCP wystarczy dla większości małych i średnich sklepów. Ale przy dużym ruchu, bardzo rozbudowanym katalogu albo potrzebie najwyższej wydajności warto wiedzieć, że istnieją bardziej zaawansowane podejścia.
Endpointy UCP są odpytywane przez agentów z bardzo niską tolerancją na opóźnienia — specyfikacja mówi o celu poniżej 50ms. Standardowy WordPress ze wszystkimi hookami i logiką motywu ładującą się przy każdym żądaniu może tego nie osiągnąć przy dużym ruchu.
Rozwiązaniem jest wtedy architektura headless z dedykowaną warstwą UCP wystawioną na edge — na przykład jako Cloudflare Workers albo Vercel Edge Functions. Warstwa ta obsługuje wyłącznie zapytania agentów: szybko, bez narzutu całego stosu WordPress. Sklep WooCommerce zostaje po stronie backendowej i nadal realizuje zamówienia, ale nie jest bezpośrednio odpytywany przez każdego agenta.
Dla sklepów B2B warto też wiedzieć, że UCP obsługuje negocjację cen hurtowych i rabatów wolumenowych. Agent może wynegocjować z systemem warunki zakupu na podstawie opublikowanych progów cenowych — bez angażowania handlowca po stronie merchantu.
Podsumowanie: co zrobić teraz
Jeśli prowadzisz sklep na WooCommerce i chcesz być dostępny dla agentów AI, lista działań jest stosunkowo krótka.
Po pierwsze — zainstaluj wtyczkę UCP Ready z WordPress.org i sprawdź, czy endpoint /.well-known/ucp zwraca poprawne dane.
Po drugie — uzupełnij dane produktowe. Agent AI rekomenduje i kupuje tylko to, co potrafi zweryfikować. Kompletne atrybuty, aktualne stany magazynowe, jasne polityki zwrotów i dostaw — to jest teraz nie tylko kwestia konwersji, ale kwestia widoczności w ekosystemie agentycznym.
Po trzecie — zadbaj o aktywne konto w Google Merchant Center z poprawnym feedem. To warunek pojawienia się w Google AI Mode i Gemini.
Po czwarte — sprawdź, które wtyczki modyfikują ceny, podatki albo checkout i zweryfikuj, czy ich efekty są widoczne przez REST API WooCommerce.
UCP jest protokołem nowym — ogłoszonym w styczniu 2026 — i ekosystem wokół niego dopiero dojrzewa. Ale kierunek jest wyraźny: sklepy, które będą gotowe wcześniej, zyskują obecność w kanale, który dopiero się otwiera. A wdrożenie przez wtyczkę na WooCommerce nie jest dziś projektem wielomiesięcznym — to kilka godzin konfiguracji i solidne uzupełnienie danych.
O tym, jak UCP działa od strony protokołu i co dzieje się technicznie w transakcji agentycznej, znajdziesz w osobnym tekście w dziale AI.







