Описание товара по характеристикам
Задача: у товаров заполнены название и свойства (бренд, объём, размеры, цвет), а описаний нет. Нужно, чтобы нейросеть написала детальное описание для карточки и короткое превью для списка товаров.
Сложность: легко. Шагов: 2.
Тогда этот рецепт не нужен: анонс из готового детального описания делается одним шагом — см. пошаговую настройку или разбор «Анонс вручную».
Что получится
- До
- После
Карточка в каталоге бытовой техники:
| Поле | Значение |
|---|---|
| Наименование | Холодильник двухкамерный NordFrost 350 |
| Бренд | NordFrost |
| Общий объём | 350 л |
| Система разморозки | No Frost |
| Класс энергопотребления | A+ |
| Высота | 185 см |
| Цвет | белый |
| Анонс | пусто |
| Детальное описание | пусто |
Анонс (шаг 2):
Двухкамерный холодильник NordFrost на 350 литров с системой No Frost: не нужно размораживать вручную, а класс A+ помогает экономить электроэнергию в семье из трёх–четырёх человек.
Детальное описание (шаг 1, фрагмент):
NordFrost 350 — двухкамерный холодильник для семьи, которой нужен вместительный и неприхотливый в уходе прибор. Общий объём 350 литров позволяет хранить запас продуктов на неделю…
Система No Frost избавляет от ручной разморозки: иней не нарастает на стенках…
Тексты выше — пример. Ваша модель напишет по-своему, но в рамках тех же правил.
Настройки
- Профиль с типом данных «Элемент инфоблока» и вашим каталогом товаров как источником — см. Источник данных.
- Фильтр — по стабильному признаку, например по разделу каталога. Не пытайтесь отобрать «товары без описания» фильтром — объяснение в рецепте «Автогенерация для новых товаров».
- Модель — любая текстовая модель провайдера, например GigaChat-2-Pro или модель из каталога Polza.ai — см. Выбор модели. Для описаний не нужны дорогие «рассуждающие» модели.
Шаги конвейера
Порядок важен: сначала детальное описание, потом превью по нему. Так превью опирается на готовый текст, и вам не нужно второй раз отправлять в модель все свойства товара.
Шаг 1. Детальное описание
На странице «Конвейер» нажмите «Добавить шаг», выберите пресет «Описание товара» и нажмите «Создать шаг». Пресет сам включит чистку ответа, проверки «Формат — HTML» и «Язык ответа — русский», «Сохранять как — HTML» и подставит поле «Детальное описание».
Промпт пресета описывает товар по названию, анонсу и текущему описанию. Чтобы модель писала по свойствам, замените задание текстом ниже. Его основа — промпт коллекции «Товар: детальное описание» и дополнение «Формат: HTML-фрагмент Битрикса». Исходный промпт можно посмотреть на странице «Коллекция промптов»:
Подставить его в шаг можно, не копируя: в блоке «Запрос» нажмите «Редактировать», затем «Коллекция» → «Выбрать промпт» и найдите нужный по названию или тегу. «Выбрать промпт» заменяет текущее задание целиком, «Вставить промпт» добавляет текст в позицию курсора.
Готовое задание, доработанное под карточку со свойствами:
Ты — копирайтер интернет-магазина. На основе исходных данных ниже напиши детальное описание товара для карточки. Текст ориентирован на покупателя, без воды и канцеляризмов.
Товар: {{field:NAME}}
Бренд / производитель: [@ Бренд]
Исходные данные о товаре:
- Общий объём: [@ Общий объём]
- Система разморозки: [@ Система разморозки]
- Класс энергопотребления: [@ Класс энергопотребления]
- Высота: [@ Высота]
- Цвет: [@ Цвет]
Требования:
- Объём: 250–400 слов.
- Формат: связный текст, 3–5 абзацев. Никаких маркированных списков и заголовков.
- Структура смысла: 1) что это и для кого; 2) ключевые особенности и характеристики; 3) сильные стороны; 4) ограничения и для кого НЕ подойдёт (если из данных это видно); 5) короткий вывод.
- Не выдумывай характеристики, которых нет в исходных данных. Если факт сомнительный — не упоминай его вовсе.
- Не используй штампы «лучший на рынке», «непревзойдённое качество», «инновационный» и подобные оценочные слоганы.
- Не пиши заголовков, не начинай со слова «Описание:».
Сформируй ответ в виде HTML-фрагмента: каждый абзац оберни в <p>...</p>. Не вставляй <html>, <head>, <body>, стили, классы и ссылки. Не оборачивай ответ в Markdown-код-блок.
Верни только готовый текст описания.
Если у части товаров, например, не указан цвет, оберните строку в условный блок: {IF [@ Цвет]}- Цвет: [@ Цвет]{/IF}. Пустое свойство тогда просто выпадет из промпта, и модель не станет додумывать. В редакторе блок IF вставляется отдельной карточкой — см. Подстановки.
Роль модели — оставьте ту, что подставил пресет. Она запрещает выдумывать характеристики и штампы и требует отвечать только HTML-фрагментом.
Обработка ответа. Пресет уже настроил блок — откройте его кнопкой «Изменить», если нужно что-то добавить:
| Что | Значение |
|---|---|
| Перед проверкой очистить ответ | «Убрать обёртку ```html» и «Оставить только содержимое <body>, если пришла целая HTML-страница» — по пресету |
| Принимать ответ, только если | «Формат» — HTML; «Язык ответа» — русский (по пресету). Добавьте «Длина» от 200 до 450 слов |
| Если ответ не прошёл | Остановить |
Как только вы меняете настройки пресета, у блока появляется отметка «Изменено», а кнопка «Вернуть как в пресете» откатит правки.
Запись результата:
| Что | Значение |
|---|---|
| Поле | Детальное описание (подставил пресет) |
| Если в поле уже что-то есть | Не трогать — пресет ставит «Заменить», переключите, чтобы не затереть описания, написанные вручную |
| Сохранять как | HTML |
| Проверять вручную перед записью | включить на первые прогоны |
Шаг 2. Превью для каталога
«Добавить шаг» → «Пустой шаг» → «Создать шаг». В задание вставьте промпт коллекции «Товар: превью-описание» и замените заглушку в квадратных скобках плашкой ответа шага 1 из группы «Результаты шагов» — в тексте ниже это {{step:1}}.
Напиши краткое превью-описание товара для списка/каталога на основе данных ниже.
Товар: {{field:NAME}}
Детальное описание или ключевые факты: {{step:1}}
Требования:
- 1–2 коротких предложения, 25–40 слов.
- Сразу по делу: что это, ключевая выгода для покупателя.
- Без штампов «лучший», «инновационный», «непревзойдённый».
- Без заголовков, маркеров, кавычек по краям.
Верни только текст превью.
| Настройка | Значение |
|---|---|
| Проверки | «Длина» от 20 до 50 слов; «Формат» — текст |
| Если ответ не прошёл | Остановить |
| Поле | Анонс |
| Если в поле уже что-то есть | Не трогать |
| Сохранять как | Текст |
В правой колонке шага, в блоке «Цепочка данных», видно, что шаг 2 берёт ответ шага 1, а у шага 1 — что его результат читает шаг 2.
Как протестировать
- Откройте «Тестирование», в поле «Сущность» выберите товар с полным набором свойств.
- Нажмите «Предпросмотр» у шага 1 — проверьте, что вместо плашек подставились реальные значения. Это бесплатно: модель не вызывается.
- Нажмите «Запустить тест» — увидите ответ каждого шага, сработавшие проверки и расход токенов.
- Повторите на товаре с почти пустыми свойствами: именно там видно, нужны ли условные блоки.
Подробнее — Тестирование.
Сколько стоит
Два запроса к модели на товар. Детальное описание — самый «тяжёлый» шаг: в него уходят промпт и свойства, а возвращается текст на 250–400 слов. Превью короткое и почти ничего не добавляет. Точный расход одного товара покажет тестовый прогон, итог на каталог считается так:
расход одного товара × число товаров в фильтре
У Polza.ai, OpenRouter и DeepSeek модуль показывает стоимость в деньгах. У GigaChat цен в каталоге нет — стоимость отображается как 0, а расход виден в токенах. Подробнее — Стоимость генерации.
Типичные ошибки
| Симптом | Причина и решение |
|---|---|
| Модель приписывает товару несуществующие функции | В промпте мало данных. Добавьте свойства плашками и не убирайте из задания строку «Не выдумывай характеристики…» |
| В описании «Бренд: » без значения | У товара пустое свойство. Оберните строку в условный блок IF |
| Ответ отклонён проверкой «Формат — HTML» | Модель вернула текст без тегов. Оставьте в задании абзац про <p>...</p> или переключите формат на «текст», а «Сохранять как» — на «Авто» |
| Превью пустое или не записалось | Шаг 1 не прошёл проверку с действием «Пропустить шаг» — шаги, читающие его результат, получают пустоту. Откройте товар на странице «Элементы» → «История прогонов» и посмотрите, на чём споткнулся шаг 1. См. Диагностика |
| Ручные описания затёрлись | В шаге остался режим «Заменить» из пресета. Для существующих текстов используйте «Не трогать»; ошибочную запись можно вернуть кнопкой «Откатить» — см. Проверка и откат результата |