Komponowalne elementy
Checkout agentowy, koszyk i feed, płatność delegowana, uwierzytelnianie delegowane oraz webhooki zamówień są zdefiniowane osobno — wdrażamy te, których potrzebuje sprzedawca.[4]
Interfejs, który publikujemy dla maszyn.
Większość sklepów liczy, że AI je zeskrobie. My publikujemy kontrakt: katalog, o który agent może zapytać, koszyk, który agent może domknąć, i politykę indeksowania, która mówi „tak”, a nie „może”.
Interfejs
Pięć powierzchni czytelnych dla maszyn
| Powierzchnia | Ścieżka | Format | Cel |
|---|---|---|---|
| Serwer MCP | /mcp | Model Context Protocol | Narzędzia do wyszukiwania, szczegółów produktu, stanów, obietnicy dostawy i konfiguracji. Tylko do odczytu, o ile uwierzytelniona sesja nie przyzna więcej. |
| Checkout ACP | /.well-known/acp.json | JSON + REST | Deklaruje endpoint koszyka, możliwości, obsługiwane płatności, opcje dostawy i politykę wydatków per agent. |
| Indeks dla LLM | /llms.txt, /llms-full.txt | Markdown | Kuratowana mapa i pełnotekstowe lustro tej strony, aby model czytał prozę, a nie parsował układ.[1] |
| Dane strukturalne | każda strona | JSON-LD (schema.org) | Organization, WebSite, SoftwareApplication, Offer, FAQPage i BreadcrumbList, z realnymi cenami i realną dostępnością. |
| Punkt danych | /data/market-data.json | JSON | Te same źródłowane dane rynkowe, które czyta człowiek, z przypisanym źródłem i statusem weryfikacji w każdym rekordzie. |
Agentic Commerce Protocol
Dlaczego ACP, a nie własna integracja
ACP został opublikowany 29 września 2025 r. przez OpenAI i Stripe, z Meta jako kolejnym współopiekunem, na licencji Apache-2.0.[2][3] Zakład na zamknięty format czyniłby z każdej przyszłej integracji negocjację. Zakład na otwarty czyni z niej konfigurację.
Merchantem of record pozostajesz Ty
Sprzedawca zachowuje relację z klientem w realizacji, zwrotach i wsparciu. Agent jest kanałem, nie sklepem.
Dane uwierzytelniające nie wędrują
Dane płatnicze przekazywane są jako tokeny o zawężonym zakresie, a nie ujawniane agentowi. Zatwierdzenie następuje w aplikacji bankowej klienta.
REST albo MCP, do wyboru
Specyfikacja pozwala publikować konfigurację checkoutu przez klasyczne API albo serwer MCP, więc adopcja nie narzuca Ci stacku.[3]
Polityka indeksowania
Wpuszczamy roboty AI i mówimy o tym w pliku
robots.txt, który po cichu blokuje asystentów używanych przez Twoich klientów, jest decyzją biznesową przebraną za domyślną konfigurację techniczną. Nasza polityka jest jawna, czytelna dla maszyn i hojna — z jedną linią odcięcia wokół masowego odsprezedawania.
# --- Wyszukiwarki odpowiedzi AI: dozwolone, z atrybucją ---
User-agent: GPTBot
User-agent: OAI-SearchBot
User-agent: ChatGPT-User
User-agent: ClaudeBot
User-agent: Claude-User
User-agent: PerplexityBot
User-agent: Google-Extended
User-agent: Applebot-Extended
User-agent: CCBot
Allow: /
# --- Masowe zbieranie zbiorów danych: niedozwolone ---
User-agent: Bytespider
Disallow: /
Sitemap: https://swiftshop.pl/sitemap.xml
# Indeks dla LLM: https://swiftshop.pl/llms.txt
Content-Signal: search=yes, ai-input=yes, ai-train=noTo rozróżnienie ma znaczenie. ai-input=yes oznacza, że wolno pobrać nasze strony, aby odpowiedzieć użytkownikowi tu i teraz. ai-train=no oznacza, że treść nie jest darowizną na wolumen treningowy. To dwa różne pytania i zasługują na dwie różne odpowiedzi.
- Każda strona ma bliźniaka w Markdown pod tą samą ścieżką z rozszerzeniem
.md. - Każda strona deklaruje tego bliźniaka przez
<link rel="alternate" type="text/markdown">. - Ceny, stany i obietnice dostawy są serwowane jako dane, więc agent nigdy nie zgaduje z wyrenderowanych pikseli.
- Cała treść jest w początkowej odpowiedzi HTML — do jej odczytania nie trzeba wykonywać JavaScriptu.
Zabezpieczenia
Czego agentowi nie wolno
| Kontrola | Domyślnie | Dlaczego |
|---|---|---|
| Limit wydatku bez zgody człowieka | 2 000 zł | Powyżej tej kwoty sesja się zatrzymuje i prosi klienta o zatwierdzenie w aplikacji bankowej. |
| Dostęp do metod płatności | Wyłącznie tokeny | Surowe dane karty lub BLIKA nigdy nie są udostępniane agentowi. |
| Prawo zapisu do katalogu | Brak | Agenci czytają i transaguą. Nie zmieniają cen, stanów ani treści. |
| Anulowanie zamówienia | Klient lub sprzedawca | Działania nieodwracalne pozostają po stronie odpowiedzialnego podmiotu. |
| Dane przekazywane na zamówienie | Minimum konieczne | Tylko to, co potrzebne do realizacji, nic do profilowania. |
| Termin na zwrot | 14 dni | Ustawowe prawo odstąpienia konsumenta, stosowane jednolicie. |
Buduj z nami
Integracja agenta ze SwiftShop
Dostęp do specyfikacji dla integratorów
Manifest narzędzi MCP i schemat polityki ACP są dostępne dla partnerów projektowych na tych samych otwartych zasadach, na jakich sami wydajemy.
Źródła cytowane na tej stronie
Każda z powyższych wartości pochodzi ze źródeł wymienionych poniżej. Rejestr czytelny dla maszyn znajduje się pod /data/market-data.json.
- llmstxt.org. The /llms.txt proposal — a Markdown convention for LLM-friendly sites —
- OpenAI. Buy it in ChatGPT: Instant Checkout and the Agentic Commerce Protocol —
- Agentic Commerce Protocol. An open standard for programmatic commerce flows (Apache-2.0) —
- Stripe. Agentic Commerce Protocol — integration documentation —