Nákupní košík
Vlastnosti a výhody modulu
- Markdown vytvářený z objektů PrestaShopu, a ne konverzí vyrenderované stránky — dokument neobsahuje menu, patičku, formuláře ani kód jiných modulů.
- Radikálně nižší náklady na tokeny na straně agenta: hlavička X-Markdown-Tokens-Estimate v každé odpovědi uvádí odhadovanou velikost dokumentu a panel zobrazuje porovnání Markdownu oproti HTML pro vybranou entitu.
- Dva nezávislé kanály doručení — vyjednávání obsahu na kanonické adrese a samostatné adresy .md — takže se agent dostane k obsahu bez ohledu na to, zda posílá hlavičku Accept.
- Diagnostická pojistka před zapnutím vyjednávání: modul nedovolí funkci spustit, dokud skutečnými HTTP požadavky nezměří, že cacheující prostředník neotráví sdílenou mezipaměť.
- Zásada „agent nikdy nevidí víc než host" implementovaná jako pravidlo, nikoli jako jednotlivé výjimky — nastavení viditelnosti obchodu platí vůči agentům stejně jako vůči anonymnímu návštěvníkovi.
- Ceny počítané v kontextu hosta s výslovným určením měny a země, takže cache neuloží cenu jednoho zákazníka a neposkytne ji všem ostatním.
- Plná podpora multistore a vícejazyčnosti: nastavení, soubory llms, cache i čítač jsou vedeny odděleně pro každý obchod a každý jazyk.
- Žádné externí závislosti — bez Composeru, bez externích knihoven, bez volání služeb třetích stran; modul neposílá data vašeho obchodu nikam jinam než v odpovědi na požadavek.
- Neshromažďuje osobní údaje: čítač přístupů ukládá výhradně den, obchod, kanál a rodinu klienta, bez IP adres, relací, úplných URL adres a úplného User-Agent.
- Kompatibilita od PrestaShopu 1.7.1.0 do 9.x a od PHP 7.0 do 8.5, ověřená vůči skutečným stromům zdrojových kódů, nikoli jen deklarativně.
Nejdůležitější funkce modulu
- Vyjednávání obsahu na kanonických adresách obchodu: požadavek s Accept: text/markdown obdrží dokument Markdown, požadavek z prohlížeče obdrží nezměněné HTML.
- Hlavička Vary: Accept a značka Link: rel="alternate" na HTML stránkách zahrnutých modulem, díky čemuž prostředníci a agenti vědí, že existuje alternativní verze.
- Paralelní adresy markdown/{typ}/{id}.md pro produkty, kategorie, CMS stránky a výrobce, pod vlastním prefixem, aby nekolidovaly s jinými moduly přepisujícími adresy.
- Soubor llms.txt — kurátorovaný seznam nejdůležitějších sekcí obchodu: kategorií nejvyšší úrovně, informačních stránek a odkazu na plný index.
- Soubor llms-full.txt — kompaktní index entit: název, kanonická adresa, adresa .md, cena, dostupnost, SKU a shrnutí; automaticky dělený na části po překročení nakonfigurované velikosti.
- Generování llms-full.txt výhradně přes cron endpoint chráněný tokenem, nikdy během požadavku návštěvníka, s časovým rozpočtem a obnovením přerušené přestavby.
- Samostatný cron token pro každý obchod, porovnávaný v konstantním čase, s hotovým příkazem curl ke zkopírování v panelu.
- Cache vygenerovaného Markdownu v databázi s konfigurovatelnou dobou života a invalidací pomocí hooků při změně produktu, kombinace, akční ceny, cenového pravidla, stavu skladu, kategorie, CMS stránky a výrobce.
- Záložka Diagnostika: sedm kontrol prováděných skutečnými HTTP požadavky proti vlastnímu sondovacímu bodu modulu, se samostatným rozlišením selhání „HTML podané agentovi" a „Markdown podaný prohlížeči".
- Informační kontrola skutečné katalogové adresy po zapnutí vyjednávání, zobrazovaná samostatně a neblokující funkci.
- Náhled dokumentu v panelu pro vybraný typ a identifikátor entity spolu s počítadlem tokenů Markdown oproti HTML a výslovným verdiktem viditelnosti entity.
- Záložka Soubory: stav souborů llms pro každý jazyk (přítomnost, velikost, datum, počet entit, počet částí), tlačítko ruční přestavby s časovým rozpočtem a cron příkaz.
- Čítač přístupů agentů: agregát den × obchod × kanál × rodina klienta, s rozdělením na kanály vyjednávání, trasa .md a llms a rodiny openai, anthropic, perplexity, google, bing, script, browser a other.
- Hlavičky odpovědí odpovídající účelu obsahu: X-Robots-Tag: noindex, nofollow u dokumentů Markdown, X-Content-Type-Options: nosniff, ETag s podporou 304 a odlišná politika Cache-Control pro kanonickou adresu a adresu .md.
- Data produktu v hlavičce dokumentu: typ, identifikátor, kanonická adresa, adresa Markdown, název, SKU, značka, cena s DPH a bez DPH, měna, informace o dani, dostupnost, označení sady, požadavek na personalizaci, stav produktu, kategorie, jazyk a datum aktualizace.
- Běžná cena a výše i procento slevy, pokud je produkt v akci — agent neuvidí akční cenu jako běžnou.
- Tabulka variant s cenou, množstvím, dostupností a identifikátorem kombinace, díky čemuž může agent uvést konkrétní variantu, a ne ji jen popsat.
- Obsah produktových sad s množstvími a odkazy na dokumenty Markdown jednotlivých položek.
- Informace o povinných polích personalizace s vynecháním polí patřících jiným modulům, která PrestaShop na frontendu nezobrazuje.
- Výběr typů entit zpřístupněných agentům, jednotně vynucovaný ve všech kanálech: na trasách .md, v souborech llms i ve značce alternativní verze.
- Pracovní adresář modulu zabezpečený proti přímému čtení ze sítě a soubory llms obsluhované výhradně kontrolery modulu.
- Respektování režimu údržby obchodu a geolokace — obchod uzavřený pro návštěvníky je uzavřený i pro agenty.
- Panel v konvenci PD s hlavičkou modulu a lištou záložek, s nápovědami u nastavení s nákladnými důsledky, jako je fragmentace CDN cache.
Obchodní využití
- Pro obchody na PrestaShopu, které chtějí být správně čteny nákupními asistenty a AI agenty, místo aby spoléhaly na to, že si model HTML stránku sám odšumí.
- Pro prodejce, kteří chtějí mít kontrolu nad tím, co přesně se dostane k agentům — rozsah typů entit, viditelnost cen a množství i způsob publikace.
- Pro obchody s rozsáhlým katalogem, kde se rozdíl mezi plnou HTML stránkou a dokumentem Markdown promítá do reálného rozdílu nákladů na straně dotazujícího.
- Pro multistore implementace, kde každý obchod vyžaduje vlastní nastavení, vlastní soubory llms a vlastní cron token.
- Pro firmy, které chtějí rozhodnutí o dalších investicích do tohoto kanálu opřít o data — čítač přístupů ukazuje, zda a kudy se agenti skutečně dotazují.
- Pro obchody běžící za CDN nebo reverse proxy, kde by samostatné zapnutí vyjednávání obsahu bez ověření hrozilo podáním nesprávné verze stránky běžným zákazníkům.
Co modul nedělá
- Není to SEO modul a nezlepšuje pozici obchodu ve výsledcích vyhledávání Google — dokumenty Markdown jsou výslovně označeny jako neindexované.
- Neupravuje vzhled, obsah ani výkon HTML stránky zobrazované zákazníkům; stránka zahrnutá modulem dostává pouze dodatečné hlavičky informující o existenci alternativní verze.
- Neposílá data obchodu do žádné externí služby a nevyžaduje účet ani API klíč.
- Nepřekládá strukturální štítky dokumentu — názvy polí zůstávají pevné a anglické, protože jsou určeny pro stroj, zatímco obsah entity je vždy v jazyce obchodu.
Kompatibilita
- PrestaShop: 1.7.1.0 - 9.x
- PHP: 7.0 - 8.5
- Bez Composeru a bez externích knihoven
- Multistore: ano, nastavení a soubory vedené odděleně pro každý obchod
- Vícejazyčnost: ano, dokumenty a soubory llms pro každý aktivní jazyk