Инструкция к модулю AI (GPT) ассистент для работы с товарами и категориями

Модуль добавляет в админку инструменты генерации контента для товаров и категорий. Через внешний AI-сервис он заполняет описания, SEO-поля и запускает генерацию видео по выбранному изображению товара.

Что делает модуль

- генерирует описание товара и категории;
- генерирует SEO title и meta description;
- запускает массовую генерацию для выбранных товаров и категорий;
- позволяет очистить описание и SEO-поля у выбранных сущностей через backend-обработчики;
- запускает генерацию видео по изображению товара;
- сохраняет ID задачи, статус, сообщения сервиса, callback-ответ и ссылку на готовое видео;
- добавляет готовое видео в данные товара для отображения на витрине;
- показывает вкладки с инструкцией, полным описанием и changelog в карточке модуля.

Где находится модуль

- Администрирование → Модули → Управление модулями → AI (GPT) ассистент для работы с товарами и категориями — карточка модуля, вкладки инструкции, описания и изменений;
- Администрирование → Модули → Управление модулями → Настройки — секция Основные, поле Промпт для генерации видео по изображению;
- Администрирование → Товары → Товары → карточка товара — кнопки генерации описания, SEO и видео;
- Администрирование → Товары → Категории → карточка категории — кнопка генерации описания и SEO;
- списки товаров и категорий — действие Загрузить описание и SEO в контекстном меню выбранных строк.

Как настроить

1. Откройте настройки модуля.
2. Если планируете использовать видео, проверьте поле Промпт для генерации видео по изображению. По умолчанию используется промпт для короткого реалистичного продуктового видео без текста, логотипов и водяных знаков.
3. Убедитесь, что магазин доступен внешнему AI-сервису: для массовой генерации и видео сервис должен получить домен магазина, а для видео — отправить callback на публичный HTTPS-адрес магазина.
4. Для генерации видео заранее добавьте товару хотя бы одно изображение.

Как пользоваться

Описание товара
1. Откройте карточку товара.
2. В блоке полного описания нажмите Загрузить описание.
3. После ответа сервиса проверьте текст в поле полного описания перед сохранением товара.

SEO товара
1. Откройте карточку товара.
2. Нажмите Загрузить SEO.
3. Проверьте заполненные поля SEO title и meta description.

Описание и SEO категории
1. Откройте карточку категории.
2. Нажмите Загрузить описание и SEO.
3. Если у категории заполнены ключевые слова, модуль добавит их в промпт для генерации описания и SEO.

Массовая генерация
1. В списке товаров или категорий отметьте нужные строки.
2. В контекстном меню выберите Загрузить описание и SEO.
3. Дождитесь уведомления о запуске или завершении обработки и выборочно проверьте несколько обновлённых сущностей.

Генерация видео
1. Откройте карточку товара с изображениями.
2. Нажмите Сгенерировать видео.
3. В появившемся окне выберите изображение товара и подтвердите запуск.
4. Модуль отправит изображение, промпт, домен магазина и callback URL во внешний сервис.
5. Статус задачи будет обновляться в карточке товара. Когда сервис вернёт ссылку на готовый ролик, она появится в блоке видео и будет доступна для отображения на витрине.

Как проверить работу

- после генерации у товара или категории заполнены описание и SEO-поля;
- массовое действие применилось только к выбранным товарам или категориям;
- при генерации видео в карточке товара появился статус задачи;
- после callback или проверки статуса в карточке товара появилась ссылка на готовое видео;
- на витрине у товара с завершённой генерацией отображается добавленное видео.

Если что-то не работает

- проверьте, что у товара есть изображение: без изображения кнопка видео не сможет выбрать файл для отправки;
- проверьте доступ магазина к внешнему AI-сервису и доступность публичного HTTPS callback URL;
- проверьте поле промпта видео, если сервис возвращает неподходящий результат;
- если статус видео не меняется, откройте карточку товара позже: модуль дополнительно опрашивает сервис и сохраняет callback-ответы;
- если массовая генерация не заполнила поля, проверьте уведомления админки и доступность сервиса генерации.