YML-каталоги

Раздел Источники данных → YML-каталоги загружает товарный каталог из YML/XML-файла или по URL и делает товары доступными выбранным AI-агентам.

Во время парсинга система обновляет товары, создаёт поисковые фрагменты и подготавливает их для AI-поиска. Для каталога по URL можно настроить автоматическое обновление.

Быстрый старт

1. Откройте Источники данных → YML-каталоги.
2. Нажмите Создать.
3. Укажите Название фида.
4. Выберите Загрузка файла или Ссылка (URL).
5. Загрузите XML-файл либо укажите URL фида.
6. Для URL выберите частоту обновления.
7. Назначьте агентов.
8. Нажмите Создать.
9. В списке или на странице редактирования нажмите Запустить парсинг.
10. Дождитесь статуса Проиндексирован и проверьте поиск товара у назначенного агента.

Для первого запуска рекомендуем использовать небольшой корректный фид и ручной парсинг. Автоматическое расписание лучше включать после успешной проверки.

Шаг 1. Выберите источник YML

Название фида

Используйте понятное внутреннее название, например:

Основной каталог интернет-магазина

Название видно в списке, логах и описании расхода AI-токенов.

Загрузка файла

Выберите Загрузка файла и добавьте YML-файл в формате XML.

При создании файл обязателен. На странице редактирования в поле Текущий файл отображается сохранённый путь. Если загрузить новый файл:

• старый файл будет заменён;
• статус вернётся в Ожидает;
• дата последнего парсинга очистится;
• потребуется новый запуск парсинга.

Для файлов плановое обновление недоступно. Чтобы обновить каталог, загрузите новую версию и запустите парсинг вручную.

Ссылка (URL)

Выберите Ссылка (URL) и укажите полный адрес, по которому система может скачать фид без ручной авторизации.

Пример:

https://example.ru/export/catalog.yml

При смене URL или переключении типа источника статус возвращается в Ожидает, а предыдущий успешный результат нужно обновить новым запуском.

Если перейти с файла на URL, сохранённый файл удаляется. Если перейти с URL на файл, расписание отключается.

Шаг 2. Настройте частоту парсинга

Поле Частота парсинга показывается только для источника по URL.

• Не планировать — обновление запускается вручную.
• Каждую минуту (для тестирования) — частые тестовые запуски; не используйте как обычное рабочее расписание.
• Каждый час — подходит для часто меняющихся цен и остатков.
• Каждый день — подходит для каталогов, обновляющихся раз в сутки.

После включения расписания поле Следующий запуск показывает планируемое время. Если частота изменена или запуск ещё не был рассчитан, ближайшая проверка назначается после сохранения.

Плановый импорт работает только пока URL доступен и тариф разрешает обработку источников знаний.

Шаг 3. Назначьте агентов

В поле Назначенные агенты выберите агентов, которые должны искать товары этого каталога.

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

Изменение списка агентов сохраняется отдельно от парсинга. После назначения нового агента проверьте поиск товара в тестовом чате.

Шаг 4. Запустите парсинг

Действие Запустить парсинг доступно:

• в строке списка;
• в верхней части страницы редактирования;
• как массовое действие для выбранных каталогов.

После подтверждения статус меняется на Парсится, а обработка продолжается в фоне.

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

Как обновляются товары

При каждом успешном запуске система сравнивает текущий фид с сохранённым каталогом:

• добавляет новые товары;
• обновляет изменившиеся;
• оставляет неизменившиеся без лишней переработки;
• удаляет товары, которых больше нет в фиде;
• восстанавливает отсутствующие поисковые данные, если это возможно.

Для URL система также определяет, изменился ли файл. Если сервер сообщает, что фид не менялся, либо содержимое совпадает с предыдущим, полный импорт пропускается. Такой результат считается нормальным и отображается в логе.

Статусы каталога

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

Поля Последний парсинг и Следующий запуск помогают отличить фактически обновлённый каталог от только запланированного.

Список YML-каталогов

Таблица показывает:

• Название;
• фактический источник;
• Тип источника;
• количество Офферов;
• Статус;
• время последнего парсинга;
• Частоту;
• следующий запуск;
• дату создания.

Название доступно для поиска. Фильтр Статус помогает найти ожидающие, выполняющиеся и ошибочные каталоги.

Количество офферов показывает товары, сохранённые после последнего успешного импорта, а не число строк в исходном XML до обработки.

Логи парсинга

На странице редактирования раздел Логи парсинга показывает каждый ручной и плановый запуск.

В логе доступны:

• Триггер — ручной или плановый;
• Статус — в процессе, завершено или ошибка;
• количество офферов и чанков;
• время начала и завершения;
• итоговый дифф.

Поле Результат может содержать:

• количество новых, изменённых и неизменившихся товаров;
• число обработанных поисковых фрагментов;
• количество переобработанных или восстановленных данных;
• удалённые товары;
• отметку, что фид пропущен как неизменившийся.

Если запуск завершился ошибкой, действие Ошибка открывает полный текст причины.

Что попадает в поиск агента

Для товара подготавливаются доступные данные из фида: название, производитель, цена и валюта, описание, параметры и страна происхождения.

Качество ответа зависит от качества YML. Если в фиде нет цены, производителя или описания, агент не сможет надёжно сообщить эти сведения.

Удаление каталога

Удаление отвязывает каталог от агентов. Связанные товары и поисковые данные больше не должны использоваться в ответах.

Перед удалением убедитесь, что этот каталог не является единственным источником товаров для действующего агента.

Доступ, тариф и AI-токены

Раздел доступен менеджерам и пользователям с более высокими правами и скрыт от операторов и руководителей операторов.

Источники знаний должны быть доступны на тарифе организации. При тарифном ограничении список пуст, создание заблокировано и показывается предупреждение.

Парсинг с подготовкой поисковых данных расходует AI-токены. Для запуска должен быть доступен разрешённый лимит или баланс AI-операций организации.

Удаление каталога доступно пользователям с административными правами.

Рекомендуемая настройка

Для рабочего интернет-магазина:

• используйте стабильный HTTPS URL без ручной авторизации;
• начните с ручного запуска;
• после успешной проверки включите Каждый час или Каждый день в зависимости от частоты обновления;
• передавайте стабильный уникальный ID каждого товара;
• заполняйте название, цену, валюту, описание и важные характеристики;
• удаляйте из фида товары, которые больше не должны находиться агентом;
• проверяйте лог после изменения структуры экспорта.

Если каталог не обновляется

1. Проверьте статус каталога и последний лог.
2. Для URL откройте адрес источника и убедитесь, что он отдаёт XML без авторизации и HTML-страницы ошибки.
3. Для файла загрузите актуальный YML/XML повторно.
4. Откройте действие Ошибка в логе и исправьте указанную причину.
5. Проверьте тариф и доступность AI-токенов.
6. Если лог сообщает, что фид не изменился, это нормальный результат: полный импорт не требуется.
7. Если товар исчез, проверьте, присутствует ли он в текущем фиде и имеет ли стабильный идентификатор.
8. После исправления нажмите Запустить парсинг и дождитесь статуса Проиндексирован.

Если агент не находит товар

1. Убедитесь, что каталог имеет статус Проиндексирован.
2. Проверьте, что нужный агент выбран в Назначенных агентах.
3. Найдите товар в исходном YML и проверьте название, описание и параметры.
4. Посмотрите последний лог: товар мог быть удалён как отсутствующий в новой версии фида.
5. Задайте агенту запрос по точному названию, артикулу или важной характеристике.

Редакция от 24 сентября 2026 года. Доступность функций зависит от роли, тарифа и настроек организации.