AI Cross-sell: рекомендательная система, сопутствующие товары, апсейл, кросс-продажи

Требования

1. Установка модуля

Перейдите в раздел Marketplace → Установленные решения административной панели, найдите модуль AI Cross-sell и нажмите Установить.

При установке автоматически:

2. Настройка подключения к Yandex Cloud

Перейдите в Административная панель → Сервисы → AI Cross-sell → Настройки.

Заполните в настройках модуля:

3. Загрузка каталога в поисковый индекс

После выбора инфоблоков и заполнения ключа нажмите кнопку «Загрузить в поисковый индекс». Модуль экспортирует товары в CSV, загрузит их в Yandex AI Studio и создаст поисковый индекс (Vector Store) — именно по нему нейросеть анализирует характеристики, цены и категории товаров.

Загрузку нужно повторять при значительном обновлении каталога — новые товары не попадут в индекс автоматически.

4. Автоматическая обработка товаров

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

Прогресс можно посмотреть в разделе AI Cross-sell → Статус обработки: общее количество товаров, обработано, ошибок, прогресс-бар. Страница обновляется автоматически до завершения обработки.

5. Просмотр и пересчёт рекомендаций вручную

Раздел AI Cross-sell → Рекомендации — список всех обработанных товаров с поиском по ID. Здесь можно удалить рекомендации ненужного товара из списка.

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

6. Логи запросов к нейросети

Если в настройках включено логирование, каждый запрос к Yandex AI Studio и ответ на него записываются в файл журнала по пути bitrix/modules/abricos.upsell/logs/, отдельный файл на каждый день. Журнал полезен при отладке промпта — по нему видно, что именно ушло в нейросеть и что она вернула, если рекомендации выглядят нерелевантными или пришла ошибка обработки.

7. Вывод рекомендаций на сайте

Компонент abricos:upsell работает в двух режимах и всегда выводит товары через штатный компонент каталога сайта — bitrix:catalog.section с уже настроенным на проекте шаблоном. Именно поэтому важно правильно указать параметр CATALOG_TEMPLATE: с ним рекомендации отображаются в том же дизайне, что и весь остальной каталог — карточки товаров, кнопка «в корзину», цены выглядят так же, как на любой другой странице сайта, а не как чужеродная вставка. На решениях Aspro указывается соответствующий шаблон Aspro, на любом другом дизайне — тот, что уже используется в проекте.

Режим корзины — рекомендации по содержимому корзины пользователя, для страницы корзины или оформления заказа:

<?$APPLICATION->IncludeComponent(
    "abricos:upsell",
    ".default",
    array(
        "IBLOCK_TYPE" => "catalog",
        "IBLOCK_ID" => "1",
        "CATALOG_TEMPLATE" => "bootstrap_v4",
        "RECOMMENDATION_TYPES" => array("CROSS_SELL", "SIMILAR_PRICE"),
        "MAX_ITEMS" => "8"
    )
);?>

Режим карточки товара — рекомендации для конкретного товара, вне зависимости от корзины. Достаточно передать его ID через параметр FILTER (подходит и обычный товар, и торговое предложение — модуль сам найдёт родительский товар):

<?$APPLICATION->IncludeComponent(
    "abricos:upsell",
    ".default",
    array(
        "IBLOCK_TYPE" => "catalog",
        "IBLOCK_ID" => "1",
        "CATALOG_TEMPLATE" => "bootstrap_v4",
        "FILTER" => $arResult['ID'],
        "RECOMMENDATION_TYPES" => array("CROSS_SELL", "SIMILAR_PRICE", "SIMILAR_PROPERTIES"),
        "MAX_ITEMS" => "8"
    )
);?>

Основные параметры компонента:

Частые вопросы

Товары не обрабатываются. Проверьте, что агент зарегистрирован: Настройки → Производительность → Агенты, найдите агент модуля abricos.upsell. Убедитесь, что API-ключ и Folder ID заполнены верно. Включите логирование и посмотрите журнал запросов (см. раздел 6) — там будет видна конкретная ошибка.

Ошибка при загрузке в поисковый индекс. Убедитесь, что сервисный аккаунт имеет роль ai.editor и API-ключ активен, а среди выбранных инфоблоков есть активные товары.

Модель сообщает, что у неё нет доступа к поисковому индексу. Проверьте, что в настройках указана модель, поддерживающая вызов инструментов (например, yandexgpt, а не yandexgpt-lite), и что индекс в консоли Yandex Cloud имеет статус «completed».

Нужно пересчитать рекомендации для конкретного товара. Откройте его карточку в разделе «Рекомендации» и нажмите «Пересчитать рекомендации» — старые рекомендации удалятся, и нейросеть подберёт их заново сразу, без ожидания фонового агента.

Рекомендации на сайте выглядят не как остальной каталог. Проверьте параметр CATALOG_TEMPLATE в вызове компонента — он должен совпадать с шаблоном, которым выводится каталог на остальных страницах сайта.