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

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

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

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

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

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

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

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

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

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

Примечание: Если ваш сервер ограничивает входящие соединения (firewall, белый список 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 и не будет показан в рекомендациях посетителям. Убедитесь, что у каждого товара заполнены все необходимые теги.

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

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

Категория	Теги	Примечания
Обёртка товара (обязательно)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Один из этих тегов используется для обёртывания каждого товара.
Описание (обязательно)	`PRODUCTNAME` (или `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	В каждом теге должно быть содержимое. Пустые теги считаются отсутствующими.
Необязательные	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = в наличии, 1–7 = поступит в течение недели, иное значение или отсутствие = нет в наличии. `PARAM` может повторяться любое число раз для каждого товара.
Изображение	`IMGURL`	Изображение товара, показанное на карточке. При отсутствии Mira использует 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` с текстовым названием — цифровые категории пока не поддерживаются.
Формат цены	`price`	Допустимый формат: `236 CZK` или `CZK 236`. Также принимаются разделители целой и дробной части, например `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` или `1 049,00 CHF`. Для валют используется трёхбуквенный код (CZK, EUR, GBP и т. д.).
Цена по акции (необязательно)	`sale_price`, `sale_price_effective_date`	Если присутствует `sale_price`, указана в той же валюте и ниже, чем `price`, Mira будет использовать цену по акции в ответах, поиске и карточках товара. При наличии `sale_price_effective_date` акционная цена действует только на эти даты (проверяется на момент вопроса); вне диапазона — или если прочитать даты невозможно — Mira использует обычную цену. Обновление цены по акции происходит при следующем обновлении фида.
Необязательные	`availability`	В наличии: `in_stock`, `in stock`. Нет в наличии: `out_of_stock`, `out of stock`, `preorder`, `backorder`, другие варианты или отсутствие.
Изображение	`image_link`	Изображение товара, показанное на карточке. При отсутствии Mira использует Open Graph или основное изображение на странице товара.
Игнорируются	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI пропускает эти теги — Вы можете оставить их в фиде для других инструментов.

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

Примечание: Цифровые категории google_product_category пока не поддерживаются. Используйте текстовое название категории — например, "Одежда и аксессуары > Одежда > Рубашки и топы" — либо используйте product_type.

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

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

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

Что дальше?

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

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

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

Как экспортировать фиды товаров с разных платформ электронной коммерции для MiraAI Shopping Assistant?