К основному содержимому

Руководство по устранению неполадок источников знаний Mira AI

Рекомендации, что делать, если не работает фид товаров или веб-скрейпинг: основные ошибки, их причины и решения.

Автор: Michal Jindra

Mira AI формирует ответы из источников знаний, которые Вы подключаете — вебскрейпинг, XML фид товаров, текстовый контент и пользовательские ответы. Если какой-либо источник перестаёт работать, Mira может прекратить отвечать на вопросы о товарах или выдавать устаревшую информацию. В этом руководстве описаны наиболее частые ошибки и способы их устранения. Статус каждого источника можно посмотреть в разделе «База знаний» — значок статуса рядом с названием источника показывает подробности при наведении курсора.


Требования к фиду товаров

  • URL фида должен быть общедоступен (без входа в систему). Если на сервере установлен брандмауэр, добавьте наши IP-адреса 94.130.187.58 и 188.245.65.74 в белый список.

  • Ограничения по размеру: один файл фида может быть до 150 МБ в несжатом виде (XML или CSV, структура Google Merchant Center или Heureka). Также у Вашего аккаунта есть квота обработанных данных фида, по умолчанию 50 МБ. Обновления фида учитываются в квоте, но при обновлении обрабатываются только изменения с момента последнего запуска, поэтому используется минимальный объём. Если удалить фид и добавить его снова, обработается весь фид заново. Нужна большая квота? Свяжитесь со службой поддержки.

  • Каждый элемент требует обязательных тегов: id, name, description, price и link. Элементы без любого из них пропускаются во время обработки.

  • Каждому элементу должна быть назначена категория — элементы без категории могут быть отклонены, и Mira уже не сможет отвечать на вопросы по товарам и категориям из них.

Совет: перед добавлением фида проверьте его через валидатор, чтобы заранее выявить недостающие теги. Если фид продолжает не работать, валидатор чаще всего покажет проблемные элементы. Проверить фид можно здесь.


Типичные ошибки фида товаров

«Ошибка обработки данных» / загрузка не завершается

Причины: файл фида превышает 150 МБ, исчерпана Ваша квота на данные фида (по умолчанию 50 МБ), отсутствуют или некорректны обязательные теги, либо URL не является публичным. Проверьте фид через валидатор, проверьте размер и убедитесь, что URL открывается в режиме инкогнито без входа. Если трафик фильтруется сервером — разрешите наши IP, указанные выше. Если квота исчерпана, попросите службу поддержки увеличить её.

«Время ожидания загрузки файла истекло»

Размещение фида отвечает слишком медленно, поэтому загрузка завершается с ошибкой таймаута. Повторите добавление фида — каждая новая попытка запускает проверку заново — и проверьте скорость соединения вашего сервера. Если ошибка повторяется, обратитесь в поддержку, и мы проверим подробности.

Предупреждение об отсутствии категорий

Элементы без категории пропускаются, и Mira не сможет отвечать на вопросы о товарах или категориях из них. Сначала добавьте категорию ко всем элементам в фиде. Если после первой сборки фида появляется предупреждение, даже если у элементов есть категории, откройте фид и нажмите Обновить — обычно повторная сборка проходит успешно. Если нет — обратитесь в поддержку.

Фид в статусе «Готово», но Mira не находит некоторые товары

Элементы без обязательных тегов (id, name, description, price, link) тихо пропускаются, так что статус может быть «Готово», даже если часть товаров не попала в фид. Проверьте фид валидатором, исправьте отмеченные элементы и выполните обновление.

Обновление зависло в статусе «Ожидается»

Построение фида может занять время при большом каталоге. Если обновление остаётся в ожидании дольше нескольких часов, обратитесь в поддержку — мы перезапустим обработку для Вас.


Ошибки вебскрейпинга

Mira не может найти страницы сайта

Проверьте, что страницы доступны публично без входа и что Ваш брандмауэр разрешает наши IP-адреса (94.130.187.58, 188.245.65.74). Одна попытка вебскрейпинга охватывает до 20 страниц — выберите ключевые (FAQ, доставка, условия, основные товарные страницы). Если сайт полностью блокирует роботов, Вы всё равно сможете завершить настройку агента — опишите бизнес в текстовом поле на этапе подключения, и это сохранится как отдельный источник «Текстовый контент».

Хостинг на SiteGround? Безопасность SiteGround способна блокировать наш скрейпер даже для публичных страниц и правильных IP — тогда источник будет отмечен как недоступный. Обратитесь в службу поддержки SiteGround с просьбой разрешить наш сканер. Если это невозможно, внесите всю ключевую информацию с этих страниц в «Текстовый контент» вручную.

Скрейпинг длится слишком долго

Если скрейпинг выполняется несколько часов, он завис. Обратитесь в поддержку с URL, который хотите сканировать — мы проверим процесс на своей стороне.

Mira отвечает устаревшей информацией

Источники обновляются по своему интервалу — его можно посмотреть и изменить в таблице источников (вебскрейпинг: раз в месяц или каждые 2 недели; фид товаров: раз в неделю, ежедневно или раз в 12 часов). Интервал может быть и Выкл — источник с таким статусом не обновляется, поэтому если Mira начинает отвечать устаревшими данными, проверьте сначала столбец «Интервал обновления». При отключённых автообновлениях фидов вверху появится оранжевая полоса с кнопкой возврата обновлений.

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

Во время пробного периода автообновления отключены для всех источников: в колонке интервала будет «заблокировано», и изменить его нельзя. После перехода на платный тариф все источники вернутся к стандартному интервалу автоматически.


Публикация и статусы источников

Отдельные неудачные источники не мешают публикации Вашего AI агента. Публикация блокируется только если у агента нет готовых источников вообще (вебскрейпинг или текстовый контент), или пока выбранные источники ещё создаются или обновляются. Если кнопка «Публиковать» неактивна, проверьте раздел «База знаний» — там есть статусы всех источников.


Что дальше?

Нашли ответ на свой вопрос?