Universal Commerce Protocol UCP w suwerennym AI OS

Temat: Open Source AI

UCP (Universal Commerce Protocol) to otwarty standard, przez który agent AI przeprowadza zakup u sprzedawcy: od wyszukania produktu w katalogu, przez koszyk i checkout, po status zamówienia. Stan na 6.10.2026 najnowsza wersja specyfikacji to 2026-08-25; UCP numeruje wersje datą wydania (wydania w repozytorium UCP). Projekt ma licencję Apache 2.0. Ten wpis jest dla zespołu sklepu albo platformy, który chce sprawdzić, co trzeba zbudować, żeby agent mógł kupić u nich zgodnie z UCP.

Czym UCP różni się od MCP i A2A, z których korzysta jako z transportu, i kto go współtworzy, wyjaśnia poradnik o MCP i protokołach agentów. Kiedy otwarty stos ma sens, a kiedy lepsza jest chmura vendora, wyjaśnia poradnik o AI OS dla zarządu.

Wersje i dojrzałość części specyfikacji

WersjaCo wniosła (według not wydania)
2026-01-11pierwsze wydanie: zasady zarządzania projektem, poziomy dojrzałości możliwości, zasady wersjonowania
2026-04-08koszyk, wyszukiwanie w katalogu, rozwinięcie checkoutu osadzonego, podstawy łączenia tożsamości przez OAuth 2.0
2026-08-25podział na branże, możliwości dla sklepów spożywczych, uwierzytelnianie płatności 3DS2, rozszerzenie programów lojalnościowych

Nie wszystkie części mają ten sam status. Według strony projektu handel detaliczny (zakupy) jest stabilny, rezerwacje noclegów mają status szkicu, a gastronomia jest dopiero zapowiedziana. Przed wdrożeniem zapisz, którą wersję i które możliwości obsługujesz.

Role i możliwości

Specyfikacja UCP opisuje trzy role:

  • Sprzedawca (Business) publikuje swoje możliwości i obsługiwane metody płatności.
  • Platforma (Platform), czyli agent albo marketplace, inicjuje zakup i negocjuje możliwości.
  • Operator płatności lub poświadczeń (Payment/Credential Provider) zarządza instrumentami płatniczymi i tokenizacją.

Możliwości mają nazwy w odwróconej notacji domenowej, np. dev.ucp.shopping.checkout albo dev.ucp.shopping.fulfillment. Strona projektu wymienia katalog, koszyk, checkout, łączenie tożsamości (OAuth 2.0) i zamówienie ze zmianami statusu przez webhooki. Rozszerzenia, np. raty albo mandaty płatnicze AP2 (Agent Payments Protocol), deklarują, którą możliwość rozszerzają.

Odkrywanie i negocjacja

Sprzedawca publikuje profil pod adresem /.well-known/ucp. Platforma przedstawia się nagłówkiem UCP-Agent z adresem swojego profilu. Potem obie strony negocjują:

  1. Wybierają możliwości, które obsługują obie.
  2. Dla każdej wybierają najwyższą wspólną wersję.
  3. Usuwają rozszerzenia, których możliwość nadrzędna nie przeszła negocjacji, i powtarzają ten krok do skutku.

Profil może zawierać klucze publiczne (keys[] w formacie JWK) do podpisów wiadomości HTTP i podpisanych webhooków. Usługi udostępnia się przez cztery transporty: REST (opis w OpenAPI), MCP, A2A i protokół osadzony EP (Embedded Protocol) dla checkoutu w oknie platformy.

Czego UCP nie załatwia

To standard procesu handlowego, a nie gwarancja konwersji, płatności ani zgodności prawnej. Specyfikacja omawia zakres PCI DSS przy płatnościach, ale obowiązki sklepu wobec konsumenta, regulamin, zwroty i podatki zostają po stronie sprzedawcy. Protokół nie decyduje też, czy agent działa w imieniu klienta z jego zgodą. To trzeba sprawdzić w łączeniu tożsamości i w mandacie płatności.

Alternatywy to własne API sprzedaży, dane strukturalne schema.org i integracje platform sklepów. UCP może zmniejszyć zależność od jednego kanału sprzedaży, jeśli wdrożenie pozostaje przenośne. Wybór powinien wynikać z próby na własnych danych i z możliwości wycofania rozwiązania.

Jak wykorzystać UCP przy kodowaniu z AI

Agent kodujący może przygotować profil, adapter do istniejącego sklepu i testy integracyjne. Człowiek sprawdza ceny, podatki, metody płatności i to, co profil ujawnia publicznie. Agent nie powinien sam zatwierdzać swojej zmiany ani dostać dostępu do produkcyjnych płatności. Agent zakupowy chętnie kupi wszystko, co zgadza się ze schematem, więc testy muszą sprawdzać także to, czego kupić nie powinien.

Próba przed decyzją

  1. Opublikuj profil /.well-known/ucp w środowisku testowym z katalogiem i checkoutem.
  2. Przeprowadź zakup z platformy testowej przez jeden transport, np. MCP.
  3. Zasymuluj platformę ze starszą wersją specyfikacji i sprawdź wynik negocjacji.
  4. Zweryfikuj podpis webhooka zamówienia i odrzuć webhook z błędnym podpisem.
  5. Ponów to samo zamówienie po przerwaniu połączenia. Nie może powstać duplikat.

Zmierz opóźnienie, koszt i zachowanie po błędzie. Jak agenci przekazują sobie zadania poza procesem zakupu, opisuje wpis Agent2Agent A2A w suwerennym AI OS.

Portret Krzysztofa Majchrzyckiego

O autorze

Krzysztof Majchrzycki jest architektem systemów i AI Business Partnerem. Od wielu lat łączy technologię z biznesem i zarządzaniem. Współtworzył firmy technologiczne i kierował polskim oddziałem międzynarodowej grupy. Dziś projektuje modele firm i inteligentne systemy operacyjne, które z nich wynikają. Ukończył Executive MBA i ma certyfikat Prosci® Certified Change Practitioner.

Podłączaj agentów do sprzedaży z odbiorem, nie na próbę

Forward Deployed AI Engineer to kurs w Akademii dla inżyniera, który podłącza agentów do systemów firmy: ustala uprawnienia, buduje integracje i prowadzi ich odbiór. Kurs jest w przygotowaniu — zapisz się na listę oczekujących.