Установка и первый запуск
В этой статье — как установить модуль в 1С-Битрикс и подготовить его к работе: установка модуля, настройка агентов на крон и порядок первичной настройки.
Установка модуля
Установка идёт в стандартном формате Битрикс: модуль ставится через раздел «Marketplace → Установленные решения» точно так же, как любые другие модули. Отдельных дистрибутивов, ручного копирования файлов или нестандартных шагов на этом этапе нет.
Общая инструкция по установке модулей Despi (в том числе демо-версии из карточки модуля) описана в отдельной статье: Установка модуля.
Настройка агентов на крон
Перед началом работы убедитесь, что агенты Битрикс выполняются по крону. Модуль обрабатывает очередь генерации фоновым агентом: он просыпается через равные промежутки времени, забирает пачку задач и прогоняет их через конвейер.
По умолчанию агенты Битрикс работают «на хитах» — только когда кто-то заходит на сайт. Если посетителей нет, очередь стоит, а интервалы запуска «плывут». Для надёжной фоновой обработки агенты нужно перевести в режим запуска «на кроне» — по системному расписанию сервера, независимо от посещаемости.
Настройка режима запуска агентов затрагивает конфигурацию сервера. Её должен выполнять технический специалист — либо обратитесь к своему хостинг-провайдеру с просьбой настроить запуск агентов Битрикс по крону. Подробная инструкция: Настройка агентов на cron.
Первый запуск: мастер инициализации
При первом открытии модуля автоматически запускается мастер инициализации, который выполнит подготовку за вас тремя шагами:
- Установка таблиц модуля в базе данных — создаются служебные таблицы для очереди, истории генерации, статистики провайдеров, коллекции промптов и других сущностей.
- Регистрация обработчиков событий Битрикс — модуль подписывается на события создания и обновления элементов инфоблока (захват в очередь работает только после этого шага).
- Завершение инициализации — модуль помечается как готовый к работе.
Каждый шаг отображается в визарде; при ошибке шаг можно повторить — уже выполненные шаги пропускаются. По завершении мастер сам перебросит вас в настройки.
Если таблицы модуля уже были созданы ранее (например, после переустановки), мастер аккуратно пропустит первый шаг и завершит подписку на события — существующие данные не пострадают.
Порядок настройки модуля
После установки и проверки агентов настройка идёт в строгом порядке. Каждый раздел подробно расписан в отдельной статье документации.
- Регистрация в провайдере. Откройте «Настройки → Основное», выберите LLM-провайдера, вставьте полученный API-ключ (для кастомного подключения — также URL эндпоинта), сохраните настройки и выберите модель по умолчанию. Связь проверяется виджетом «Протестировать подключение».
- Источник данных. Выберите тип обрабатываемых данных («Элементы инфоблока») и конкретный инфоблок. Соберите стабильный фильтр элементов (он не должен зависеть от полей, которые заполняет сам модуль). Опционально ограничьте выборку разделами и настройте захват событий.
- Конвейер. Опишите шаги обработки: для каждого задайте промпт с плейсхолдерами полей карточки, при необходимости переопределите модель и включите веб-поиск, выберите целевое поле и режим записи, добавьте постпроцессоры и валидаторы. Для первых прогонов включите флаг «Требует модерации».
- Дашборд и запуск. Установите фоновый агент очереди кнопкой «Установить», затем поставьте элементы в очередь — массово или точечно. Результаты, отмеченные «Требует модерации», ждут вашего решения во вкладке «Ждут подтверждения».
При необходимости заведите несколько профилей настроек — каждый профиль независим и хранит свои источник, конвейер, ключ провайдера и очередь задач.