Zapnutie UCP v obchode

So zapnutým UCP nájdu AI asistenti a nákupné platformy katalóg vášho obchodu na vašej vlastnej doméne, zostavia košík a zákazníka pošlú dokončiť nákup do vášho obchodu. Platí sa vždy vo vašom obchode, vašimi spôsobmi platby; cez agenta sa neplatí nič. Čo agent dokáže a čo nie, zhŕňa kapitola Nákup cez AI agentov (UCP).

UCP sa zapína pre každý obchod zvlášť, v nastaveniach obchodu. Kým ho nezapnete, je pre všetky obchody vypnuté.

Čo obchod potrebuje

Nezáleží na dvoch veciach: či obchod beží na klasickom storefronte alebo na Storefront v2 — UCP funguje s oboma — ani na dizajne obchodu. Záleží však na katalógovom režime; pozri Katalógový režim nižšie.

Pripojenie vlastnej domény

Tento krok preskočte, ak obchod už má v karte Vlastné domény doménu označenú DNS overené a SSL aktívne.

1. Otvorte obchod

   Prejdite do E-commerce → Obchody (Otvorí sa v novej karte) a otvorte obchod. Karta Vlastné domény je v dolnej časti stránky.

2. Pridajte doménu

   Kliknite na Pridať doménu, zadajte doménu (napríklad shop.example.com) a kliknite na Pripojiť. Obchod môže mať najviac 5 vlastných domén. Pridať nemožno doménu Monokaida ani doménu, ktorá je už pripojená k inému obchodu.

3. Vytvorte dva DNS záznamy

   Časť Nakonfigurujte DNS záznamy uvádza záznam A Record, ktorý nasmeruje doménu na server Monokaida, a záznam TXT Record s názvom _monokaido-verify., za ktorým nasleduje vaša doména, a s hodnotou monokaido-verify=…. Vytvorte oba u svojho registrátora domén. Karta uvádza ako názov A záznamu @; pre subdoménu, napríklad shop.example.com, ho vytvorte pre túto subdoménu (u väčšiny registrátorov má názov shop). Zmeny môžu trvať až 48 hodín.

4. Skontrolujte DNS

   Kliknite na Skontrolovať DNS konfiguráciu. Kontrola je možná raz za 30 sekúnd. Keď sú oba záznamy správne, doména má stav DNS overené a hlásenie povie, že SSL certifikát bude čoskoro provizionovaný. Inak karta ukáže Overenie zlyhalo aj s dôvodom.

5. Počkajte na certifikát

   SSL certifikát si Monokaido vyžiada samo; úloha beží každé dve minúty. Doména prejde zo stavu SSL čaká cez SSL sa provizionuje... do SSL aktívne. SSL zlyhalo znamená, že certifikát sa nepodarilo vydať; napíšte podpore Monokaida na support@monokaido.com.

6. Zvoľte primárnu doménu

   Ak má obchod viac domén, kliknite pri tej, ktorú majú používať agenti aj zákazníci, na Nastaviť ako primárnu. Primárnou môže byť iba doména s overeným DNS a aktívnym certifikátom. Všetka premávka obchodu je potom presmerovaná na ňu, ako to uvádza karta.

Zapnutie prepínača

1. Otvorte nastavenia obchodu

   V E-commerce → Obchody (Otvorí sa v novej karte) otvorte obchod. Prepínače sú v karte Nastavenia obchodu.

2. Skontrolujte, že je obchod zapnutý

   Obchod povolený musí byť zapnutý. Prepínač UCP sa objaví pod ním (odsadený, za prepínačmi Storefront v2 a katalógového režimu, ak sú zobrazené), keď je obchod zapnutý a má doménu s overeným DNS a aktívnym certifikátom. Ak sa certifikát aktivoval, kým ste mali stránku otvorenú, obnovte ju.

3. Zapnite Nákup cez AI agentov (UCP)

   Prepínač má značku AI. Po zapnutí pole ukáže Profil obchodu pre agentov: s adresou https://shop.example.com/.well-known/ucp (namiesto shop.example.com vaša doména), tlačidlo na skopírovanie a poznámku Agenti ho nájdu po uložení nastavení. Ak obchod nie je Aktívny alebo mu uplynula platnosť, pole namiesto toho ukáže upozornenie — pozri Čo hovorí prepínač.

4. Uložte

   Kliknite na Uložiť zmeny v hornej časti stránky. Kým neuložíte, nič sa nezverejní. Po uložení poznámka zmizne a adresa profilu zostane.

5. Overte

   Otvorte adresu profilu v prehliadači alebo cez curl — pozri Overenie, že UCP funguje.

Čo hovorí prepínač

Kým je prepínač zapnutý, pole pod ním ukazuje, či sa agentom odpovedá pri nastaveniach, ktoré sú práve vo formulári, a ak nie, prečo. Vychádza z formulára, nie z uložených nastavení: keď vypnete Aktívny, upozornenie sa ukáže hneď, hoci agentom sa odpovedá ďalej, až kým neuložíte. Každé hlásenie samo uvádza nápravu.

Hlásenia sa vyhodnocujú v tomto poradí: najprv obchod, potom kľúč, nakoniec doména.

Uloženie sa môže odmietnuť aj s jedným z týchto chybových hlásení — zriedkavo, keď sa obchod alebo jeho domény zmenili po načítaní stránky, napríklad v inej karte:

• UCP sa dá zapnúť iba pri zapnutom vstavanom obchode. — obchod je vypnutý.
• UCP sa dá zapnúť až vtedy, keď je na obchod nasmerovaná vlastná doména s overeným DNS a aktívnym certifikátom. — obchod už takú doménu nemá.

Obnovte stránku: prepínač sa potom zobrazí iba vtedy, keď sa dá zapnúť.

Zapnutie UCP sa overuje iba v okamihu, keď ho prepnete z vypnutého na zapnuté. Keď je raz uložené zapnuté, odstránená doména ani vypnutý obchod nikdy nezablokujú ukladanie ostatných nastavení obchodu; UCP sa len prestane poskytovať, kým príčinu neodstránite.

Overenie, že UCP funguje

curl -si https://shop.example.com/.well-known/ucp

Adresa je presne /.well-known/ucp, bez lomky na konci.

• 200 s JSON a cache-control: public, max-age=300 — UCP je zapnuté. Telo je profil obchodu; celý ho nájdete v kapitole Nákup cez AI agentov (UCP). Jeho endpoint uvádza vašu primárnu doménu.
• 404 s {"code":"not_found","content":"No UCP business on this host"} — táto doména UCP neposkytuje. Odpoveď je zámerne rovnaká z akéhokoľvek dôvodu (UCP vypnuté, obchod vypnutý, kľúč neaktívny alebo mu uplynula platnosť, doména odstránená z obchodu, modul e-shop vypnutý alebo adresa *.shop.monokaido.com). Ktorá z podmienok obchodu chýba, povie hlásenie pod prepínačom. Väčšina zmien sa tu prejaví hneď; certifikát, ktorý sa práve stal aktívnym, alebo dátum Vyprší, ktorý práve nastal, sa prejavia do 30 sekúnd — pozri Ako rýchlo sa zmeny prejavia.
• 503 s {"code":"service_unavailable","content":"This shop is temporarily unavailable"} — firma je deaktivovaná alebo zablokovaná pre nezaplatené predplatné. Tú istú odpoveď môže dať aj krátka porucha na strane Monokaida; skúste to znova o minútu.
• Chyba certifikátu (curl spojenie odmietne) — doména ešte nemá vlastný certifikát: jej DNS ešte nie je overené alebo je jej stav stále SSL čaká, SSL sa provizionuje... či SSL zlyhalo.
• HTML stránka namiesto JSON — adresa nie je presne /.well-known/ucp alebo doména nesmeruje na Monokaido.

Volania katalógu, košíka a checkoutu pod /ucp/v1 potrebujú v každej požiadavke vlastný profil agenta, takže holým príkazom curl sa vyskúšať nedajú. Ako ich vyskúša vývojár, ukazuje Rýchly štart pre vývojárov.

Ktorú doménu agenti používajú

Agenti môžu profil nájsť na ktorejkoľvek doméne obchodu, na ktorej sa UCP poskytuje, ale každá adresa, ktorú obchod zverejňuje — adresa API, odkaz, ktorý kupujúceho privedie do vašej pokladne, odkaz na potvrdenie objednávky aj odkazy na produkty — používa primárnu doménu. Primárnu doménu udržiavajte overenú a s aktívnym certifikátom. Ak taká nie je, každá doména, na ktorej sa UCP poskytuje, zverejňuje svoju vlastnú adresu a na obrazovke je adresa prvej takej domény v zozname.

Čo uvidia zákazníci a agenti

Zákazníci, ktorí si prezerajú váš obchod, nezaznamenajú žiadnu zmenu.

Agenti čítajú to, čo ukazuje váš obchod: tie isté produkty (produkty, ktoré obchod skrýva vylučovacími filtrami, zostanú skryté vo vyhľadávaní a lookupe agenta), tie isté ceny s DPH a s vašimi prirážkami, dostupnosť na sklade, vaše spôsoby dopravy aj s cenou a vaše zľavové kódy, overené tými istými pravidlami. Položka košíka agenta sa však overuje iba voči zverejneným produktom firmy: agent, ktorý už pozná id skrytého produktu, ho do košíka vložiť môže. Právne odkazy, ktoré agent zobrazí pri checkoute, pochádzajú zo Súhlasov v objednávke: ponúkne sa každý aktívny súhlas, ktorého odkaz je úplná adresa https:// (alebo http://) alebo cesta vo vašom obchode (začína /), najviac 10. Ako zásady ochrany osobných údajov sa ponúkne vtedy, keď jeho názov, text odkazu alebo adresa obsahuje, bez ohľadu na veľkosť písmen, niektoré z privacy, gdpr, osobn, súkrom, sukrom, soukrom, adatvédel, adatved, datenschutz alebo ochrana, inak ako obchodné podmienky — preto sa ako zásady ochrany osobných údajov ponúkne aj súhlas s názvom „Ochrana spotrebiteľa“. Obchod bez takých odkazov neponúkne žiadne.

Zákazník, ktorého pošle agent, otvorí odkaz na vašej doméne. Na chvíľu uvidí stránku s názvom vašej firmy; potom sa položky a zľavový kód od agenta pridajú do jeho košíka a otvorí sa vaša pokladňa (stránka košíka, keď agent odovzdal košík). Položky, ktoré už v košíku má, zostanú; položky, ktoré sa už nedajú kúpiť, sa preskočia. Ak má v košíku položky v mene, v ktorej sa položky od agenta nedajú naceniť, nepridá sa nič a otvorí sa košík. Ak je vo vašom obchode prihlásený v tej istej karte prehliadača, položky idú do jeho zákazníckeho košíka, inak do košíka hosťa. Potom vyplní kontaktné údaje, adresu, dopravu a platbu ako ktorýkoľvek zákazník — tieto údaje sa od agenta neprenášajú. Odkaz, ktorého košík alebo checkout agenta už vypršal, bol zrušený alebo už skončil objednávkou, ukáže stránku s názvom vašej firmy a odkazom na úvodnú stránku obchodu.

Objednávka je bežná objednávka vášho obchodu: tie isté e-maily, spôsoby platby, rezervácia skladu aj zoznam objednávok. Nie je označená ako objednávka od agenta.

Štatistika košíkov: ceny každého košíka aj checkoutu agenta počíta košík hosťa vo vašom obchode. Ak naň nikto nesiahne dlhšie než hodinu, ráta sa v štatistike košíkov (pozri Košíky) ako opustený, kým relácia agenta neskončí: kým ju agent nezruší, neodovzdá zákazníkovi alebo kým nevyprší (vypršaná zo štatistiky zmizne do nasledujúcej hodiny).

Katalógový režim

Obchod na Storefront v2 so zapnutým katalógovým režimom nič nepredáva a to isté platí pre agentov. Jeho profil ponúka iba vyhľadávanie v katalógu a čítanie produktov; agenti môžu ukázať vaše produkty a ceny a poslať ľudí na stránky produktov, ale každá požiadavka na košík alebo checkout dostane odpoveď, že nie je podporovaná. Košík alebo checkout agenta, ktorý vznikol pred zapnutím katalógového režimu, sa už použiť nedá a jeho odkaz otvorí iba úvodnú stránku obchodu.

Vypnutie UCP

Vypnite Nákup cez AI agentov (UCP) a kliknite na Uložiť zmeny. Vypnutie je vždy povolené a prepínač zostáva na obrazovke, kým je uložený zapnutý — aj keď medzitým zmizla doména alebo sa vypol obchod —, takže sa dá vždy vypnúť.

Čo sa potom stane:

• Profil aj celé API pre agentov odpovedajú 404 na všetkých doménach obchodu.
• Platformy si váš profil môžu ponechať v cache až 5 minút; ich volania v tom čase tiež dostanú 404.
• Otvorené košíky a checkouty agentov zostanú uložené, ale už sa k nim nedá dostať. Odkaz, ktorý agent už dal zákazníkovi, otvorí prázdnu stránku. Košíky vypršia 7 dní a checkouty 24 hodín po poslednej zmene agentom; uložené údaje sa zmažú o 30 dní neskôr. Ak UCP znova zapnete skôr, než vypršia, agenti v nich môžu pokračovať.
• Objednávok, ktoré už vznikli, sa to nedotkne.

UCP sa zastaví aj samo, hoci je prepínač zapnutý: keď doménu odstránite alebo jej certifikát prestane byť aktívny, keď vypnete Obchod povolený, keď obchod deaktivujete alebo mu uplynie platnosť, keď sa vypne modul e-shop alebo keď je firma deaktivovaná či zablokovaná pre nezaplatené predplatné. Keďže prepínač zostáva uložený zapnutý, UCP sa po odstránení príčiny spustí samo.

Ako rýchlo sa zmeny prejavia

Časté problémy