Mira AI nákupní asistentka využívá váš produktový katalog pro doporučení produktů, odpovědi na otázky ohledně ceny a kontroly dostupnosti. Tento návod popisuje formáty katalogů, které Mira AI podporuje, tagy, které zpracovává, a kde najdete oficiální návody na export u nejrozšířenějších e-commerce platforem.

Návod jsme rozdělili do těchto sekcí:

Katalog nebo stahování dat z webu nefunguje? Řešení potíží se znalostními zdroji Mira AI

Než začnete

Mira AI přijímá standardní XML produktové katalogy — ve stejném formátu, který většina e-commerce platforem generuje pro Heuréku, Google Shopping, Zboží.cz a podobné marketplace. Čím více informací v katalogu uvedete (cena, dostupnost, popis, odkaz, kategorie), tím chytřejší budou doporučení od Mira AI.

Pro přidání katalogu ve Smartsupp:

V editoru asistentky otevřete Znalostní báze → Produkty a klikněte na Přidat.
Zadejte název zdroje.
Vložte plnou URL vašeho produktového katalogu.
V kroku Aktualizace vyberte, jak často se má katalog aktualizovat.

Tip: Podívejte se na Úvod do Mira AI pro kompletní nastavení.

Mira AI automaticky obnovuje produktový katalog v pravidelných intervalech — změny cen, aktualizace dostupnosti i nové produkty se v chatu objeví bez nutnosti znovu nahrávat soubor.

Poznámka: Mira AI načítá obrázky produktových karet z přímo vašeho XML katalogu. Pokud některému produktu chybí obrázek v katalogu, Mira použije Open Graph nebo hlavní obrázek na stránce produktu — proto se vyplatí mít tyto obrázky nastavené.

Poznámka: Pokud váš server omezuje příchozí spojení (firewall, povolené IP adresy), umožněte přístup z IP adres Smartsupp k načítání katalogu: 94.130.187.58 a 188.245.65.74. Jinak nebude moci Mira AI produktový katalog stáhnout.

Tyto IP adresy se mohou příležitostně změnit. Pokud se katalog najednou přestane aktualizovat, zkontrolujte aktuální seznam v tomto článku nebo kontaktujte naši podporu.

Podporované formáty katalogů

Mira AI podporuje dva standardní formáty produktových katalogů — Heuréka a Google Merchant. Oba využívají běžné XML konvence:

Přípona souboru je .xml nebo .rss.
První řádek začíná <?xml ...?> nebo <rss ...>.
Všechny produkty obsahuje jeden rodičovský tag. Název rodičovského tagu může být libovolný (např. <SHOP>) — důležitá je pouze jeho přítomnost.
Každý produkt má svůj vlastní tag (viz sekce jednotlivých formátů níže).

Minimální platná struktura vypadá takto:

<?xml version="1.0" encoding="UTF-8"?> <SHOP> <SHOPITEM> ... </SHOPITEM> <SHOPITEM> ... </SHOPITEM> </SHOP>

Důležité: Pokud produktu chybí povinný tag, celý produkt bude z indexu Mira AI vynechán — návštěvníci jej nedostanou v doporučeních. Ujistěte se, že každý produkt má všechny potřebné údaje vyplněné.

Struktura katalogu Heuréka

Pro formát Heuréka Mira AI načítá následující tagy. Úplnou specifikaci najdete v oficiální dokumentaci k XML katalogu Heuréka.

Kategorie	Tagy	Poznámky
Obal produktu (povinný)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Každý produkt je zabalen do jednoho z těchto tagů.
Popis (povinný)	`PRODUCTNAME` (nebo `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Každý tag musí být vyplněn. Prázdné tagy se počítají jako chybějící.
Volitelné	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = skladem, 1–7 = dostupné do týdne, cokoli dalšího / chybějící = nedostupné. `PARAM` lze pro jeden produkt uvést vícekrát.
Obrázek	`IMGURL`	Obrázek produktu, který se zobrazí na kartě. Pokud chybí, Mira použije Open Graph nebo hlavní obrázek na stránce produktu.
Ignorováno	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI tyto tagy ignoruje — v katalogu je můžete ponechat pro další systémy.

Tag PARAM nese další vlastnost produktu v páru název–hodnota:

<PARAM> <PARAM_NAME>Šířka</PARAM_NAME> <VAL>100–109 cm</VAL> </PARAM>

Struktura katalogu Google Merchant

Pro formát Google Merchant Mira AI načítá tyto tagy. Kompletní přehled najdete v oficiální specifikaci katalogu Google Merchant.

Kategorie	Tagy	Poznámky
Obal produktu (povinný)	`item`, `entry`, `product`	Každý produkt je zabalen do jednoho z těchto tagů.
Popis (povinný)	`title`, `description`, `product_type` (nebo `google_product_category`), `link`, `price`	Pro kategorii použijte `product_type` nebo `google_product_category` s textovým názvem — číselné kódy zatím nejsou podporovány.
Formát ceny	`price`	Povolený formát: `236 CZK` nebo `CZK 236`. Akceptovány jsou i desetinné a tisícové oddělovače, např. `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` nebo `1 049,00 CHF`. Měna musí být třípísmenný kód (CZK, EUR, GBP…).
Snížená cena (volitelné)	`sale_price`, `sale_price_effective_date`	Pokud je `sale_price` uvedeno, ve stejné měně a nižší než `price`, Mira AI uvádí v odpovědích, vyhledávání i na kartách sníženou cenu. Pokud je vyplněno `sale_price_effective_date`, sleva se zohledňuje pouze v tomto rozmezí (ověří se v daný okamžik); mimo něj nebo pokud se platnost nepřečte, Mira AI použije běžnou cenu. U existujících katalogů se slevy objeví při další aktualizaci.
Volitelné	`availability`	Skladem: `in_stock`, `in stock`. Nedostupné: `out_of_stock`, `out of stock`, `preorder`, `backorder`, vše ostatní / chybí.
Obrázek	`image_link`	Obrázek produktu, který se zobrazí na kartě. Pokud chybí, Mira AI použije Open Graph nebo hlavní obrázek na stránce produktu.
Ignorováno	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI tyto tagy ignoruje — v katalogu je můžete ponechat pro další systémy.

Mira AI také čte velikosti produktů z vašeho katalogu (tag size) a může je zmiňovat při doporučování produktů. Velikosti se začnou zobrazovat od dalšího obnovení katalogu.

Poznámka: Číselné google_product_category nejsou zatím podporovány. Vždy použijte textovou verzi kategorie — například "Oblečení & doplňky > Oblečení > Košile a topy" — nebo zadejte product_type.

Export katalogu podle platformy

Najděte svou e-commerce platformu v tabulce a postupujte podle oficiálního exportního návodu.

Platforma	Co generuje	Oficiální návod
Shoptet	Heuréka & Google Shopping XML z administrace	XML feedy • Heuréka XML
Shopsys	Produktové katalogy přes platformu s dokumentací pro vývojáře	Product Feeds
Eshop-rychle	Katalogy pro porovnávače zboží	Export produktů
Upgates	XML export s kompletní produktovou strukturou	Export dat • XML dokumentace
Shoper	Google produktový katalog přímo z platformy	Google Feed
Shopware	Google Shopping — přímý export nebo přes doplňky	Přímý export • Doplňky
Shoprenter	Google Shopping & Heuréka katalogy	Google Shopping • Heuréka
PrestaShop	Google Shopping přes doplňky	Doplňky
Magento	Google Shopping přes rozšíření	Rozšíření
WooCommerce	Google produktový katalog přes doplňky	Doplňky • Doporučené

Co dál?

Úvod do Mira AI nákupní asistentky — nastavte si Mira AI a přidejte produktový katalog jako zdroj.
Jak začít trénovat Mira AI — dolaďte AI odpovědi pomocí vlastních dvojic otázek a odpovědí.
Mira AI - dostupnost skladem — umožněte návštěvníkům ověřit, zda je produkt skladem.
Mira AI nákupní asistentka - FAQ — nejčastější dotazy o Mira AI.

💡 Potřebujete další pomoc? Kontaktujte náš tým podpory — rádi vám pomůžeme!

Související články

Jak exportovat produktové katalogy z různých e-commerce platforem pro Mira AI nákupní asistentku?