Настройка модуля «AI Описание объявления»

Кнопка «Сгенерировать описание» в форме создания объявления. Использует OpenRouter (100+ моделей: GPT, Claude, Gemini, Llama). Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

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

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

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

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

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

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

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

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

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

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

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

• «OpenRouter API Key». Обязательное секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Ключ из openrouter.ai/keys (формат sk-or-...). Хранится в зашифрованных настройках модуля.
• «Максимум токенов». Секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Значение по умолчанию: 600. Лимит длины ответа. 600 ≈ 5 абзацев. Больше — длиннее текст и дороже запрос.
• «Модель». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: openai/gpt-4o-mini. Курируемый список из openrouter.ai. Модели с пометкой :free бесплатны (с лимитами 20 req/мин). Если нужна модель не из списка — оставьте пустым и впишите свой ID в поле «Своя модель» ниже.
• «Своя модель (опционально)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Если в списке выше нет нужной модели — впишите её ID в формате provider/model. Если поле непустое, то перекрывает выбор выше.
• «Rate-limit (секунды)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 30. Минимальный интервал между запросами от одного пользователя. По умолчанию 30 сек — защита от спама.
• «Название сайта». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Передаётся в OpenRouter как X-Title (опционально).
• «URL вашего сайта». Укажите полный адрес страницы, callback или webhook, который должен использовать внешний сервис. Передаётся в OpenRouter как HTTP-Referer для аналитики и rankings (опционально).
• «Системный промпт». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: Ты пишешь короткие продающие описания объявлений на русском языке для маркетплейса. Не выдумывай факты — пиши только о том что указано во входных данных. Не используй эмодзи. Не используй буллет-листы или markdown. Структура: 3-5 коротких абзацев. Тон: дружелюбный, конкретный, без воды.. Инструкция для модели. Менять только если нужен другой стиль/язык.
• «Температура». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 0.7. Случайность генерации (0.0 — детерминированный текст, 1.0 — творческий). Рекомендуется 0.7.

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

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

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

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

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

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