AI-відгуки (OpenAI) — генерація відгуків до товарів

AI-відгуки (OpenAI) — автоматична генерація відгуків для товарів OpenCart

AI-відгуки (OpenAI) — модуль для OpenCart та ocStore, який автоматично створює відгуки до товарів за допомогою моделей OpenAI.

Модуль використовує назву товару, модель, виробника, опис, атрибути та налаштований промпт. На основі цих даних OpenAI генерує текст відгуку, ім’я автора й рейтинг.

Відгуки можна створювати для окремих товарів або масово — для всього каталогу, товарів без відгуків, вибраної категорії чи виробника. Для безпечної обробки великої кількості товарів використовується постійна черга завдань із покроковим AJAX-запуском та підтримкою cron.

Основні можливості модуля

• Генерація відгуків через OpenAI Responses API
• Автоматичне створення тексту відгуку, імені автора та рейтингу
• Вибір моделі OpenAI зі списку
• Налаштовувана системна інструкція
• Власний шаблон промпту для товару
• Використання назви, моделі, виробника, опису й атрибутів товару
• Генерація відгуків однією або декількома мовами
• Випадковий вибір мови для кожного відгуку
• Випадкова кількість відгуків для кожного товару в заданому діапазоні
• Випадкова дата та час відгуку в заданому діапазоні
• Автоматична або ручна публікація відгуків
• Масове додавання товарів до черги
• Покрокова обробка черги без тривалого PHP-процесу
• Автоматична фонова обробка через cron
• Повторні спроби після помилок API
• Захист від завислих завдань
• Контроль повторення імен авторів і текстів відгуків
• Перегляд, редагування, увімкнення та видалення згенерованих відгуків

Використання інформації про товар

Модуль автоматично отримує інформацію про товар із бази даних OpenCart і використовує її для формування запиту до OpenAI.

У шаблоні промпту можна використовувати такі змінні:

• {name} — назва товару
• {model} — модель товару
• {manufacturer} — виробник або бренд
• {description} — опис товару без HTML-розмітки
• {attributes} — атрибути та характеристики товару
• {language} — мова поточного відгуку

Бажаний діапазон рейтингу можна вказати звичайним текстом безпосередньо у промпті, наприклад: «Бажаний рейтинг: від 3 до 5».

Якщо для товару відсутній виробник, опис або атрибути, модуль передає доступні дані. Рекомендується не вимагати від моделі згадування характеристик, яких немає в інформації про товар.

Гнучке налаштування OpenAI

• OpenAI API key
• Вибір моделі зі списку
• Налаштування Temperature
• Максимальна кількість вихідних токенів
• Налаштування Reasoning effort
• Тайм-аут одного API-запиту
• Кількість повторних спроб після помилки
• Пауза між API-запитами
• Кількість завдань за один запуск cron
• Секретний ключ доступу до cron
• Системна інструкція для всіх відгуків
• Окремий шаблон завдання для товару
• Додаткова інструкція для формування імені автора

Для моделей із reasoning модуль враховує, що внутрішні reasoning-токени також можуть використовувати встановлений ліміт відповіді. Якщо reasoning увімкнено, модуль автоматично використовує не менше 1000 вихідних токенів.

Для звичайної генерації коротких відгуків рекомендовано використовувати значення Reasoning effort: none або low.

Налаштування мови відгуків

У загальних налаштуваннях можна вказати одну або декілька мов через кому.

Приклад: Українська, Русский, English

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

Контроль рейтингу

Рейтинг формується моделлю OpenAI відповідно до інструкції у промпті. Модуль приймає лише значення від 1 до 5.

Для керування рейтингом достатньо додати до шаблону промпту потрібну умову:

• Бажаний рейтинг: від 3 до 5
• Бажаний рейтинг: від 4 до 5
• Бажаний рейтинг: 5

Окрема змінна {rating} не використовується.

Кількість відгуків для товару

Під час додавання товарів до масової черги можна встановити діапазон кількості відгуків для кожного товару.

• Від 3 до 5 — для кожного товару буде випадково створено 3, 4 або 5 завдань
• Від 3 до 3 — для кожного товару буде створено рівно 3 завдання
• Від 1 до 1 — один відгук для кожного товару

Кожен відгук обробляється окремим завданням черги. Це дозволяє повторити лише невдале завдання, не запускаючи генерацію всього набору повторно.

Налаштування дати відгуків

У модулі можна встановити початкову та кінцеву дату для нових відгуків.

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

• Нижня межа дати відгуку
• Верхня межа дати відгуку
• Випадковий час протягом вибраного дня
• Автоматичне виправлення діапазону, якщо початкова дата більша за кінцеву

Запобігання повторенню імен

Модуль може передавати OpenAI список раніше використаних імен авторів. Модель отримує інструкцію не повторювати ці імена під час створення нового відгуку.

У налаштуваннях можна вказати максимальну кількість останніх унікальних імен, що передаються моделі.

• Більше значення зменшує ймовірність повторення імен
• Менше значення скорочує витрати вхідних токенів
• Значення 0 повністю вимикає передачу використаних імен

Для більш природного результату модуль може генерувати повні імена, скорочені форми, імена з ініціалами та інші доречні варіанти відповідно до мови відгуку.

Запобігання повторенню текстів

Для зменшення схожості нових відгуків модуль може передавати OpenAI останні тексти відгуків до поточного товару.

• Можна налаштувати кількість попередніх відгуків, що передаються моделі
• Передаються лише останні відгуки до конкретного товару
• Довжина кожного переданого тексту обмежується
• Модель отримує інструкцію не повторювати фрази, структуру, початок і завершення
• Для кожного нового відгуку вибирається окремий тематичний напрям
• Значення 0 вимикає передачу попередніх відгуків

Збільшення кількості переданих текстів покращує контроль повторів, але підвищує витрати вхідних токенів OpenAI.

Тематичні напрями відгуків

Щоб відгуки до одного товару не відрізнялися лише окремими словами, модуль автоматично змінює рекомендований напрям тексту.

Можливі напрями:

• Перше враження та причина вибору товару
• Повсякденне використання та зручність
• Якість виготовлення та матеріалів
• Пакування, доставка та перше налаштування
• Відповідність очікуванням покупця
• Конкретний практичний сценарій використання
• Корисна деталь, помічена під час користування
• Співвідношення якості та вартості
• Простота налаштування, догляду чи обслуговування
• Рекомендація для певного типу покупця

Додавання товарів до черги

Модуль дозволяє додавати до черги як окремий товар, так і групу товарів за заданими умовами.

• Один вибраний товар
• Товари без відгуків
• Усі товари магазину
• Товари вибраної категорії
• Товари вибраного виробника
• Тільки увімкнені товари
• Тільки вимкнені товари
• Товари з будь-яким статусом
• Фільтр за початковою датою створення товару
• Фільтр за кінцевою датою створення товару
• Діапазон кількості відгуків для кожного товару

Окремий товар можна знайти за назвою або моделлю через стандартне автодоповнення OpenCart.

Черга генерації

Кожен майбутній відгук зберігається як окреме завдання у постійній черзі бази даних. Для черги передбачена пагінація. Кількість рядків на сторінці визначається налаштуванням config_limit_admin у OpenCart. Якщо значення відсутнє або дорівнює нулю, використовується 20 рядків на сторінці.

Стани завдань

• pending — завдання очікує на обробку
• processing — завдання обробляється
• retry — сталася помилка, завдання очікує повторної спроби
• done — відгук успішно створено
• failed — вичерпано дозволену кількість повторних спроб

Якщо завдання залишилося у стані processing через аварійне завершення PHP-процесу, через 15 хвилин модуль автоматично повертає його до стану повторної обробки.

Керування чергою

• Видалення окремого завдання
• Очищення всієї черги
• Захист активного завдання від видалення під час обробки
• Пагінація списку завдань
• Відображення повідомлення останньої помилки
• Повторна автоматична обробка після тимчасової помилки

Покрокова ручна обробка

При натисканні кнопки запуску модуль не намагається обробити всю чергу одним PHP-запитом.

Замість цього використовується покрокова AJAX-обробка:

1. Браузер запускає обробку одного завдання
2. Модуль генерує та зберігає один відгук
3. Оновлюється індикатор прогресу
4. Браузер автоматично запускає наступне завдання
5. Процес продовжується, доки не буде оброблено всі доступні завдання

Індикатор прогресу

На вкладці масової черги відображається індикатор поточного прогресу.

• Кількість завдань, що очікують
• Кількість завдань, які обробляються
• Кількість успішно завершених завдань
• Кількість завдань із помилками
• Загальний відсоток завершення черги

Після кожного AJAX-запиту індикатор оновлюється без повного перезавантаження сторінки.

Автоматична обробка через cron

У налаштуваннях модуль автоматично формує готовий cron URL і команду для crontab. Рекомендована частота запуску cron залежить від кількості товарів, лімітів OpenAI API та налаштованого розміру пакета. Для поступової постійної обробки черги зазвичай достатньо запуску один раз на хвилину.

Повторні спроби після помилок

Якщо OpenAI API тимчасово недоступний, перевищено ліміт запитів або відповідь не містить коректних структурованих даних, завдання не видаляється.

• Кількість повторних спроб налаштовується
• Текст помилки зберігається у черзі
• Після вичерпання спроб завдання отримує стан failed

Керування згенерованими відгуками

Для створених модулем відгуків передбачена окрема вкладка в адміністративній частині.

• Перегляд списку згенерованих відгуків
• Відображення товару й автора
• Відображення рейтингу та статусу
• Відображення дати створення відгуку
• Відображення використаної моделі OpenAI
• Відображення кількості вхідних і вихідних токенів
• Редагування автора, тексту, рейтингу та статусу
• Редагування в модальному вікні без перезавантаження сторінки
• Швидке увімкнення або вимкнення відгуку
• Зелена кнопка для увімкненого відгуку
• Червона кнопка для вимкненого відгуку
• Видалення окремого відгуку
• Масове видалення всіх згенерованих відгуків
• Пагінація списку відгуків

Модуль дозволяє редагувати та видаляти через власний інтерфейс лише ті відгуки, які були створені ним і зареєстровані в таблиці згенерованих відгуків. Звичайні відгуки покупців не змінюються.

Публікація відгуків

У налаштуваннях можна вибрати початковий статус нових відгуків.

• Увімкнено — відгук одразу стає доступним у магазині
• Вимкнено — відгук зберігається для попередньої перевірки адміністратором

Статус можна змінити в будь-який момент зі списку згенерованих відгуків або в модальному вікні редагування.

Збереження відгуків

Готові відгуки зберігаються у стандартній таблиці відгуків OpenCart. Тому вони сумісні зі стандартною системою відображення та керування відгуками.

Використання токенів

Вартість одного запиту залежить від вибраної моделі, довжини опису товару, атрибутів, промпту, кількості переданих імен і попередніх відгуків.

Для керування витратами передбачені окремі налаштування:

• Максимальна кількість вихідних токенів
• Кількість імен для контролю повторів
• Кількість попередніх відгуків до товару
• Рівень reasoning
• Вибір моделі OpenAI

Для економії токенів можна зменшити кількість переданих імен і відгуків або встановити значення 0. Для коротких товарних відгуків зазвичай не потрібен високий рівень reasoning.

Вартість використання OpenAI API

Важливо: генерація відгуків виконується через платний OpenAI API. Вартість використання API не входить до вартості модуля та сплачується власником магазину безпосередньо компанії OpenAI.

Фактична вартість залежить від:

• Вибраної моделі OpenAI
• Кількості вхідних токенів
• Кількості вихідних і reasoning-токенів
• Довжини описів і атрибутів товарів
• Кількості переданих імен і попередніх відгуків
• Кількості створених відгуків

Тарифи, доступність моделей, ліміти та правила білінгу можуть змінюватися. Актуальна інформація доступна на офіційній сторінці: OpenAI API Pricing.

Переваги використання

• Автоматизація підготовки контенту для великого каталогу
• Масова генерація без запуску одного тривалого PHP-процесу
• Гнучкий вибір товарів для обробки
• Використання реальної інформації про товар
• Власні промпти та правила генерації
• Підтримка декількох мов
• Контроль дат, рейтингів і статусу публікації
• Зменшення повторення імен і текстів
• Ручна та автоматична обробка черги
• Редагування результату перед публікацією
• Облік використаних токенів
• Використання стандартної системи відгуків OpenCart

Безпека

• Cron URL захищений окремим секретним ключем
• Для AJAX-операцій перевіряються права адміністратора
• Коли модуль вимкнений, cron-генерація блокується
• Через інтерфейс модуля редагуються лише створені ним відгуки

Сумісність

• OpenCart 3.x
• ocStore 3.x
• Стандартна система відгуків OpenCart
• Стандартний адміністративний інтерфейс OpenCart 3
• Українська, англійська та російська локалізації

Модуль не змінює шаблон сторінки товару. Відображення відгуків у каталозі виконується засобами встановленого шаблону OpenCart.

Системні вимоги

• PHP 7.2 або новіша сумісна версія
• PHP cURL
• PHP JSON
• Рекомендовано PHP mbstring
• Можливість вихідних HTTPS-запитів до api.openai.com
• Обліковий запис OpenAI
• Активний OpenAI API key
• Позитивний баланс або активний білінг OpenAI API
• Cron на сервері або в панелі хостингу — для автоматичної обробки

Важливі обмеження

• Результат залежить від вибраної моделі, промпту та інформації про товар
• Модуль не гарантує однаковий результат при повторній генерації
• OpenAI може відмовитися виконувати окремі запити відповідно до своїх правил
• Доступність моделей залежить від облікового запису та регіону OpenAI
• Ліміти запитів визначаються рівнем використання OpenAI API
• Збільшення контексту і кількості попередніх відгуків підвищує витрати токенів
• Згенерований текст рекомендується перевірити перед публікацією
• Модуль не може перевірити фактичний досвід використання товару реальним покупцем

Встановлення

1. Завантажте архів через розділ «Розширення → Встановлення розширень»
2. Перейдіть до розділу «Розширення → Модифікатори» та оновіть кеш модифікаторів
3. Відкрийте «Розширення → Розширення → Модулі»
4. Встановіть модуль AI-відгуки (OpenAI)
5. Відкрийте налаштування модуля
6. Вкажіть OpenAI API key
7. Виберіть модель і параметри генерації
8. Перевірте системний і товарний промпти
9. Встановіть мову, діапазон дат і статус нових відгуків
10. Увімкніть модуль і збережіть налаштування
11. За потреби додайте сформовану cron-команду в панелі хостингу

Ліцензія

Одна ліцензія поширюється на один домен і його піддомени.

Послуги OpenAI API, оплата використаних токенів, поповнення балансу OpenAI, налаштування стороннього хостингу, сервера або cron не входять до вартості ліцензії модуля.

Адаптація під нестандартну адміністративну панель, змінену структуру бази даних або сторонню систему відгуків виконується окремо.