Основная задача модуля:Генерация текстовых данных для элементов и разделов инфоблока: описания, анонсы, SEO-поля, переводы, значения свойств и любые другие текстовые или числовые поля (UF поля для разделов). Модуль выступает прозрачным посредником между вашими данными и нейросетью.
Он не диктует шаблон генерации и не «думает» сам — вы полностью определяете промпт, модель LLM и поле куда записывать результат.
Качество текстов зависит от выбранной модели и промпта; модуль гарантирует надёжное соединение, переиспользование данных карточки и контролируемую запись результата.
ВАЖНО! Демо-версия модуля ограничена 500 генерациями. 1 генерация = 1 запрос к провайдеру. После достижения лимита вы увидите соответствующее сообщение в логах модуля.---
Основные особенностиС какими данными работает- Источник данных —
элементы или разделы инфоблока Битрикс. В рамках профиля выбирается один конкретный инфоблок.
- Выборка элементов или разделов отбирается
фильтром и
выбором разделов инфоблока.
- Запись результата идёт в
стандартные поля,
свойства инфоблока или
SEO-шаблоны.
- В очередь элемент или раздел попадает двумя способами:
вручную или при создании \ обновлении элемента, если он подходит под фильтр.
Как взаимодействует с провайдерами- Модуль
не берёт отдельную плату за генерацию. Оплата за токены идёт напрямую вашему провайдеру нейросети — модуль выступает в роли коннектора.
Сейчас поддерживаются три варианта подключения:
Polza.ai — российский агрегатор LLM с оплатой в рублях, без зарубежной карты и VPN; доступны GPT, Claude, DeepSeek, Gemini и другие модели; веб-поиск работает на всех моделях.
OpenRouter — зарубежный агрегатор с самым большим каталогом моделей (сотни моделей, включая редкие и новейшие); универсальный плагин веб-поиска с фильтром доменов.
Кастомный OpenAI-совместимый эндпоинт — любой собственный или корпоративный шлюз LLM, локальная модель или иной провайдер. Идентификатор модели вводится вручную.
- Подключение к выбранному провайдеру
прямое. Модуль обращается к API провайдера напрямую с вашим API-ключом; в каждом профиле настроек хранятся свои ключ и модель по умолчанию.
- Модуль
не передаёт данные третьим сторонам и
общается только с выбранным провайдером. Содержимое промптов и ответы нейросети уходят строго туда, чей ключ настроен в активном профиле.
- Вся
статистика взаимодействия с провайдером (запуски, шаги, токены, стоимость, предложения на проверку, ошибки, история записи в поля) хранится
у вас на сайте в таблицах модуля. Никакие телеметрические данные о генерации наружу не уходят.
Как работает контент-завод (конвейер)- Конвейер — это сценарий обработки
одной карточки. Он берёт данные элемента, подставляет их в промпт, отправляет запрос в LLM и записывает ответ в выбранное поле.
- Конвейер собирается из
шагов. Один шаг — одна задача, один запрос к LLM, одно целевое поле. Нужны два поля — два шага.
- Шаги выполняются по порядку и образуют
цепочку: каждый последующий шаг видит ответы всех предыдущих и может подставить их в промпт как отдельный плейсхолдер «Результаты шагов». Это позволяет писать описание один раз, а потом переиспользовать его в SEO, анонсе и значениях свойств.
Что важно понимать- Запросы в LLM
не бесплатные. Каждый запуск конвейера тратит токены вашего провайдера — перед массовой генерацией протестируйте конвейер на одном элементе.
-
Профиль — это один независимый набор настроек: можно завести несколько профилей под разные инфоблоки или разные сценарии (отдельный профиль для перевода, отдельный — для SEO).
-
Модуль — прозрачный инструмент. Качество текстов определяется выбранной моделью и вашим промптом; модуль отвечает за надёжность доставки данных, переиспользование шагов, модерацию и контроль записи.
Установка идёт
в стандартном формате Битрикс: модуль ставится через раздел «Marketplace → Установленные решения».
Требования окружения:
- PHP выше версии 8.1
- Bitrix последней актуальной версии (релиз модуля на версии 25.750.0
- Агенты Битрикса работают на cron (
https://docs.despi.ru/all-modules/agents/)
Первый запуск модуляПри первом открытии модуля автоматически запускается
мастер инициализации, который выполнит подготовку за вас тремя шагами:
1.
Установка таблиц модуля в базе данных — создаются служебные таблицы.
2.
Регистрация обработчиков событий Битрикс — модуль подписывается на события создания и обновления элементов инфоблока (захват в очередь работает только после этого шага).
Каждый шаг отображается в мастере, при ошибке шаг можно повторить — уже выполненные шаги пропускаются. По завершении мастер сам перебросит вас в настройки.
Если таблицы модуля уже были созданы ранее (например, после переустановки), мастер аккуратно пропустит первый шаг и завершит подписку на события — существующие данные не пострадают.
Где взять API-ключ провайдераПодробная пошаговая инструкция по регистрации и получению ключа для каждого из поддерживаемых провайдеров (Polza.ai, OpenRouter, кастомный OpenAI-совместимый эндпоинт) лежит в документации модуля в разделе
«Регистрация в провайдере» — там разобраны
конкретные хлебные крошки личного кабинета каждого сервиса и заметка про название и лимит ключа.
Порядок настройки модуляПосле установки и проверки агентов настройка идёт в строгом порядке.
Каждый раздел подробно расписан в документации модуля.1.
Регистрация в провайдере. Откройте «Настройки → Основное», выберите LLM-провайдера, вставьте полученный API-ключ (для кастомного подключения — также URL эндпоинта), сохраните настройки и выберите модель по умолчанию. Связь проверяется виджетом «Протестировать подключение» — он отправляет прямой запрос к модели.
2.
Источник данных. В блоке «Источник данных» выберите тип обрабатываемых данных («Элементы инфоблока» или «Разделы инфоблока»), затем конкретный инфоблок. Соберите фильтр — он должен быть
стабильным (не зависеть от полей, которые заполняет сам модуль), иначе элементы будут пропадать из дашборда после обработки.
3.
Конвейер. Опишите шаги обработки.
4.
Дашборд и запуск. На дашборде установите фоновый агент очереди кнопкой «
Установить». После этого можно поставить элементы в очередь — массово (кнопка «Поставить весь фильтр в очередь») или точечно через таблицу. Обработка пойдёт по расписанию агента. Результаты, отмеченные «Требует модерации», ждут вашего решения во вкладке «Ждут подтверждения».
При необходимости заведите
несколько профилей настроек — каждый профиль независим и хранит свои источник, конвейер, ключ провайдера и очередь задач.
Поддержка осуществляется по почте:
support@despi.ruВ теме письма указывайте модуль, по которому обращаетесь.
Ответ на обращение от 1 до 3 рабочих дней.
Внимательно изучите 3 основных правила тех поддержки, чтобы ваш вопрос решился в короткие сроки:
https://docs.despi.ru/ms-modules/rules