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:

json
{
  "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.