Asystent Zakupów Mira AI korzysta z Twojego pliku produktowego, aby polecać produkty, odpowiadać na pytania o ceny i sprawdzać dostępność. Ten poradnik wyjaśnia, jakie formaty plików obsługuje Mira AI, jakie znaczniki odczytuje i gdzie znaleźć oficjalne instrukcje eksportu dla najpopularniejszych platform e-commerce.

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

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

Zanim zaczniesz

Mira AI obsługuje standardowe pliki produktowe XML — ten sam format, który większość platform e-commerce generuje dla Heuréka, Google Shopping, Zboží.cz i podobnych platform handlowych. Im bogatszy jest Twój plik (cena, dostępność, opis, link, kategoria), tym trafniejsze będą rekomendacje Miry.

Aby dodać plik produktowy w Smartsupp:

W kreatorze asystenta otwórz Baza wiedzy → Produkty i kliknij Dodaj nowe źródło.
Wprowadź nazwę źródła.
Wklej pełny URL Twojego pliku produktowego.
W kroku Aktualizacja wybierz, jak często plik ma być odświeżany.

Wskazówka: Zobacz Wprowadzenie do Mira AI , aby poznać pełną konfigurację.

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

Uwaga: W okresie korzystania z konta testowego automatyczne aktualizacje pliku produktowego są wstrzymane. Po przejściu na wyższy pakiet wybierz częstotliwość aktualizacji pliku, aby je włączyć.

Uwaga: Mira AI wczytuje obrazki na kartach produktów bezpośrednio z Twojego pliku XML. Jeśli produkt nie ma obrazka w pliku, Mira korzysta z obrazka Open Graph lub obrazka wyróżnionego na stronie produktu — warto więc zadbać również o ich konfigurację.

Uwaga: Jeśli Twój serwer ogranicza połączenia przychodzące (zapora sieciowa, lista dozwolonych adresów IP), upewnij się, że zezwalasz na dostęp z adresów IP mechanizmu pobierania plików produktowych Smartsupp: 94.130.187.58 i 188.245.65.74. W przeciwnym razie Mira AI nie będzie w stanie pobrać Twojego pliku produktowego.

Te adresy IP mogą się czasami zmieniać. Jeśli Twój plik nagle przestanie się aktualizować, sprawdź aktualną listę w tym artykule lub skontaktuj się z naszą pomocą techniczną.

Obsługiwane formaty plików produktowych

Mira AI obsługuje dwa standardowe formaty plików produktowych — Heuréka i Google Merchant. Oba stosują wspólne konwencje XML:

Rozszerzenie pliku to .xml lub .rss.
Pierwszy wiersz musi zaczynać się od <?xml ...?> lub <rss ...>.
Jeden znacznik nadrzędny obejmuje wszystkie elementy produktów. Znacznik nadrzędny może mieć dowolną nazwę (np. <SHOP>) — liczy się tylko jego obecność.
Każdy produkt jest otoczony własnym znacznikiem elementu (zobacz poniższe sekcje dotyczące poszczególnych formatów).

Minimalny poprawny szkielet wygląda tak:

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

Ważne: Jeśli brakuje obowiązkowego znacznika w produkcie, cały produkt zostaje pominięty w indeksie Miry — odwiedzający nie zobaczą go w rekomendacjach. Upewnij się, że każdy produkt ma uzupełnione wszystkie wymagane znaczniki.

Struktura pliku produktowego Heuréka

W formacie Heuréka Mira AI odczytuje poniższe znaczniki. Zobacz Oficjalną dokumentację pliku XML Heuréka , aby poznać pełną specyfikację.

Kategoria	Znaczniki	Uwagi
Znacznik obejmujący element (obowiązkowy)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Jeden z tych znaczników obejmuje każdy produkt.
Opis (obowiązkowy)	`PRODUCTNAME` (lub `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Każdy znacznik musi zawierać treść. Puste znaczniki są traktowane jako brakujące.
Opcjonalne	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = w magazynie, 1–7 = dostępny w ciągu tygodnia, każda inna wartość / brak = niedostępny. `PARAM` może występować dowolną liczbę razy dla każdego produktu.
Obrazek	`IMGURL`	Obrazek produktu wyświetlany na karcie. Jeśli go brakuje, Mira korzysta z obrazka Open Graph lub obrazka wyróżnionego na stronie produktu.
Ignorowane	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI pomija te znaczniki — możesz pozostawić je w pliku dla innych narzędzi.

Znacznik PARAM przechowuje dodatkowy atrybut produktu jako parę nazwa–wartość:

<PARAM> <PARAM_NAME>Width</PARAM_NAME> <VAL>100–109 cm</VAL> </PARAM>

Struktura pliku produktowego Google Merchant

W formacie Google Merchant Mira AI odczytuje poniższe znaczniki. Zobacz Oficjalną specyfikację pliku produktowego Google Merchant , aby poznać pełną dokumentację.

Kategoria	Znaczniki	Uwagi
Znacznik obejmujący element (obowiązkowy)	`item`, `entry`, `product`	Jeden z tych znaczników obejmuje każdy produkt.
Opis (obowiązkowy)	`title`, `description`, `product_type` (lub `google_product_category`), `link`, `price`	Dla kategorii użyj `product_type` lub `google_product_category` z nazwą tekstową — numeryczne identyfikatory kategorii nie są jeszcze obsługiwane.
Format ceny	`price`	Dozwolony format: `236 CZK` lub `CZK 236`. Waluta to 3-literowy kod (CZK, EUR, GBP…).
Opcjonalne	`availability`	W magazynie: `in_stock`, `in stock`. Niedostępny: `out_of_stock`, `out of stock`, `preorder`, `backorder`, każda inna wartość / brak.
Obrazek	`image_link`	Obrazek produktu wyświetlany na karcie. Jeśli go brakuje, Mira korzysta z obrazka Open Graph lub obrazka wyróżnionego na stronie produktu.
Ignorowane	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI pomija te znaczniki — możesz pozostawić je w pliku dla innych narzędzi.

Mira odczytuje również rozmiary produktów z Twojego pliku (znacznik size ) i może o nich wspominać podczas polecania produktów. Rozmiary pojawią się po odświeżeniu pliku.

Uwaga: Numeryczne google_product_category identyfikatory nie są jeszcze obsługiwane. Zawsze używaj tekstowej wersji kategorii — na przykład "Apparel & Accessories > Clothing > Shirts & Tops" — lub użyj product_type zamiast niej.

Eksport pliku produktowego według platformy

Znajdź swoją platformę e-commerce w poniższej tabeli i postępuj zgodnie z oficjalnym poradnikiem eksportu.

Platforma	Co generuje	Oficjalny poradnik
Shoptet	Pliki XML Heuréka & Google Shopping z panelu administracyjnego	Pliki XML • Heuréka XML
Shopsys	Pliki produktowe z platformy wraz z dokumentacją dla programistów	Pliki produktowe
Eshop-rychle	Pliki produktowe dla porównywarek cen	Eksport produktów
Upgates	Eksport danych XML z pełną strukturą produktów	Eksport danych • Dokumentacja XML
Shoper	Plik produktowy Google bezpośrednio z platformy	Plik produktowy Google
Shopware	Google Shopping — eksport bezpośredni lub za pomocą dodatków	Eksport bezpośredni • Dodatki
Shoprenter	Pliki produktowe Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping za pomocą dodatków	Dodatki
Magento	Google Shopping za pomocą rozszerzeń	Rozszerzenia
WooCommerce	Google Product Feed za pomocą dodatków	Dodatki • Polecane

Co dalej?

Wprowadzenie do Asystenta Zakupów Mira AI — skonfiguruj Mira AI i dodaj swój plik produktowy jako źródło.
Jak rozpocząć trening Mira AI — dopracuj odpowiedzi AI za pomocą własnych par pytań&odpowiedzi.
Mira AI - dostępność w magazynie — pozwól odwiedzającym sprawdzić, czy produkt jest w magazynie.
FAQ Asystenta Zakupów Mira AI — najczęstsze pytania o Mira AI.

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

Artykuły powiązane

Jak eksportować pliki produktowe z różnych platform e-commerce dla Asystenta Zakupów Mira AI?