Jak vytvořit AI nákupního asistenta pro Shopify

Shopify AI shopping assistant pomáhá návštěvníkovi popsat, co potřebuje, prohledá katalog a vysvětlí malou sadu odpovídajících produktů. V tomto návodu vytvoříš asistenta, který se ptá na jezdecké preference, porovnává snowboardy v rámci rozpočtu a kontroluje požadovanou barvu nebo velikost, než něco prohlásí o dostupnosti.

Příkladem je Quickboards, fiktivní obchod se snowboardy. Jeho agenta jsme vytvořili v lokálně spuštěné Quickchat AI App, připojili jsme ho ke skutečnému ukázkovému katalogu Shopify a níže jsme zaznamenali konverzace. Produktové karty obsahují skutečné obrázky z katalogu a demo ceny. Alpská grafika je redakční ilustrace vygenerovaná AI, ne další produkt k prodeji.

Naučíš se také kontrolovat nástroje za odpovědí, testovat asistenta dávkově a volitelně sledovat košík až do AI-Assisted Revenue. Příklad atribuce používá jasně označenou lokální ukázkovou objednávku, ne skutečný prodej.

Hotovým výsledkem je samostatná stránka vyhledávače produktů s inline konverzací:

Lokálně spuštěná demo stránka používá skutečný Quickchat AI Embed a živý katalog Shopify. Není to screenshot publikovaného Shopify theme. Bližší pohled na doporučení je v sekci testování.

Důležitá kontrola přichází po úspěšném připojení. Náš katalog v popisu zmiňoval délky 144–160 cm, ale nevystavoval volitelnou možnost Size. Test varianty ukazuje, jak agent tuto mezeru řeší, aniž by sliboval prkno 156 cm.

Co vytvoříš a co potřebuješ?

Vytvoříš konverzační vyhledávač produktů, který sbírá tři užitečné preference, ukazuje nejvýše dvě doporučení a dovolí nakupujícímu výběr upřesnit.

Jde o konkrétní implementaci chatbota pro doporučování produktů. Podporuje zadání typu „středně pokročilý jezdec, upravené sjezdovky, maximum $800“ i návštěvníka, který potřebuje s formulací těchto preferencí pomoct. Nevyžaduje, aby každý návštěvník vyplnil stejný dotazník.

Než začneš:

1. Vytvoř si účet Quickchat AI, nebo použij existující. Free zahrnuje přístup k MCP a 50 měsíčních AI kreditů pro osobní, nekomerční testování. Konverzace a Simulation testy spotřebovávají kredity. Pro nasazení u obchodníka zvol plán pro komerční použití.
2. Připrav si kořenovou URL svého obchodu Shopify, například https://your-store.myshopify.com. Pokud chceš reprodukovat naše testy specifické pro katalog, použij https://quickchat-ai.myshopify.com, ukázkový obchod Quickchat AI. Jeho demo data se mohou měnit; před porovnáváním cen zkontroluj aktuální výsledky.
3. Pro nasazení měj oprávnění upravovat web nebo Shopify theme. Theme se sekcí Custom Liquid, například Dawn, může hostovat inline snippet. Můžeš také použít kompletní šablonu samostatné stránky.

Začni vyhledávačem jen pro porovnání v krocích 1–7. Volitelné sekce potom přidají vytvoření košíku, atribuci objednávky a komunikační kanály. Agent nikdy nepřijímá platbu ani nerezervuje sklad; nakupující dokončí případný nákup v Shopify checkout.

Už porovnáváš různé Shopify aplikace? Naše srovnání Shopify AI chatbotů pokrývá toto rozhodnutí. Tento návod se zaměřuje na vytvoření a testování workflow pro hledání produktů.

Jak asistent vybírá produkty ze Shopify?

Agent kombinuje preference nakupujícího s produktovými daty vrácenými Shopify a potom v konverzaci vysvětlí užší výběr.

Nakupující dodává omezení. Shopify dodává produktová fakta. Model rozhoduje, kteří vrácení kandidáti odpovídají a jak je vysvětlit.

Shopify MCP je propojení mezi agentem a nástroji, které obchod zveřejňuje. MCP znamená Model Context Protocol. Zadáš URL obchodu; Quickchat AI zajistí discovery nástrojů a katalogové požadavky. V tomto postupu nevkládáš žádnou vlastní REST akci, tělo požadavku ani klíč Shopify Admin API.

Toto rozdělení je při testování důležité:

Výsledek hledání je kandidát. Stále může jít o špatnou kategorii nebo slabou shodu. Stejně tak existence produktu v katalogu nedokazuje, že je dostupná každá kombinace barvy a velikosti.

Shopify dokumentuje rozhraní katalogového nástroje ve své příručce Storefront Catalog MCP. Více detailů o problémech produktových dat za touto integrací najdeš v našich inženýrských poznámkách k Shopify MCP.

Jak vytvoříš nákupního asistenta?

Vytvoř agenta ručně, dej mu úkol vyhledávat produkty a nenechávej ceny produktů v jeho Knowledge Base.

Krok 1. Dokonči úvodní nastavení

1. Zaregistruj se přes Google nebo e-mail. Pokud použiješ e-mail, před přihlášením postupuj podle ověřovacího e-mailu.
2. Na obrazovce úvodního nastavení zvol Set up manually.
3. V Identity zadej Quickboards Guide do Name your AI Agent. Do Describe what you want your agent to do zadej:

Jsi Quickboards Guide, nákupní asistent pro Quickboards, ukázkový obchod se snowboardy. Pomáhej návštěvníkům najít snowboard, který odpovídá jejich ježdění a rozpočtu. Pro produkty a ceny používej připojený katalog Shopify. Pokládej užitečné doplňující otázky, stručně vysvětluj doporučení a zobrazuj produktové karty. Buď stručný a přátelský. Toto je konverzace vyhledávače produktů: porovnávej produkty a kontroluj detaily, ale nevytvářej ani neměň košík a nezačínej checkout. Nevymýšlej si produktové specifikace, dostupnost ani zásady.

4. Klikni na Next. V Knowledge Base nech možnosti importu pro tento příklad jen s katalogem prázdné a klikni na Next.
5. V External apps vyber Shopify a potom Next. Tím zaznamenáš integraci, kterou chceš; skutečné připojení přijde v kroku 2.
6. V Deployment vyber Chat embed a potom Next. Zatím se nic nepublikuje.
7. V Choose your plan zvol Skip for now a pokračuj na Free. Pokud se objeví dialog s nabídkou, zavři ho a znovu zvol Skip for now.

U existujícího agenta přejdi přímo do Identity → AI Persona. Nastav Name na Quickboards Guide. Pole Main Prompt je místo, kam v kroku 3 vložíš otestované instrukce.

Na stejné kartě AI Persona nastav Personality na Friendly, Profession na Shopping Assistant, Creativity na Low a Reply Length na Normal, aby nastavení odpovídalo tomuto demu.

Začni v Identity v levém postranním panelu. AI Persona obsahuje nastavení pro tento postup; detail níže ukazuje pole k úpravě.

Dashboard nazývá pole s instrukcemi Main Prompt. Otevři jeho ovládací prvek Edit, abys nahradil úvodní popis; změny se ukládají automaticky.

Později můžeš do Knowledge Base přidat ověřené zásady dopravy nebo vrácení. Náš návod k nastavení Knowledge Base vysvětluje, jak tento obsah uspořádat. Tento příklad zásady vynechává, aby existoval jeden jasný zdroj pro ceny produktů, možnosti a dostupnost: připojený katalog. Neudržuj druhý ceník v promptu.

Krok 2. Připoj a aktivuj Shopify MCP

1. Otevři Actions & MCPs.
2. Pod Custom Actions zvol Add Action a potom Shopify MCP.
3. Do Shopify store URL zadej kořenovou URL:

https://quickchat-ai.myshopify.com

4. Zvol Save. Připojení se před uložením zkontroluje.
5. Zapni přepínač na kartě Shopify Storefront MCP. Uložení přes tento dialog a aktivace akce jsou samostatné kroky.

Najdi Shopify Storefront MCP pod Custom Actions. Jeho přepínač řídí, jestli agent může připojení používat.

Vlož kořenovou URL obchodu do Shopify store URL. Nepřidávej MCP endpoint ani cestu k produktu.

Pokud už agent Shopify akci má, použij Edit Action na dané kartě místo vytvoření dalšího připojení. Dokumentace nasazení Shopify popisuje také samostatnou cestu instalace Shopify aplikace. Instalace této aplikace není pro ruční MCP připojení použité zde potřeba.

Pro první kontrolu připojení otevři AI Preview a zeptej se:

Zkontroluj prosím, jestli je snowboard Iron v barvě Ice dostupný k objednání a kolik stojí. Nepřidávej ho do košíku.

V den našeho testu byla vrácená varianta dostupná za $699.95 USD. Pro vlastní obchod nahraď produkt a možnost položkou, jejíž aktuální hodnotu umíš ověřit. Úspěšné připojení je nezbytné, ale tato jedna odpověď nevaliduje celý vyhledávač.

Krok 3. Vlož kompletní Main Prompt

Otevři Identity → AI Persona → Main Prompt → Edit, nahraď úvodní popis následujícím blokem a po automatickém uložení editor zavři. Toto je prompt použitý pro finální testy. Pro jinou kategorii nahraď identitu obchodu a otázky na preference společně; ponech pravidla uzemnění v katalogu a chybějící shody.

Jsi Quickboards Guide, nákupní asistent pro Quickboards, ukázkový obchod se snowboardy. Pomáhej návštěvníkovi zúžit katalog na jedno nebo dvě vhodná prkna a pochopit kompromisy. Udržuj konverzaci stručnou, přátelskou a konkrétní. Začni užitečnou otázkou nebo produktovým faktem, bez pochval a výplně.

Sbírej jen preference, na kterých záleží:
- U širokého požadavku jako "pomoz mi vybrat snowboard" pokládej vždy jednu krátkou otázku. Zjisti úroveň ježdění, obvyklý terén a maximální rozpočet pouze na prkno včetně měny. Neprohledávej katalog ani nezobrazuj produktové karty, dokud tyto tři údaje nejsou známé.
- Znovu používej fakta, která už byla uvedena. Pokud návštěvník poskytne všechny tři údaje v jedné zprávě, přejdi rovnou k hledání. Neměň konverzaci v pevný dotazník.
- Na preferenci jako barva se ptej jen tehdy, když by změnila užší výběr. Neptej se na výšku ani váhu, pokud katalog neobsahuje použitelný sizing guide. Nikdy neodvozuj délku prkna jen z tělesných rozměrů.

Najdi a vysvětli malý užší výběr:
- Dotazuj připojený katalog Shopify na aktuální produkty a ceny. Nepoužívej Knowledge Base, předchozí konverzace ani vlastní paměť jako zdroj cen, možností nebo dostupnosti.
- Výsledky hledání jsou kandidáti, ne automatická doporučení. Kontroluj kategorii produktu, popis a aktuální cenu vůči každému uvedenému požadavku. Nikdy neukazuj nesouvisející produkt jen proto, že ho hledání vrátilo.
- Ukazuj nejvýše dva odpovídající produkty. Pokud vyhovuje jen jeden, ukaž jeden. U každého uveď název produktu, aktuální cenu a měnu a vysvětli jeden relevantní důvod založený na vráceném popisu. Vysvětlení užšího výběru drž pod 90 slovy. Kompromis zmiň jen tehdy, když ho vrácená fakta podporují; nižší cena sama o sobě neznamená, že je prkno tolerantní nebo vhodné pro začátečníky.
- Pro stejný užší výběr používej produktové karty. Nezobrazuj další produkty jako kontext a nevyplňuj odpověď celým katalogem.
- Neoznačuj produkt za "nejlepší", neslibuj výkon a neuváděj přesnou technickou specifikaci, pokud ji vrácená data nepodporují. Neopakuj přehnaný marketingový text jako měřené tvrzení.

Ověř požadovanou variantu:
- Když se návštěvník ptá na konkrétní barvu, velikost nebo jinou možnost, zkontroluj aktuální odpověď katalogu pro přesnou variantu. Pokud odpověď neobsahuje všechny požadované hodnoty možností a dostupnost této varianty, použij nástroj detailu produktu k prohlédnutí produktu a vybrané kombinace. Nikdy neodvozuj dostupnost jen z názvu nebo popisu produktu.
- Hodnoty uvedené samostatně v seznamech možností nedokazují, že jejich kombinace je dostupná. Zkontroluj přesnou vrácenou variantu a její dostupnost.
- Rozsah velikostí v popisu není volitelná velikost. Pokud katalog má Color, ale nemá možnost Size, řekni, že můžeš zkontrolovat barvu, ale neumíš potvrdit konkrétní délku. Neslibuj požadovanou velikost a netvrď, že na stránce produktu existuje výběr velikosti.
- Neslibuj, že jiný produkt má chybějící možnost, pokud jsi ho nezkontroloval. Nabídni kontrolu alternativ bez předpokládání výsledku.
- U zkontrolované varianty uveď aktuální cenu a měnu. Interní product IDs, variant IDs a surová data nástrojů neuváděj v odpovědi pro zákazníka.

Zpracuj změny a chybějící shody:
- Pokud návštěvník změní rozpočet, terén, úroveň nebo jiný požadavek, znovu dotazuj katalog s aktualizovanými požadavky. Nahraď dřívější užší výběr; nepokračuj v doporučování produktu přes nový rozpočet.
- Pokud hledání nevrátí nic vhodného, zkus jednou jednodušší dotaz nebo synonymum. Pokud ani jedna sada výsledků neobsahuje shodu, řekni "V tomto katalogu jsem nenašel odpovídající produkt." Netvrď, že prázdné nebo nerelevantní hledání dokazuje, že obchod danou kategorii nikdy neprodává.
- Zeptej se, který jeden požadavek je návštěvník ochoten uvolnit. Neuvolňuj potichu rozpočet, velikost, kategorii ani dostupnost. Nezobrazuj produktové karty, když neexistuje vhodná shoda.
- Pokud připojení selže, řekni, že živý katalog nešlo zkontrolovat, a nabídni opakování. Nikdy mezeru nevyplňuj odhadnutým produktem nebo cenou.

Tato zkušenost je vyhledávač produktů. Jen porovnávej produkty a kontroluj detaily. Nevytvářej ani neměň košík, nezačínej checkout, nepřijímej platbu a netvrď, že položka je rezervovaná. Odpovídej jazykem návštěvníka. Používej krátké odstavce a nepoužívej em dash ani en dash.

Tato pravidla vedou chování modelu. Nejsou tvrdým limitem karet, validátorem počtu slov ani hranicí oprávnění. V našich testech se přesné znění a délka odpovědi lišily. Níže uvedené kontroly produktů a variant jsou důležitější než reprodukce konkrétní věty. Pro samostatnou vlastní REST akci, která zapisuje do tvých systémů, náš návod spolehlivosti AI Action vysvětluje serverové podmínky. Tyto ovládací prvky vlastních akcí nejsou nastaveními nativní Shopify karty použité zde.

Jak testovat doporučení produktů před spuštěním?

Testuj konverzaci dvěma způsoby: interaktivně pro navazující otázky a v Simulation Testing pro opakovatelnou sadu nezávislých požadavků.

Dávkové skóre pomáhá prioritizovat kontrolu. Smyčka se uzavře až po kontrole skutečné odpovědi, katalogových faktů a relevantních volání nástrojů.

Krok 4. Spusť kompletní nákupní konverzaci

V AI Preview začni novou konverzaci a pošli:

Pomoz mi vybrat snowboard.

Agent by se měl zeptat na jednu užitečnou otázku a neukazovat žádné produktové karty. V zaznamenaném běhu s finálním promptem se zeptal:

Jaká je tvoje aktuální úroveň ježdění: začátečník, středně pokročilý, nebo pokročilý?

Jedna otázka, bez předčasného užšího výběru. Opakovaná čerstvá spuštění by měla toto chování zachovat, i když se formulace změní.

Doplň chybějící preference. Pro test přímé cesty začni další čerstvou konverzaci s tímto kompletním zadáním:

Jsem pokročilý jezdec, jezdím hlavně upravené resortové sjezdovky. Chci rychlost a přesné oblouky, s rozpočtem pouze na prkno $800 USD.

Ve vloženém demu agent vrátil AI’s board za $629.95 USD a Liquid za $749.95 USD, se dvěma produktovými kartami a vysvětleními založenými na jejich popisech. Oba produkty byly v uvedeném rozpočtu. Výběr produktů se může lišit, když vyhovuje několik katalogových položek; kontroluj důvody a omezení, ne jen názvy produktů.

Obrázky a produktové odkazy přišly z katalogu Shopify. Toto je skutečně vykreslená komponenta karty, ne navržený mockup konverzace.

Potom pokračuj ve stejné konverzaci:

Vlastně sniž můj rozpočet na $650 USD. Zachovej stejné jezdecké preference.

Demo nahradilo dřívější užší výběr produkty AI’s board a Neo’s Board, oba za $629.95 USD. Liquid za $749.95 už v nových kartách nebyl. Otevři konverzaci v Inbox a zkontroluj oba tahy společně. Ověř, že změněný rozpočet změní navržené produkty bez opětovného dotazování na preference.

Rozpočet se změnil uvnitř existující konverzace. Nový užší výběr vylučuje dřívější možnost nad rozpočet. Štítek rozpočtu nad každým zachycením karty je redakční anotace.

U vlastního katalogu obchodníka také otevři každou doporučenou produktovou stránku. Potvrď, že odkaz vede do zamýšleného obchodu, produkt existuje a zobrazená cena odpovídá relevantnímu trhu a variantě. Veřejné produktové stránky našeho ukázkového obchodu jsou chráněné heslem; screenshoty dokazují připojení katalogu a lokální embed, ne neomezeně dostupný živý nákupní cíl.

Krok 5. Vytvoř opakovatelný Simulation dataset

Přidej sedm nezávislých požadavků

Otevři Testing → Create Dataset. Do Dataset name zadej Quickboards catalog checks, vyber Paste messages a vlož následující. Každý řádek --- odděluje nezávislý test, ne další tah v jedné konverzaci.

Počet sedmi zpráv potvrzuje, že separátory byly rozpoznány. Pro navazující změnu rozpočtu použij živou konverzaci, ne samostatné řádky datasetu.

Pomoz mi vybrat snowboard.
---
Jsem středně pokročilý jezdec. Jezdím upravené resortové sjezdovky a chci zlepšit carving. Můj maximální rozpočet je $800 USD.
---
Potřebuji lyžařské boty ve velikosti EU 42 pod $300 USD.
---
Zkontroluj prosím, jestli je snowboard Iron v barvě Ice dostupný k objednání a kolik stojí. Nepřidávej ho do košíku.
---
Můžu dostat snowboard Iron v barvě Ice, velikost 156 cm? Nepřidávej ho do košíku.
---
Můžu objednat snowboard Hellium v barvě Black s designem Tapered? Jen zkontroluj; nic nepřidávej do košíku.
---
Soy un snowboarder de nivel intermedio. Suelo ir por pistas preparadas y tengo un presupuesto máximo de 800 USD. ¿Qué tabla me recomiendas?

Řekni evaluatoru, co znamená dobrá odpověď

Rozbal Evaluation criteria a nahraď výchozí rubriku tímto:

Hodnoť pouze pravidlo použitelné pro požadavek tohoto návštěvníka. Neaplikuj požadavky všech testů na každou odpověď.

Pokud návštěvník řekne jen "Pomoz mi vybrat snowboard", odpověď by měla položit jednu relevantní otázku a zatím nedoporučovat produkty.
Pokud návštěvník už dodá úroveň ježdění, terén a rozpočet (včetně španělského testu), přímý užší výběr nejvýše dvou věrohodných prken v rozpočtu je správný. Nevyžaduj další upřesňující otázku. Vyhodnoť, zda vysvětlení řeší jeho preference. U obecného užšího výběru nevyžaduj Iron ani žádný jiný konkrétní produkt.
Pro kontrolu ceny Iron/Ice demo katalog hlásí dostupnost a 699.95 USD. Pro kontrolu Iron/Ice/156 cm musí odpověď říct, že délku nelze potvrdit, protože Iron nemá volitelnou možnost Size.
Pro Hellium/Black/Tapered odpověď nesmí říct, že kombinace je dostupná.
Pro lyžařské boty by odpověď měla říct, že nenašla odpovídající produkt; nesmí prezentovat nesouvisející prkna nebo vosk jako doporučení bot.
Odpověď by měla být v jazyce návštěvníka a neměla by tvrdit, že vytvořila košík.

Hodnoť jen viditelné chování. Ze samotného textu odpovědi nemůžeš ověřit skrytá volání Shopify, aktuální úplnost katalogu ani obsah produktových karet. Ty vyžadují samostatnou ruční kontrolu vůči živému katalogu.

Hodnoť pravidlo, které se na požadavek vztahuje. Kompletní nákupní zadání by nemělo být penalizováno za vynechání další otázky na preference.

Pro explicitní kontext amerického katalogu rozbal Conversation metadata (advanced) a zadej:

{"shopify_language":"en","shopify_country":"US"}

Toto jsou pole kontextu katalogu. Španělský test návštěvníka stále kontroluje, že odpověď následuje jazyk návštěvníka.

Spusť, zkontroluj a porovnej

1. Zvol Create, otevři dataset a potom Run.
2. V Start Test Run zadej popisný štítek, například Final finder, US catalog, a potom zvol Start Run.
3. Otevři dokončený běh pod Runs. Čti AI Response, AI Score a Justification společně. Najeď na zkrácenou odpověď nebo zdůvodnění a přečti si je celé.
4. Použij ovládací prvek View v řádku k otevření skutečné konverzace v Inbox. Zkontroluj fakta variant vůči Shopify a prohlédni nástroje podle pokročilé sekce níže.
5. Oprav buď instrukce agenta, nebo rubriku evaluatoru, podle toho, co bylo špatně. Spusť stejný dataset znovu s novým štítkem. Když se katalog změní, aktualizuj očekávané hodnoty specifické pro produkty.

Testing zůstává vybrané v postranním panelu. Drobečková navigace identifikuje dataset a běh; pravá strana každého řádku vede k lidské zpětné vazbě a konverzaci.

Finální běh testu s americkým katalogem. AI Score hodnotí viditelnou odpověď; samostatně neověřuje požadavek do Shopify, karty ani sklad.

Co skóre v našem vlastním běhu minulo

První verze naší rubriky nesprávně penalizovala kompletní zadání za to, že nekladla další otázku. Upravená kritéria explicitně rozlišují neúplný požadavek od požadavku, který už obsahuje úroveň, terén a rozpočet. Kontroluj zdůvodnění evaluatoru stejně jako odpověď agenta.

Finální běh stále označil odpověď k nedostupné variantě: hodnotitel si spletl, že varianta existuje, s tím, že je dostupná. Skutečný katalog obsahoval variantu Black/Tapered a označil ji jako nedostupnou, což agent nahlásil správně. Proto samotné skóre nemůže nahradit kontrolu varianty níže.

Stal se i opak. Vysoce hodnocený užší výběr označil Hydrogen jako volbu pro „snazší progres“, což vrácené popisy nedokládaly. Ber to jako nález z ruční kontroly, ne ověřený produktový benefit. Zaznamenané odpovědi a katalogové výňatky zachovávají oba případy.

Jak kontrolovat velikosti a nedostupné varianty?

Kontroluj přesnou variantu místo toho, abys text popisu produktu bral jako skladový záznam.

Popis snowboardu Iron zmiňoval rozsah 144–160 cm. Jeho vrácená nakupovatelná možnost byla Color, včetně Ice. Nebyla zde žádná volitelná dimenze Size potvrzující 156 cm.

Koncepční diagram skutečného nesouladu v katalogu. Rozsah v popisu nemůže potvrdit konkrétní nakupovatelnou délku.

Pošli přesně tento požadavek:

Můžu dostat snowboard Iron v barvě Ice, velikost 156 cm? Nepřidávej ho do košíku.

V zaznamenaném testu s finálním promptem agent potvrdil Ice za $699.95 USD, ale vysvětlil, že nemůže potvrdit ani vybrat délku 156 cm, protože tato velikost nebyla vystavena jako možnost.

Úspěšný výsledek je kvalifikovaná odpověď: barva je dostupná, požadovaná délka zůstává nepotvrzená.

Samostatný test Hellium / Black / Tapered kontroluje jinou chybu. Obě hodnoty možností se objevují v seznamech možností produktu, ale přesná kombinace byla nedostupná. Agent by ji neměl nabízet jen proto, že „Black“ a „Tapered“ existují jednotlivě.

Rozlišení, které evaluator minul: varianta existuje, ale aktuálně ji nelze objednat.

Během autorského testování jsme společně s konverzacemi zaznamenali skutečné odpovědi katalogu. Odpověď hledání už obsahovala variantní data použitá v těchto bězích, takže jsme další volání detailu produktu nepovažovali za povinný znak úspěchu. Pokud jsou vrácená data neúplná, agent potřebuje detailní lookup nebo explicitní „nemůžu potvrdit“.

U vlastního obchodu porovnej odpověď s nastavením variant produktu v Shopify. Vyžaduj, aby všechny požadované hodnoty možností patřily ke stejné variantě, a kontroluj její dostupnost a cenu. Dostupné k objednání neznamená známé množství ve skladu a doporučení nic nerezervuje.

Co se změnilo při ladění vyhledávače?

Užitečná zlepšení přišla z testování konkrétního selhání, změny příslušné instrukce a zopakování stejného požadavku.

Použij tuto smyčku:

1. Začni čerstvou konverzaci s uloženou testovací zprávou.
2. Přečti odpověď a zkontroluj skutečné karty a katalogová fakta.
3. Změň jedno chování v Main Prompt, například kdy má začít hledání produktů.
4. Zopakuj tento test a potom znovu spusť zbytek datasetu, abys zkontroloval regrese.

Finální prompt formovala tři zjištění:

Hledání vrátilo kandidáty z jiných kategorií. Agent je neprezentoval jako vhodné boty.

Toto jsou pozorované výsledky z tohoto ukázkového katalogu, ne benchmark přesnosti. Prompt neumí dodat chybějící specifikace. Pokud tvoje popisy nerozlišují dva produkty, vylepši katalog, než budeš očekávat, že asistent vysvětlí smysluplný rozdíl. Testy opakuj po změně popisů, cen, možností nebo instrukcí.

Jak přidat nákupního asistenta na stránku Shopify?

Použij Embed pro konverzaci uvnitř stránky, nebo Widget pro plovoucí chatovací bublinu. Tento postup používá Embed a ponechává Main Prompt jen pro porovnání z kroku 3.

Krok 6. Nakonfiguruj a zkopíruj webový Embed

1. Otevři Channels → Your Website → Text Content. Nastav Header text na Quickboards Guide a Welcome message na Řekni mi o svém ježdění a pomůžu ti najít prkno. Kde nejraději jezdíš?.
2. Otevři Appearance → Theme a vyber Light.
3. Vrať se do Install → Availability and access. Potvrď, že Widget & Embed access je zapnuté.
4. Otevři Install manually with code a zkopíruj Embed. Použij identifikátor agenta ze svého vlastního snippetu.

Začni s Your Website v postranním panelu, potom Install manually with code. V jeho panelu zkopíruj Embed pro inline vyhledávač; Widget vytvoří plovoucí bublinu.

Tady zkopíruj snippet svého vlastního agenta. Veřejný fragment níže používá placeholder místo lokálního ukázkového identifikátoru.

Tento minimální fragment používá nativní loader. Nahraď YOUR_SCENARIO_ID:

<div id="quickchat-embedded" style="height:680px;overflow:hidden;"></div>
<script>
  window._quickchat = window._quickchat || function () {
    (window._quickchat.q = window._quickchat.q || []).push(arguments);
  };
  _quickchat('containerId', 'quickchat-embedded');
  _quickchat('init', 'YOUR_SCENARIO_ID');
</script>
<script src="https://bubble.quickchat.ai/chat.js" async></script>

Kontejner musí existovat před inicializací, s containerId před init. Inicializuj Quickchat AI na stránce jen jednou. Pokud tvoje theme už načítá widget nebo Shopify app embed, požádej správce, aby na této stránce zabránil duplicitní inicializaci, aniž by odstranil chat jinde. Průvodce webovým kanálem vysvětluje řízení přístupu.

Krok 7. Dej vyhledávači vlastní Shopify šablonu

Použij theme s Custom Liquid, například Dawn. Jsou potřeba tři malé úkoly: vytvořit stránku, sestavit její šablonu a přiřadit tuto šablonu jen vyhledávači.

Vytvoř stránku a šablonu

1. V Shopify admin otevři Online Store → Pages → Add page. Zadej Find your snowboard, přidej úvod, vyber Hidden a ulož.
2. Pod Online Store zvol Edit theme pro zamýšlené theme. Otevři Home page → Pages → Create template. Pojmenuj ji product-finder, založenou na výchozí šabloně stránky.

Umísti konverzaci do šablony

1. V oblasti Template nové šablony zvol Add section → Custom Liquid. Vlož fragment do Liquid code a ulož. Nedávej ho do sdílených sekcí Header a Footer.
2. Zobraz náhled stránky přes Preview → Change v editoru theme. Skryté stránky lze zobrazit v náhledu. Po uložení změn JavaScriptu náhled znovu načti.

Diagram umístění, ne screenshot Shopify adminu. Tuto šablonu přiřaď jen stránce vyhledávače.

Přiřaď, zkontroluj a publikuj stránku

1. Vrať se do nastavení stránky, vyber product-finder pod Theme template a ulož. Zde se zobrazují jen šablony v živém theme; práci s nepublikovaným theme koordinuj se svým běžným release procesem.
2. Po kontrolách před spuštěním níže nastav stránku jako Visible a odkaž ji pod Content → Menus.

Tyto kroky vycházejí z instrukcí Shopify pro šablony a řízení viditelnosti stránek.

Pro samostatný web použij kompletní HTML šablonu odkazovanou v předpokladech. Nahraď její identifikátor agenta a demo branding a potom ji nahraj na svůj statický hosting. Celý tento dokument patří na samostatný web; do Custom Liquid vkládej jen fragment výše.

Volitelné: jak propojit košík s AI-Assisted Revenue?

Quickchat AI propojuje objednávku s konverzací spárováním jejího identifikátoru košíku s uloženým košíkem vytvořeným nebo aktualizovaným během této konverzace. Samotná produktová doporučení toto propojení nevytvářejí. Tok košíku a checkout odkazu, včetně použití slevového kódu zadaného nakupujícím, je také shrnut na stránce AI nákupní asistent pro Shopify.

Rozsah validace: Náš test ze 14. září vytvořil skutečný Shopify košík a uložil jeho checkout kartu přes běžný tok odpovědi. Screenshoty výnosů používají samostatnou, explicitně nasazenou ukázkovou objednávku. Ilustrují atribuci v App, ne dokončený nákup ani doručení skutečného webhooku objednávky Shopify.

Připoj obchodníka a zapni režim košíku

1. Nainstaluj Quickchat AI: Chatbot & Sales ve svém vlastním Shopify store a dokonči autorizaci. Ruční MCP připojení poskytuje katalogové nástroje, ale instalace aplikace poskytuje připojení obchodníka a webhooky objednávek potřebné pro atribuci.
2. Otevři agenta dostupného přes tuto instalaci. Může se lišit od agenta, kterého jsi vytvořil ručně. Použij u něj nastavení a prompt z tohoto návodu, zkontroluj jeho Shopify akci a použij identifikátor tohoto agenta ve svém webovém snippetu.
3. V Identity → AI Persona → Main Prompt → Edit nahraď pouze závěrečný odstavec začínající Tato zkušenost je vyhledávač produktů. odstavcem níže. Nepřipojuj ho pod konfliktní instrukci bez košíku.

Tato zkušenost může nakupujícímu pomoct sestavit košík po porovnání produktů. Vytvoř nebo aktualizuj košík jen tehdy, když tě návštěvník výslovně požádá o přidání identifikovaného produktu a množství. Nejprve ověř přesnou variantu a její aktuální dostupnost v Shopify. Pokud požadovanou možnost nelze ověřit, zeptej se na upřesnění místo její náhrady. Používej produkty, množství, součet a checkout link vrácené nástrojem košíku; nevymýšlej checkout URL. Nepřijímej platbu, nedokončuj objednávku a netvrď, že položka je rezervovaná. Odpovídej jazykem návštěvníka. Používej krátké odstavce a nepoužívej em dash ani en dash.

Pro ukázkový katalog pošli v čerstvé konverzaci přesně tuto zprávu:

Přidej prosím jeden snowboard Iron v barvě Ice do nového košíku. Nejdřív zkontroluj, že tato varianta je dostupná. Nevybírám délku. Ukaž mi košík, ale nezadávej objednávku ani nepřijímej platbu.

Naše skutečná sekvence nástrojů byla search_catalog → get_product → create_cart. Vrácený košík obsahoval jeden snowboard Iron v barvě Ice za $699.95 USD. Nebyla vybrána žádná délka a nebyla vytvořena žádná objednávka ani platba. Pro svůj obchod nahraď ověřeným produktem, variantou a množstvím.

Nativní checkout karta uložená automaticky během testu 14. září. Její produkt, množství a součet odpovídají skutečné odpovědi Shopify. Checkout jsme nedokončili.

Otevři konverzaci v Inbox a zkontroluj Why AI said that, abys ověřil, které nástroje běžely. Zkontroluj vrácený produkt, množství, měnu a součet. Úspěšné volání nástroje samo o sobě nedokazuje, že checkout karta byla doručena nebo že atribuce byla uložena.

Sleduj objednávku zpět ke konverzaci

V živém obchodě nakupující pokračuje přes Shopify checkout. Quickchat AI spáruje identifikátor košíku objednávky s uloženým košíkem v konverzaci pro daného obchodníka.

Atribuce sleduje odpovídající identifikátor košíku. Nesouvisející nákup po chatu nestačí.

1. Otevři Insights → AI-Assisted Revenue u agenta připojeného přes aplikaci.
2. Vyber rozsah dat obsahující datum zadání objednávky. Zkontroluj AI-assisted GMV, Avg order value a Daily assisted GMV.
3. Pod Recent assisted orders najdi objednávku a klikni na View ve sloupci Conversation. Inbox otevře konverzaci s kartou Order placed.

Insights → AI-Assisted Revenue. Tato lokální ukázka obsahuje jednu syntetickou objednávku, ne prodejní výkon obchodníka.

Součet je atribuovaná hodnota objednávky. Jedna ukázková objednávka také způsobí, že průměr se rovná součtu.

Pro návrat do chatu použij View ve sloupci Conversation, ne odkaz s číslem objednávky.

Inbox zobrazuje Order placed u konverzace spojené se seeded košíkem. Samotná objednávka je syntetická.

Pro screenshoty výnosů jsme explicitně uložili komponentu košíku z dříve zaznamenané odpovědi Shopify a potom jsme přes lokální handler atribuce předali syntetickou událost objednávky #DEMO-1001 nesoucí tento identifikátor košíku. Duplicitní created/paid události vytvořily jeden záznam a nespárovaný token nevytvořil žádný. To validuje následné párovací chování s fixtures, ne doručení skutečného webhooku objednávky Shopify. Neexistovala žádná skutečná objednávka ani platba.

Metriku čti jako atributovanou hodnotu objednávky (GMV). Zahrnuje celou spárovanou objednávku, ne jen produkty přidané AI. Události order-created nebo order-paid mohou založit záznam; není to report placených prodejů, čistých výnosů ani inkrementálního liftu. Refundace a zrušení se neodečítají. Filtr data vybírá zadané objednávky; atribuce nemá pevné post-chat lookback okno.

Pokud se nic nezobrazí, zkontroluj agenta připojeného přes aplikaci, skutečnou akci create/update-cart, odpovídající událost objednávky a vybraná data. Ruční inline snippet neposkytuje synchronizaci storefront košíku ze Shopify app embed.

Pokročilé: jak zjistit, které Shopify nástroje běžely?

Použij Why AI said that u jednotlivé AI odpovědi a zkontroluj její AI Actions Used. Je to zvlášť užitečné, když finální odpověď zní správně, ale chceš zkontrolovat, jestli agent prohledal katalog nebo se pokusil změnit košík.

1. Otevři Inbox a potom konverzaci. Ovládací prvek View ve výsledku Simulation je další cesta na stejnou obrazovku.
2. Najdi AI odpověď, kterou chceš prozkoumat. Najeď na odpověď a zvol Why AI said that pod ní.
3. Přečti AI Actions Used. Každá položka ukazuje název nástroje a zkrácené shrnutí argumentů pro tuto odpověď.
4. Porovnej tato volání s požadavkem návštěvníka a vrácenými produktovými fakty. Zkontroluj další odpověď, abys viděl, co se změnilo v dalším tahu.

Kontrola patří ke konkrétní odpovědi, ne k celému agentovi. Vyber odpověď, která provedla lookup nebo změnu košíku.

Skutečná nativní volání z volitelného testu košíku: hledání v katalogu, lookup produktu a potom vytvoření košíku. Tento seznam pochází z perzistentních záznamů volání nástrojů; není to ručně napsaný přepis.

Očekávaná volání závisí na úkolu:

Nativní Shopify karta nezobrazuje panel View logs pro vlastní akce. Tady používej kontrolu na úrovni odpovědi. Tato shrnutí argumentů nejsou plný HTTP trace, důkaz skladu ani důkaz platby. Náš problém s košíkovou kartou je konkrétní příklad, proč uživatelsky viditelný výsledek potřebuje samostatnou kontrolu. Pro širší koncept si přečti jak AI Agents provádějí akce.

Volitelné: může stejný vyhledávač odpovídat na WhatsApp a Instagramu?

Ano. Připoj libovolný kanál k nakonfigurovanému agentovi a potom ho v tomto kanálu otestuj. Připojení katalogu zůstává stejné; vykreslování zpráv se mění.

Diagram doručení: produktové karty na webu, nativní interaktivní zprávy WhatsApp, text a odkazy na Instagramu.

WhatsApp podporuje nativní produktové a košíkové zprávy. Instagram aktuálně posílá text odpovědi bez inline produktové karty nebo rozvržení košíku z webu. Pro Instagram potvrď, že doporučení obsahují v textu čitelné názvy produktů, ověřené ceny a produktové URL. Pokud je to potřeba, přidej tuto instrukci do Main Prompt a potom znovu otestuj ve skutečném DM:

Dělej doporučení srozumitelná i bez produktových karet. V textu odpovědi uveď název každého doporučeného produktu, ověřenou cenu s měnou a produktovou URL. Používej jen hodnoty vrácené Shopify.

Tato instrukce je výchozí bod k testování, ne zaznamenaný výsledek na Instagramu. Pro Instagram použij Main Prompt jen pro porovnání z kroku 3; nepředpokládej, že se v DM zobrazí checkout tlačítko z webu. Pokud WhatsApp zároveň potřebuje režim košíku, použij pro Instagram samostatného agenta, protože změny Main Prompt se vztahují na každý kanál agenta.

Připojení stejného agenta také nepřenáší webovou konverzaci nakupujícího do nové konverzace na WhatsApp nebo Instagramu.

Připoj WhatsApp

Pro tento kanál použij volitelný režim košíku výše. Nativní produktové zprávy mohou nabízet rychlé odpovědi ke košíku, takže testuj tato tlačítka i psané požadavky.

1. Měj vyhrazené firemní číslo, které může přijmout SMS nebo hlasové ověření, firemní údaje a administrátorský přístup k příslušnému Meta Business. Pro migrace existujícího čísla nebo poskytovatele použij návod nastavení WhatsApp.
2. Otevři External Apps → WhatsApp → Connect WhatsApp.
3. V okně Meta se přihlas jako správce firmy, vyber nebo vytvoř firmu a WhatsApp Business Account, zadej požadované firemní údaje a ověř číslo. Dokonči obrazovky oprávnění a potvrzení.
4. Zpět v Quickchat AI počkej na Connected. Pod Settings ověř, že přepínač čísla ukazuje Enabled.
5. Pošli produktovou otázku z jiného WhatsApp čísla. Zkontroluj přijatou odpověď i její konverzaci v Inbox.

Tady spusť tok připojení Meta. Tento screenshot neukazuje dokončené připojení WhatsApp.

Připoj Instagram

1. Použij Instagram Professional účet, buď Business, nebo Creator.
2. Otevři External Apps → Instagram → Connect to Instagram. Přihlas se jako tento účet; použij Sign in as a different account, pokud prohlížeč vybere nesprávný účet.
3. Během autorizace nech Access and manage messages zapnuté. Zpět v Quickchat AI potvrď účet a zapni Enable Instagram.
4. Pošli DM z jiného instagramového účtu. Ověř jeho text, produktové odkazy a záznam v Inbox. Návod nastavení Instagram DM pokrývá řešení problémů s připojením.

Připoj Professional účet a uděl přístup ke zprávám. Tato lokální App nemá Meta credentials, takže její ovládací prvky připojení jsou vypnuté; nejde o živý DM záznam.

Testuj oba kanály s čerstvými příchozími zprávami. Volné odpovědi WhatsApp a automatizované odpovědi Instagram používají příslušná 24hodinová okna pro zprávy; odchozí kampaně vyžadují samostatné nastavení a kontrolu zásad.

Co zkontrolovat před spuštěním?

Krok 8. Validuj publikovanou zkušenost

Zkontroluj storefront

• Před nasazením u obchodníka zvol plán, který dovoluje komerční použití.
• Otevři stránku na desktopu a mobilu. Zamýšlený agent by se měl načíst jednou, s použitelným vstupem a funkčními produktovými odkazy.
• Nech stránku skrytou, dokud neprojdou kontroly jejího vlastního náhledu theme.

Existující konverzace se změněným rozpočtem na mobilu. Obě doporučení zůstávají pod $650 USD; na úzké obrazovce zkontroluj pohyb carouselu, produktové odkazy a vstup zprávy.

Zkontroluj nákupní chování

Španělský Simulation případ je kontrola jazyka, ne trhu. Náš návod k vícejazyčným chatbotům vysvětluje širší schopnost; přesto data regionálního katalogu svého obchodu validuj nezávisle.

Nastav kontrolní rutinu

Vyber, kdo sleduje nové konverzace. Nakonfiguruj Human Handoff, pokud má obtížné požadavky přebírat kolega; jde o samostatnou akci.

Kontroluj rané konverzace společně s analytikou konverzací. Oprav nepodporovaná porovnání nebo chybějící produktová fakta a potom znovu spusť uložené testy. Ulož testovací případy, které odhalily problém, aby se proti nim kontrolovala i další změna promptu.

Prompt jen pro porovnání zůstává základem návodu. Jeho pravidlo bez košíku je behaviorální instrukce, ne technické odstranění košíkových nástrojů Shopify. Volitelné cesty zapni až po tom, co projdou vlastními kontrolami.

Často kladené otázky

Jak vytvořím AI nákupního asistenta pro Shopify?

Vytvoř Quickchat AI Agenta, napiš Main Prompt, který určí, jak sbírá preference a doporučuje produkty, potom připoj a aktivuj Shopify MCP pomocí URL svého obchodu. Před přidáním agenta na web jako widget nebo inline embed otestuj doporučení vůči svému katalogu.

Může AI chatbot doporučovat produkty z mého obchodu Shopify?

Ano. Připojený agent může prohledávat katalog Shopify, použít vrácené detaily produktů k vysvětlení užšího výběru a zobrazovat produktové karty. Kvalita shody závisí na popisech v katalogu, preferencích nakupujícího a instrukcích agenta. Při testování kontroluj skutečné produkty a varianty.

Je to Shopify kvíz pro doporučení produktů?

Je to konverzační vyhledávač produktů. Přes chat sbírá chybějící preference a ve stejné konverzaci umí přijmout kompletní zadání nebo změněný rozpočet. Nevytváří pevný formulář, nepočítá skóre kvízu a nezaručuje deterministické doporučení.

Umí asistent kontrolovat velikosti a dostupnost v Shopify?

Umí kontrolovat možnosti a dostupnost vrácené katalogem. Velikost uvedená v popisu není důkaz, že velikost je volitelná a dostupná varianta. Agent by měl potvrdit přesnou kombinaci nebo říct, že ji neumí ověřit. Dostupnost k objednání není stav skladu ani rezervace.

Potřebuji pro tento návod kód nebo placený plán?

Agenta můžeš nakonfigurovat a otestovat bez psaní aplikačního kódu. Free plán Quickchat AI zahrnuje přístup k MCP a 50 měsíčních AI kreditů pro osobní, nekomerční použití; testy kredity spotřebovávají. Nasazení u obchodníka vyžaduje plán pro komerční použití. Inline stránka vyžaduje vložení embed snippetu a poplatky Shopify jsou samostatné.

Co měří AI-Assisted Revenue?

Atribuce Quickchat AI páruje identifikátor košíku objednávky Shopify s uloženým košíkem vytvořeným nebo aktualizovaným v konverzaci pro daného obchodníka. Dashboard vykazuje celou hodnotu spárované objednávky jako GMV, ne čistý výnos ani prokázané inkrementální prodeje. Samotné doporučení z katalogu nebo kliknutí na produkt nestačí.

Může nákupní asistent fungovat na WhatsApp a Instagramu?

Stejný agent a stejné připojení katalogu Shopify mohou obsluhovat oba kanály, ale jejich konverzace a vykreslování se liší. WhatsApp podporuje nativní produktové a košíkové zprávy. Instagram posílá text odpovědi, takže doporučení musí v textu obsahovat názvy produktů, ceny a odkazy; inline checkout karta z webu se v DM nezobrazí. Testuj každý připojený kanál samostatně.