AI Отзывы Yandex GPT - Автогенерация отзывов в карточках товаров

Часть 1. Настройка в Yandex Cloud
Модуль использует YandexGPT через API Yandex Cloud. Для работы понадобятся два значения: API‑ключ и ID каталога (Folder ID).

Шаг 1. Регистрация в Yandex Cloud
Перейдите на console.yandex.cloud и войдите под аккаунтом Яндекса. Если платёжного аккаунта ещё нет — создайте его. Новым пользователям Яндекс предоставляет стартовый грант для тестирования. При первом входе платформа автоматически создаст облако и внутри него каталог default.

Шаг 2. Копирование ID каталога
В консоли выберите каталог default в дереве слева. Скопируйте идентификатор каталога из строки навигации сверху — это строка вида b1g4c5h7m2k9p3r6t8v0. Это ваш Folder ID.

Шаг 3. Создание сервисного аккаунта
В каталоге default перейдите во вкладку «Сервисные аккаунты». Нажмите «Создать сервисный аккаунт». Укажите имя, например aigptreviews. Назначьте роль ai.languageModels.user — это минимальная роль для вызова генеративных моделей. Нажмите «Создать».

Шаг 4. Получение API‑ключа
Откройте созданный сервисный аккаунт в списке. В верхней панели нажмите «Создать новый ключ» → «API‑ключ». Заполните параметры: описание — любое, например «Ключ для AI Отзывы»; область действия (scope) — выберите yc.ai.languageModels.execute; срок действия — можно не указывать (бессрочный). Нажмите «Создать». Сразу скопируйте значение ключа — после закрытия окна оно будет недоступно.

Важно: используйте именно API‑ключ (передаётся как Api‑Key), а не IAM‑токен. IAM‑токен живёт 12 часов и требует постоянного обновления, API‑ключ — бессрочный.

Шаг 5. Тарификация
YandexGPT тарифицируется по токенам. На 2026 год ориентировочные расценки: YandexGPT Pro — 1 рубль за 1000 входящих токенов и 2 рубля за 1000 исходящих; YandexGPT 5 Pro — 2 рубля за 1000 входящих и 6 рублей за 1000 исходящих. Бесплатный лимит — 10 запросов в час для моделей Lite и Pro. Один отзыв в среднем расходует 300–600 токенов, что при генерации 10 отзывов в день обойдётся в несколько рублей в месяц.

Часть 2. Настройка модуля
После установки откройте настройки модуля: «Веб‑сайт» → «Настройка модулей» → «AI Отзывы Yandex GPT».

Вкладка «Категории товаров»
Выберите категории товаров, для которых нужно генерировать отзывы. Удерживайте Ctrl (Cmd на Mac) для множественного выбора. Если не выбрано ни одной категории, отзывы генерируются для всех категорий. Подкатегории подтягиваются автоматически.

Вкладка «Настройки Yandex GPT»
Вставьте API‑ключ, полученный на шаге 4 в Yandex Cloud, в поле «API‑ключ Yandex GPT». Вставьте ID каталога, скопированный на шаге 2, в поле «ID Folder Yandex Cloud». В поле «Шаблон промта» укажите текст инструкции для нейросети. В нём можно использовать плейсхолдеры: {gender_instruction} задаёт пол автора, {context} подставляет название и описание товара, {existing_reviews} подставляет предыдущие отзывы. В поле «Человеческий фактор» (temperature) задайте значение от 0.1 (максимально предсказуемый результат) до 1.0 (максимально креативный). По умолчанию установлено 0.90. В поле «Максимум токенов» укажите длину отзыва. Значение 500 токенов соответствует примерно 350–400 словам. По умолчанию стоит 500.

Вкладка «Настройки генерации отзывов»
«Включить генерацию через планировщик» — глобальный переключатель работы модуля по cron.
«Включить расписание» — если опция отключена, отзывы будут генерироваться при каждом запуске планировщика без учета времени. Если включена — генерация происходит строго по текстовым правилам.
«Правила генерации» — текстовое поле, где каждое правило задается с новой строки в формате: [День 1-7] [Время ЧЧ:ММ-ЧЧ:ММ] [Лимит отзывов на товар в это правило] [Общий лимит всех отзывов в это правило] [Интервал в минутах генерации 1 отзыва]. Пример: 1 09:00-12:00 2 10 15 (понедельник, с 9 до 12, не более 2 отзывов на товар, не более 10 всего, публиковать раз в 15 минут). Где 1 — Понедельник, 7 — Воскресенье. Можно добавить несколько правил внутри каждого дня!
«Обрабатывать отключенные товары» — если включено, отзывы будут генерироваться и для товаров, снятых с публикации.
«Обрабатывать товары с 0 остатком» — если включено, отзывы будут генерироваться для товаров, которых нет в наличии.
Отметьте «Сразу публиковать на сайте», чтобы отзыв был виден сразу, или снимите чек, если требуется ручная модерация. В поле «Вероятность оценки 5 (%)» задайте процент отзывов с оценкой 5. Например, значение 80 означает, что 80 % отзывов будут с оценкой 5, а 20 % — с оценкой 4.
В настройках «Учитывать существующие отзывы» можно включить передачу предыдущих отзывов товара в промт, чтобы нейросеть не повторялась и поддерживала тему.

Вкладка «Ответы модератора на отзывы»
Включите опцию «Включить ответы модератора», чтобы система автоматически отвечала на отзывы, у которых ещё нет ответа. В поле «Частота ответов (минуты)» задайте минимальный интервал между ответами. Значение 0 означает, что ответы будут формироваться при каждом запуске cron. В поле «Шаблоны ответов» укажите варианты текстов — каждый с новой строки. Система будет выбирать их случайно. Для подстановки имени пользователя используйте плейсхолдер {user_name}.

По умолчанию доступны пять шаблонов ответов:
Здравствуйте, {user_name}! Спасибо за ваш отзыв. Мы рады, что вы остались довольны покупкой!
{user_name}, благодарим за обратную связь! Будем рады видеть вас снова в нашем магазине.
Спасибо за отзыв, {user_name}! Надеемся, что и дальнейшие покупки принесут вам только положительные эмоции.
Добрый день, {user_name}! Спасибо, что поделились своими впечатлениями. Ждём вас снова!
{user_name}, благодарим за отзыв! Рады, что товар вам понравился. Обращайтесь ещё!

Вкладка «Имена и логины для отзывов»
В разделе «Мужские имена» перечислите имена — каждое с новой строки. В разделе «Женские имена» сделайте то же самое. Имя выбирается случайно. Пол автора определяет гендерную окраску отзыва — система будет использовать мужской или женский род глаголов.

Управление полом авторов.
Вы можете включать или отключать использование мужских и женских имен с помощью чекбоксов «Использовать мужские имена» и «Использовать женские имена».
Если включены оба чекбокса, вы можете задать процентное соотношение в поле «Соотношение мужских и женских отзывов (%)». Например, значение 70 означает, что 70% отзывов будут написаны от мужчин, а 30% — от женщин. Это позволяет создавать естественную картину на витрине.
Если один из чекбоксов отключен (например, «Использовать женские имена»), то генерация будет идти 100% от того пола, который отмечен, а поле с процентами будет проигнорировано.

Часть 3. Просмотр логов
Все действия модуля записываются в системный лог ReadyScript. Перейдите в «Управление» → «Логи». Найдите лог «AI Отзывы: генерация». Доступна фильтрация по уровню: «Информация» — отзыв добавлен, лимит достигнут, ответ модератора отправлен; «Предупреждение» — нет подходящих товаров; «Ошибка» — не настроен API‑ключ, пустой ответ от Yandex GPT, ошибка сети. В настройках логирования («Управление» → «Настройка системы» → «Система логирования») можно отключить лишние уровни или ограничить размер файла лога.
В логи также выводится полный текст сгенерированного отзыва для удобства контроля.

Часть 4. Проверка работы
Убедитесь, что в настройках модуля заполнены API‑ключ и Folder ID. Проверьте, что списки имён не пустые. Запустите cron вручную через браузер. Проверьте лог в «Управление» → «Логи» — должна появиться запись «Отзыв добавлен для товара #…». Откройте карточку товара на витрине — отзыв должен отображаться, если включена автопубликация. Проверьте рейтинг товара — он должен пересчитаться с учётом нового отзыва.

Частые проблемы и их решения
Если появляется ошибка «Ошибка: не настроены API‑ключ или ID каталога», значит, эти поля в настройках пустые. Заполните их корректными значениями.

При ошибке «Ошибка: получен пустой ответ от Yandex GPT» API вернул ошибку либо был превышен лимит. Проверьте лог — там будет указана точная причина, например HTTP 429 или 401.

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

Сообщение «Пропуск: интервал публикации не прошел» означает, что с момента последнего отзыва прошло меньше времени, чем указано в 5-м параметре правила (интервал). Уменьшите интервал или подождите.

Если система сообщает «Нет подходящих товаров», это значит, что все товары достигли лимита, не попадают в выбранные категории, либо скрыты фильтрами (отключены или с нулевым остатком). Расширьте список категорий, увеличьте лимит на товар или включите обработку отключенных/пустых товаров.

Если отзывы не появляются на сайте, возможно, в настройках стоит значение 0 в поле «Сразу публиковать». Установите 1 для автопубликации либо опубликуйте отзывы вручную в разделе «Разное» → «Комментарии».

codmen-studio@yandex.ru
+7 9025880292 (Max)