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

Требования

[*]1С-Битрикс, главный модуль версии 18 и выше (модуль построен на технологии D7);
[*]PHP 8.2 и выше, расширение PHP curl;
[*]Модуль «Информационные блоки» (iblock);
[*]Модуль «Каталог» (catalog) — для получения цен;
[*]Аккаунт в Yandex Cloud с доступом к AI Studio.

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

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

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

[*]создаются две таблицы в базе данных — для хранения рекомендаций и статуса обработки товаров;
[*]регистрируется компонент abricos:upsell для вывода рекомендаций на сайте;
[*]регистрируется агент, который каждые 2 минуты в фоне обрабатывает товары.

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

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

[*]Войдите в консоль Yandex Cloud и создайте (или выберите существующий) каталог — folder;
[*]Скопируйте Folder ID — он отображается на странице каталога;
[*]В разделе IAM → Сервисные аккаунты создайте сервисный аккаунт с ролью ai.editor;
[*]Создайте для него API-ключ в разделе «Ключи доступа».

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

Поле	Описание
API ключ Yandex AI Studio	API-ключ созданного сервисного аккаунта
Folder ID Yandex Cloud	Идентификатор каталога (folder) в Yandex Cloud
Модель Yandex AI Studio	Название модели, например yandexgpt. Для работы с поисковым индексом модель должна поддерживать вызов инструментов — рекомендуется полная версия модели, а не lite
Промпт для AI	Инструкция для нейросети — как именно подбирать рекомендации, можно редактировать под свой каталог
Инфоблоки для обработки	Инфоблоки с товарами, которые нужно проанализировать
Включить логирование	Сохраняет журнал запросов к AI — см. раздел «Логи» ниже

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"
    )
);?>

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

Параметр	Описание
IBLOCK_TYPE, IBLOCK_ID	Инфоблок каталога товаров
FILTER	ID товара для режима карточки товара. Если не указан — работает режим корзины
RECOMMENDATION_TYPES	Какие типы рекомендаций выводить: CROSS_SELL, SIMILAR_PRICE, SIMILAR_PROPERTIES
MAX_ITEMS	Максимальное количество товаров в блоке рекомендаций
CATALOG_TEMPLATE	Шаблон компонента bitrix:catalog.section, которым выводятся товары. Указывайте тот же шаблон, что уже используется в каталоге сайта, — тогда блок рекомендаций визуально не будет отличаться от остального каталога
SHOW_BLOCK_TITLE, BLOCK_TITLE	Показывать ли заголовок блока рекомендаций и его текст

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

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

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

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

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

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

Техподдержка на связи в рабочие дни с 6 до 15 МСК.

Техподдержка отвечает на запросы в Телеграмм @AbricosSupport_bot.
Срок реакции на обращения - 24 часа (в рабочие дни).