Настройка модуля «AI Блог — генерация статей»

Модуль «AI Блог — генерация статей» автоматизирует работу с контентом и данными. Его стоит включать там, где владелец площадки хочет ускорить модерацию, описание, поиск или рекомендации без ручной обработки каждого объекта.

Когда стоит подключать модуль

• Площадкам с большим объемом объявлений, изображений, описаний или пользовательского контента.
• Командам, которым нужно ускорить рутинные операции, но сохранить контроль администратора.
• Владельцам, которые хотят сначала проверить качество результата на тестовых данных.

Что изменится на сайте

• Модуль помогает обрабатывать текст, изображения, рекомендации, поиск или модерацию быстрее ручного сценария.
• Администратор может проверить результат на тестовых объектах до массового применения.
• Площадка получает более стабильное качество рутинных операций.
• Команда заранее определяет, где нужен автоматический результат, а где нужна проверка человеком.

Что подготовить заранее

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

• Определите, где именно модуль должен работать: объявления, блог, модерация, рекомендации, поиск или изображения.
• Подготовьте несколько тестовых объектов без персональных и коммерчески чувствительных данных.
• Проверьте лимиты, стоимость обработки и правила хранения данных у внешнего сервиса, если он используется.
• Заранее решите, какие результаты можно публиковать автоматически, а какие должен подтвердить администратор.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «AI Блог — генерация статей» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

В настройках модуля заполняйте только те значения, которые относятся к вашему проекту. Секретные ключи храните в защищенных полях и не переносите их в открытые тексты, письма или инструкции для пользователей.

• «OpenRouter API Key (текст)». Обязательное секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Ключ из openrouter.ai/keys (sk-or-...). Хранится в зашифрованных настройках.
• «Изображений по умолчанию». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 0. Сколько картинок генерировать, если не задано в запросе. 0 — без картинок.
• «Длина статьи по умолчанию (символы)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 4000. Целевой объём основного текста. Можно переопределить в запросе.
• «API Key image-сервиса». Секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Ключ сервиса генерации изображений. Нужен только если включены картинки.
• «URL image-сервиса». Укажите полный адрес страницы, callback или webhook, который должен использовать внешний сервис. Значение по умолчанию: https://api.openai.com/v1/images/generations. Любой OpenAI-Images-совместимый эндпоинт (OpenAI, kie.ai и др.).
• «Модель изображений». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: gpt-image-1. ID image-модели у выбранного сервиса.
• «Размер изображений». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 1024x1024.
• «Максимум изображений на статью». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 5. Жёсткий потолок (защита от трат).
• «Максимум токенов ответа». Секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Значение по умолчанию: 4000. Лимит длины ответа модели. Больше — длиннее статья и дороже запрос.
• «Модель (текст)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: openai/gpt-4o-mini. :free модели бесплатны с лимитами. Для своей модели оставьте пустым и впишите ID ниже.
• «Своя модель (опционально)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. ID в формате provider/model. Непустое поле перекрывает выбор выше.
• «Rate-limit (секунды)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 60. Минимальный интервал между генерациями одного пользователя.
• «Название сайта». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Передаётся в OpenRouter как X-Title (опционально).
• «URL сайта». Укажите полный адрес страницы, callback или webhook, который должен использовать внешний сервис. Передаётся в OpenRouter как HTTP-Referer (опционально).
• «Системный промпт (стиль статьи)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Инструкция для модели. Оставьте пустым для дефолтного SEO-промпта. Модель обязана вернуть строгий JSON статьи.
• «Температура». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 0.7. 0.0 — детерминированно, 1.0 — творчески. Рекомендуется 0.7.

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

Проверка перед запуском

• Запустите модуль на тестовом тексте, изображении, объявлении или подборке данных.
• Сравните результат с правилами площадки и ожиданиями администратора.
• Проверьте, что пользователь видит понятный статус, если обработка занимает время.
• Протестируйте негативный пример: пустые данные, запрещенный текст или неподходящее изображение.

Частые ошибки

• Результат пустой. Проверьте входные данные, лимиты и доступ к внешнему сервису.
• Обработка идет слишком долго. Уменьшите объем тестовых данных и проверьте очередь задач.
• Модуль применяет действие слишком широко. Уточните категории, роли и правила запуска.
• Результат требует контроля. Включите ручную проверку перед публичной публикацией результата.

Когда тест проходит без ошибок, оставьте модуль включенным и зафиксируйте, какие данные использовались для проверки. Это поможет быстро восстановить настройку после обновления или смены ключей.