Перейти до основного контенту

Усунення несправностей джерел знань Mira AI

Що робити, якщо продуктовий каталог або веб-скрейпінг не працює — поширені помилки, їхні причини та способи усунення.

Автор: Michal Jindra

Mira AI відповідає на основі підключених вами джерел знань — веб-скрейпінгу, продуктового каталогу XML, текстового вмісту та налаштованих відповідей. Якщо джерело не працює, Mira може перестати відповідати на запитання про товари або надавати застарілу інформацію. У цьому посібнику описано найпоширеніші помилки та способи їх усунення. Стан кожного джерела можна переглянути в розділі «База знань» — наведіть курсор на значок стану поруч із назвою джерела, щоб побачити подробиці.


Вимоги до продуктового каталогу

  • URL каталогу має бути загальнодоступним (без необхідності входу). Якщо ваш сервер використовує брандмауер, дозвольте доступ із наших IP-адрес 94.130.187.58 і 188.245.65.74.

  • Максимальний розмір — 50 MB, формат — XML або CSV (структура Google Merchant Center або Heureka).

  • Кожна позиція повинна містити обов’язкові теги: id, name, description, price і link. Позиції, у яких бракує хоча б одного з них, пропускаються під час обробки.

  • Кожній позиції має бути призначено категорію — позиції без категорії можуть бути пропущені, і тоді Mira не зможе відповідати на запитання про товари та категорії.

Порада: перш ніж додавати каталог, перевірте його за допомогою валідатора каталогів, щоб завчасно виявити відсутні теги. Якщо обробка каталогу постійно завершується помилкою, результати перевірки зазвичай показують, які саме позиції спричиняють проблему. Ви можете перевірити свій каталог Тут.


Поширені помилки продуктового каталогу

«Не вдалося обробити дані» / завантаження не завершується

Типові причини: розмір каталогу перевищує 50 MB, обов’язкові теги відсутні або мають неправильний формат, чи URL не є загальнодоступним. Перевірте каталог валідатором, перевірте його розмір і переконайтеся, що URL відкривається у вікні браузера в режимі інкогніто без входу. Якщо ваш сервер фільтрує трафік, дозвольте доступ із наших IP-адрес, наведених вище.

«Час очікування завантаження файлу минув»

Хостинг вашого каталогу відповідав надто повільно, і час очікування завантаження минув. Спробуйте додати каталог ще раз — перевірка запускається заново з кожною спробою — і перевірте швидкість з’єднання вашого сервера. Якщо помилка повторюється, зверніться до нашої служби підтримки, і ми з’ясуємо причину.

Попередження про відсутні категорії

Позиції без категорії пропускаються, і Mira не може відповідати на запитання про товари або категорії на основі цих позицій. Спочатку додайте категорію до кожної позиції в каталозі. Якщо перше формування каталогу завершується попередженням про категорії, хоча ваші позиції мають категорії, відкрийте каталог і натисніть «Оновити» — друге формування зазвичай завершується успішно. Якщо ні, зверніться до нашої служби підтримки.

Каталог має стан «Готово», але Mira не може знайти деякі товари

Позиції, у яких бракує обов’язкового тегу (id, name, description, price, link), пропускаються без повідомлення, тому каталог може мати стан «Готово», навіть якщо деяких товарів у ньому немає. Перевірте каталог валідатором, виправте позначені позиції та натисніть «Оновити».

Оновлення зависло у стані «Очікування»

Формування великих каталогів може тривати певний час. Якщо оновлення залишається у стані «Очікування» понад кілька годин, зверніться до нашої служби підтримки — ми можемо перезапустити обробку для вас.


Проблеми з веб-скрейпінгом

Mira не може знайти сторінки мого сайту

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

Веб-скрейпінг триває годинами

Якщо веб-скрейпінг триває годинами, він завис. Зверніться до нашої служби підтримки та надайте URL, який ви намагаєтеся просканувати, і ми перевіримо обробку зі свого боку.

Mira надає застарілу інформацію

Джерела оновлюються відповідно до свого інтервалу оновлення — його можна переглянути та змінити безпосередньо в таблиці джерел (веб-скрейпінг: щомісяця або кожні 2 тижні; продуктовий каталог: щотижня, щодня або кожні 12 годин). Для інтервалу також можна встановити значення Вимкнено — джерело зі значенням «Вимкнено» ніколи не оновлюється самостійно, тому, якщо Mira починає відповідати на основі застарілих даних, спочатку перевірте стовпець «Інтервал оновлення». Коли автоматичні оновлення каталогу вимкнено, над списком каталогів з’являється помаранчева панель попередження з кнопкою для повторного ввімкнення оновлень.

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


Публікація та стани джерел

Збій одного джерела не блокує публікацію вашого AI агента. Публікація блокується лише тоді, коли агент не має Жодного готового джерела (веб-скрейпінгу або текстового вмісту), або поки вибрані джерела ще створюються чи оновлюються. Якщо кнопка «Опублікувати» неактивна, перевірте в розділі «База знань», чи є джерела, які ще обробляються.


Що далі?

Ви отримали відповідь на своє запитання?