Asystent Zakupów Mira AI używa Twojego product feedu do rekomendacji produktów, odpowiadania na pytania o ceny oraz sprawdzania dostępności. Ten poradnik wyjaśnia, jakie formaty feedów akceptuje Mira AI, jakie tagi odczytuje i gdzie znaleźć oficjalne instrukcje eksportu dla najpopularniejszych platform e-commerce.

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

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

Zanim zaczniesz

Mira AI akceptuje standardowe XML product feedy — w tym samym formacie, jaki generuje większość platform e-commerce na potrzeby Heuréka, Google Shopping, Zboží.cz i podobnych marketplace'ów. Im bogatszy feed (cena, dostępność, opis, link, kategoria), tym bardziej trafne będą rekomendacje Miry.

Aby dodać feed do Smartsupp:

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

Wskazówka: Pełną konfigurację znajdziesz w Wstęp do Mira AI.

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

Uwaga: Mira AI ładuje zdjęcia z kart produktów bezpośrednio z Twojego feedu XML. Jeśli produkt nie ma zdjęcia w feedzie, Mira pobierze je z Open Graph lub zdjęcia wyróżnionego na stronie produktu — warto zadbać też o ich ustawienie.

Uwaga: Jeśli Twój serwer ogranicza połączenia przychodzące (firewall, allowlist IP), pamiętaj o otwarciu dostępu dla adresów IP pobierających feed Smartsupp: 94.130.187.58 i 188.245.65.74. W przeciwnym razie Mira AI nie pobierze feedu produktów.

Adresy IP mogą się czasami zmieniać. Jeśli Twój feed nagle przestanie się aktualizować, sprawdź ten artykuł, aby poznać aktualną listę lub skontaktuj się z naszym supportem.

Obsługiwane formaty feedów

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

Rozszerzenie pliku to .xml lub .rss.
Pierwsza linia zaczyna się od <?xml ...?> lub <rss ...>.
Jeden główny (rodzicielski) tag otacza wszystkie produkty. Nazwa tagu może być dowolna (np. <SHOP>) — liczy się tylko jego obecność.
Każdy produkt jest otoczony własnym tagiem (patrz sekcje o formatach poniżej).

Minimalny poprawny szkielet wygląda tak:

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

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

Struktura feedu Heuréka

Dla formatu Heuréka Mira AI odczytuje następujące tagi. Pełną specyfikację znajdziesz w oficjalnej dokumentacji XML feedu Heuréka.

Kategoria	Tagi	Uwagi
Opakowanie produktu (wymagane)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Jeden z tych tagów otacza każdy produkt.
Opis (wymagane)	`PRODUCTNAME` (lub `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Wszystkie tagi muszą zawierać treść. Puste tagi traktowane są jako brakujące.
Opcjonalne	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = dostępny na magazynie, 1–7 = dostępny w ciągu tygodnia, inne/dla braku = niedostępny. `PARAM` może występować dowolną liczbę razy dla produktu.
Obrazek	`IMGURL`	Zdjęcie produktu widoczne na karcie. Jeśli brak, Mira użyje zdjęcia Open Graph lub wyróżnionego na stronie produktu.
Ignorowane	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI pomija te tagi — możesz je zostawić w feedzie do użycia przez inne narzędzia.

Tag PARAM przenosi dodatkowe cechy produktu w formie pary 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 następujące tagi. Pełny wykaz znajdziesz w oficjalnej specyfikacji feedu Google Merchant.

Kategoria	Tagi	Uwagi
Opakowanie produktu (wymagane)	`item`, `entry`, `product`	Jeden z tych tagów otacza każdy produkt.
Opis (wymagane)	`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`. Waluta — 3-literowy kod (CZK, EUR, GBP…).
Cena promocyjna (opcjonalna)	`sale_price`, `sale_price_effective_date`	Jeśli pojawi się `sale_price`, w tej samej walucie i niższa od `price`, Mira cytuje promocyjną cenę w odpowiedziach, wyszukiwaniu produktów i na kartach produktów. Przy obecności `sale_price_effective_date` cena promocyjna używana jest tylko w tym okresie (sprawdzane w momencie zapytania); poza nim lub jeśli zakres jest nieczytelny, Mira używa regularnej ceny. Istniejące feede pobiorą promocyjne ceny przy najbliższej aktualizacji.
Opcjonalne	`availability`	Dostępny: `in_stock`, `in stock`. Niedostępny: `out_of_stock`, `out of stock`, `preorder`, `backorder` i inne/za brak.
Obrazek	`image_link`	Zdjęcie produktu widoczne na karcie. Jeśli brak, Mira użyje zdjęcia Open Graph lub wyróżnionego na stronie produktu.
Ignorowane	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI pomija te tagi — możesz je zostawić w feedzie dla innych narzędzi.

Mira odczytuje także rozmiary produktów z feedu (tag size) i może podawać je w rekomendacjach. Rozmiary pojawiają się po odświeżeniu feedu.

Uwaga: Numeryczne ID google_product_category nie są jeszcze obsługiwane. Zawsze używaj wersji tekstowej kategorii — na przykład „Apparel & Accessories > Clothing > Shirts & Tops” — albo product_type.

Eksport feedu według platformy

Znajdź swoją platformę e-commerce w poniższej tabeli i skorzystaj z oficjalnej instrukcji eksportu.

Platforma	Co generuje	Oficjalna instrukcja
Shoptet	Heuréka & Google Shopping XML z panelu administracyjnego	XML Feedy • Heuréka XML
Shopsys	Product feede w ramach platformy, dokumentacja developerska	Product Feeds
Eshop-rychle	Feedy dla porównywarek cenowych	Eksport produktów
Upgates	Eksport danych XML z pełną strukturą produktów	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	Feedy Google Shopping & Heuréka	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?

Wstęp do Asystenta Zakupów Mira AI — skonfiguruj Mira AI i dodaj feed jako źródło.
Jak rozpocząć trening Mira AI — dopracuj odpowiedzi AI za pomocą własnych par pytań i odpowiedzi.
Mira AI — dostępność produktów — pozwól odwiedzającym sprawdzać dostępność produktów.
FAQ Asystenta Zakupów Mira AI — popularne pytania o Mira AI.

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

Artykuły powiązane

Wprowadzenie do Asystenta Zakupów Mira AI

Jak eksportować product feedy z różnych platform e-commerce do Asystenta Zakupów MiraAI?