Asystent Zakupów Mira AI korzysta z Twojego feedu produktowego, aby rekomendować produkty, odpowiadać na pytania o ceny i sprawdzać dostępność. Ten poradnik wyjaśnia formaty feedów obsługiwanych przez Mira AI, tagi, które odczytuje, oraz gdzie znaleźć oficjalne instrukcje eksportu dla najpopularniejszych platform e-commerce.

Podzieliliśmy poradnik na następujące sekcje:

Feed lub web scrape nie działa? Rozwiązywanie problemów z źródłami wiedzy Mira AI

Zanim zaczniesz

Mira AI akceptuje standardowe feedy produktowe XML — ten sam format, który generuje większość platform e-commerce dla Heuréka, Google Shopping, Zboží.cz i podobnych marketplace'ów. Im bogatszy feed (cena, dostępność, opis, link, kategoria), tym trafniejsze będą rekomendacje Mira.

Aby dodać feed w Smartsupp:

W kreatorze asystenta otwórz Baza wiedzy → Produkty i kliknij Dodaj.
Wpisz nazwę źródła.
Wklej pełny URL swojego feedu produktowego.
W kroku Aktualizuj wybierz, jak często feed ma być odświeżany.

Porada: Zobacz Wprowadzenie do Mira AI, aby poznać cały proces konfiguracji.

Mira AI automatycznie odświeża Twój feed produktowy w regularnych odstępach — zmiany cen, dostępności i nowe produkty pojawiają się na czacie bez potrzeby ponownego przesyłania pliku.

Uwaga: Mira AI ładuje zdjęcia produktów bezpośrednio z Twojego feedu XML. Jeśli produkt w feedzie nie ma zdjęcia, Mira użyje obrazu Open Graph lub głównego zdjęcia na stronie produktu — warto o to zadbać.

Uwaga: Jeśli Twój serwer blokuje połączenia przychodzące (firewall, biała lista IP), upewnij się, że adresy IP fetchera Smartsupp mają dostęp: 94.130.187.58 i 188.245.65.74. W przeciwnym razie Mira AI nie pobierze Twojego feedu produktowego.

Te adresy IP mogą się czasem zmieniać. Jeśli Twój feed nagle przestanie się aktualizować, sprawdź aktualną listę w tym artykule lub skontaktuj się z naszym supportem.

Obsługiwane formaty feedów

Mira AI obsługuje dwa standardowe formaty feedów produktowych — Heuréka i Google Merchant. Oba korzystają z typowych konwencji XML:

Rozszerzenie pliku to .xml lub .rss.
Pierwsza linijka musi zaczynać się od <?xml ...?> lub <rss ...>.
Jeden tag nadrzędny obejmuje wszystkie produkty. Może mieć dowolną nazwę (np. <SHOP>) — liczy się jedynie jego obecność.
Każdy produkt ma osobny tag (szczegóły w sekcjach poniżej).

Minimalna poprawna struktura wygląda tak:

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

Ważne: Jeśli brakuje obowiązkowego tagu przy produkcie, cały produkt jest pomijany w indeksie Mira — odwiedzający nie zobaczą go w rekomendacjach. Upewnij się, że każdy produkt ma wypełnione wszystkie wymagane tagi.

Struktura feedu Heuréka

Dla formatu Heuréka Mira AI odczytuje poniższe tagi. Pełną specyfikację znajdziesz w oficjalnej dokumentacji Heuréka XML feed.

Kategoria	Tagi	Uwagi
Obwoluta produktu (wymagany)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Jeden z tych tagów otacza każdy produkt.
Opis (wymagany)	`PRODUCTNAME` (lub `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Każdy tag musi mieć zawartość. Puste tagi są traktowane jak brakujące.
Dobrowolne	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = dostępny od ręki, 1–7 = dostępny w ciągu tygodnia, wszystko inne / brak = niedostępny. `PARAM` może być powtórzony dowolną liczbę razy przy produkcie.
Zdjęcie	`IMGURL`	Zdjęcie pokazywane na karcie produktu. Jeśli brakuje, Mira użyje Open Graph lub obrazu wyróżnionego ze strony produktu.
Ignorowane	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI pomija te tagi — możesz zostawić je w feedzie do innych narzędzi.

Tag PARAM to dodatkowy atrybut produktu w parze nazwa–wartość:

<PARAM> <PARAM_NAME>Szerokość</PARAM_NAME> <VAL>100–109 cm</VAL> </PARAM>

Struktura feedu Google Merchant

Dla formatu Google Merchant Mira AI odczytuje poniższe tagi. Pełen opis znajdziesz w oficjalnej specyfikacji feedów Google Merchant.

Kategoria	Tagi	Uwagi
Obwoluta produktu (wymagany)	`item`, `entry`, `product`	Jeden z tych tagów otacza każdy produkt.
Opis (wymagany)	`title`, `description`, `product_type` (lub `google_product_category`), `link`, `price`	Dla kategorii użyj `product_type` lub `google_product_category` z nazwą tekstową — numeryczne ID kategorii nie są jeszcze obsługiwane.
Format ceny	`price`	Dozwolony format: `236 CZK` lub `CZK 236`. Akceptowane również separatory dziesiętne i tysięczne, np. `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` lub `1 049,00 CHF`. Waluta to 3-literowy kod (CZK, EUR, GBP…).
Cena promocyjna (opcjonalnie)	`sale_price`, `sale_price_effective_date`	Jeśli `sale_price` jest obecny, w tej samej walucie i niższy niż `price`, Mira będzie cytować cenę promocyjną w odpowiedziach, wyszukiwaniu i na kartach produktu. Wraz z `sale_price_effective_date` cena promocyjna stosowana jest tylko w podanym zakresie dat (sprawdzanym w momencie zapytania); poza nim lub gdy zakres nieczytelny, Mira użyje ceny regularnej. Aktualne feedy zaktualizują promocje przy kolejnym odświeżeniu.
Dobrowolne	`availability`	Dostępny: `in_stock`, `in stock`. Niedostępny: `out_of_stock`, `out of stock`, `preorder`, `backorder`, wszystko inne / brak.
Zdjęcie	`image_link`	Zdjęcie produktu pokazywane na karcie. Jeśli zabraknie, Mira użyje Open Graph lub obrazu wyróżnionego na stronie produktu.
Ignorowane	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI pomija te tagi — możesz zostawić je w feedzie do innych narzędzi.

Mira czyta też rozmiary produktów z feedu (tag size) i może wspominać o nich w rekomendacjach. Rozmiary pojawią się po odświeżeniu feedu.

Uwaga: Numeryczne ID google_product_category nie są jeszcze obsługiwane. Zawsze używaj wersji tekstowej kategorii — np. "Odzież i akcesoria > Odzież > Koszule i topy" — lub korzystaj z product_type.

Eksport feedu według platformy

Znajdź swoją platformę e-commerce w tabeli poniżej i postępuj według oficjalnej instrukcji eksportu.

Platforma	Zawartość eksportu	Oficjalna instrukcja
Shoptet	Heuréka & Google Shopping XML z panelu administracyjnego	XML Feedy • Heuréka XML
Shopsys	Feedy produktowe z platformy z dokumentacją developerską	Product Feeds
Eshop-rychle	Feedy do porównywarek cenowych	Eksport produktów
Upgates	Eksport danych XML z pełną strukturą produktu	Eksport danych • Dokumentacja XML
Shoper	Google product feed bezpośrednio z platformy	Google Feed
Shopware	Google Shopping — eksport bezpośredni lub przez dodatki	Eksport bezpośredni • Dodatki
Shoprenter	Google Shopping & Heuréka feedy	Google Shopping • Heuréka
PrestaShop	Google Shopping przez dodatki	Dodatki
Magento	Google Shopping przez rozszerzenia	Rozszerzenia
WooCommerce	Google Product Feed przez dodatki	Dodatki • Polecane

Co dalej?

Wprowadzenie do Asystenta Zakupów Mira AI — skonfiguruj Mira AI i dodaj feed produktowy jako źródło.
Jak zacząć trening Mira AI — doprecyzuj odpowiedzi AI własnymi parami pytań i odpowiedzi.
Mira AI – dostępność produktów w magazynie — pozwól odwiedzającym sprawdzić, czy produkt jest w magazynie.
FAQ: Asystent Zakupów Mira AI — najczęstsze pytania o Mira AI.

💡 Potrzebujesz więcej pomocy? Skontaktuj się z naszym zespołem wsparcia — chętnie pomożemy!

Artykuły powiązane

Jak wyeksportować feedy produktowe z różnych platform e-commerce do asystenta zakupów Mira AI?