Mira AI Помощник по покупкам использует ваш фид товаров для рекомендаций, ответа на вопросы о ценах и проверки наличия. В этом руководстве объясняются поддерживаемые Mira AI форматы фидов, читаемые теги и где найти официальные инструкции по экспорту для самых популярных платформ электронной коммерции.

Мы разбили руководство на следующие разделы:

Фид или веб-скрейпинг не работает? Поиск и устранение неисправностей источников знаний Mira AI

Перед началом

Mira AI принимает стандартные фиды товаров в формате XML — тот же формат, который большинство платформ электронной коммерции генерируют для Heuréka, Google Shopping, Zboží.cz и аналогичных маркетплейсов. Чем богаче ваш фид (цена, наличие, описание, ссылка, категория), тем умнее будут рекомендации Mira AI.

Чтобы добавить фид в Smartsupp:

В конструкторе помощника откройте База знаний → Товары и нажмите Добавить.
Введите имя источника.
Вставьте полный URL вашего фида товаров.
На этапе Обновить выберите, как часто должен обновляться фид.

Совет: Смотрите Введение в Mira AI для полной настройки.

Mira AI автоматически обновляет ваш фид товаров с регулярными интервалами — изменения цены, обновления наличия и новые товары отображаются в чате без необходимости повторной загрузки файла.

Примечание: Mira AI загружает изображения карточек товаров напрямую из вашего XML-фида. Если у товара нет изображения в фиде, Mira AI берёт изображение из Open Graph или основного изображения на странице товара — поэтому важно настроить их тоже.

Примечание: Если ваш сервер ограничивает входящие подключения (фаервол, белый список IP), убедитесь, что открыт доступ с IP-адресов загрузчика фидов Smartsupp: 94.130.187.58 и 188.245.65.74. Иначе Mira AI не сможет скачать ваш фид товаров.

Эти IP-адреса могут время от времени меняться. Если ваш фид внезапно перестал обновляться, проверьте актуальный список в этой статье или обратитесь в нашу службу поддержки.

Поддерживаемые форматы фидов

Mira AI поддерживает два стандартных формата фидов товаров — Heuréka и Google Merchant. Оба используют общий XML-стандарт:

Расширение файла — .xml или .rss.
Первая строка файла должна начинаться с <?xml ...?> или <rss ...>.
Внешний тег-обёртка охватывает все товары. Имя внешнего тега может быть любым (например, <SHOP>) — важен лишь сам факт его наличия.
Каждый товар обёрнут собственным тегом (см. форматные секции ниже).

Минимально допустимая структура выглядит так:

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

Важно: Если обязательный тег отсутствует у товара, этот товар полностью пропустится Mira AI и не попадёт в рекомендации для посетителей. Убедитесь, что у каждого товара заполнены все обязательные поля.

Структура фида Heuréka

Для формата Heuréka Mira AI читает следующие теги. Полная спецификация приведена в официальной документации по XML-фиду Heuréka.

Категория	Теги	Примечания
Обёртка для товара (обязательно)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Каждый товар обёрнут одним из этих тегов.
Описание (обязательно)	`PRODUCTNAME` (или `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Каждый тег должен содержать данные. Пустые теги считаются отсутствующими.
Необязательно	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = в наличии, 1–7 = доступно в течение недели, любое другое значение или отсутствие = недоступно. `PARAM` может повторяться в каждом товаре любое количество раз.
Изображение	`IMGURL`	Изображение товара на карточке. Если отсутствует, Mira AI использует Open Graph или главное изображение со страницы товара.
Игнорируется	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI игнорирует эти теги — можно оставить их для других инструментов.

Тег PARAM содержит дополнительную характеристику товара в виде пары имя–значение:

<PARAM> <PARAM_NAME>Ширина</PARAM_NAME> <VAL>100–109 см</VAL> </PARAM>

Структура фида Google Merchant

Для формата Google Merchant Mira AI читает следующие теги. Полную справку см. в официальной документации по фидам Google Merchant.

Категория	Теги	Примечания
Обёртка для товара (обязательно)	`item`, `entry`, `product`	Каждый товар обёрнут одним из этих тегов.
Описание (обязательно)	`title`, `description`, `product_type` (или `google_product_category`), `link`, `price`	Для категории используйте `product_type` или `google_product_category` с текстовым названием — числовые ID пока не поддерживаются.
Формат цены	`price`	Допускается формат: `236 CZK` или `CZK 236`. Валюта указывается 3-буквенным кодом (CZK, EUR, GBP…).
Цена со скидкой (необязательно)	`sale_price`, `sale_price_effective_date`	Если указан `sale_price` — в той же валюте и ниже `price`, Mira AI будет использовать цену со скидкой в ответах, поиске и на карточках товаров. С `sale_price_effective_date` цена действует только в указанный период (проверяется в момент запроса). Вне этого периода, либо если диапазон не читается, Mira AI использует обычную цену. В существующих фидах цены со скидкой появятся при ближайшем обновлении.
Необязательно	`availability`	В наличии: `in_stock`, `in stock`. Нет в наличии: `out_of_stock`, `out of stock`, `preorder`, `backorder`, либо любое другое значение/отсутствие тега.
Изображение	`image_link`	Изображение товара на карточке. Если отсутствует, Mira AI использует Open Graph или основную картинку на странице товара.
Игнорируется	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI игнорирует эти теги — можно оставить их для других инструментов.

Mira AI также читает размеры товаров из вашего фида (тег size) и может указывать их при рекомендациях. Размеры появятся после обновления фида.

Примечание: Числовые google_product_category пока не поддерживаются. Всегда используйте текстовую версию категории — например, "Apparel & Accessories > Clothing > Shirts & Tops", или используйте product_type.

Экспорт фида по платформам

Найдите вашу платформу электронной коммерции в таблице ниже и следуйте официальному руководству по экспорту.

Платформа	Что генерирует	Официальное руководство
Shoptet	Heuréka & Google Shopping XML из админ-панели	XML Feeds • Heuréka XML
Shopsys	Фиды товаров через платформу с документацией для разработчиков	Product Feeds
Eshop-rychle	Фиды для сервисов сравнения цен	Product Export
Upgates	Экспорт данных в XML с полной структурой товаров	Data Export • XML Docs
Shoper	Google-фид товаров напрямую через платформу	Google Feed
Shopware	Google Shopping — прямой экспорт или через дополнения	Direct Export • Add-ons
Shoprenter	Google Shopping и Heuréka фиды	Google Shopping • Heuréka
PrestaShop	Google Shopping через дополнения	Add-ons
Magento	Google Shopping через расширения	Extensions
WooCommerce	Google Product Feed через дополнения	Add-ons • Recommended

Что дальше?

Введение в Mira AI Помощник по покупкам — настройте Mira AI и добавьте ваш фид товаров как источник.
Как начать обучение Mira AI — настройте ответы AI с помощью собственных пар «вопрос–ответ».
Mira AI – наличие на складе — предоставьте посетителям возможность проверять наличие товара.
Mira AI Помощник по покупкам FAQ — часто задаваемые вопросы о Mira AI.

💡 Нужна дополнительная помощь? Обратитесь в нашу службу поддержки — мы с радостью поможем!

Другие статьи по теме

Как экспортировать фиды товаров с различных платформ электронной коммерции для Mira AI Помощника по покупкам?