Установка модуля SenDev: AI Core

SenDev: AI Core — общий модуль для подключения AI-провайдеров к решениям на 1С-Битрикс. После установки он становится единым местом, где настраиваются подключения к текстовым и графическим моделям, промпты, журнал запросов, ограничения и служебная диагностика.

Если другие модули SenDev используют AI-функции, сначала устанавливается и настраивается AI Core, а уже затем включаются AI-возможности в конкретном модуле.

[Скриншот 1: экран установки SenDev: AI Core с результатами проверки компонентов]

Что происходит во время установки

Установка выполняется стандартным способом для модулей 1С-Битрикс. После запуска мастер регистрирует модуль и подготавливает его рабочую структуру. От пользователя не требуется вручную создавать таблицы или административные страницы.

В ходе установки модуль:

• регистрирует SenDev: AI Core в системе;
• создаёт служебные таблицы для провайдеров, промптов, журнала, кэша, очереди, лимитов и истории изменений промптов;
• добавляет административные страницы модуля;
• устанавливает стандартные профили AI-провайдеров;
• добавляет стартовую библиотеку промптов;
• регистрирует фоновые задания, необходимые для обработки очереди и очистки устаревшего кэша;
• записывает базовые настройки модуля.

В версии 1.1.0 установка и обновление построены так, чтобы существующие пользовательские настройки сохранялись. При обновлении модуль дополняет структуру недостающими данными и не должен заменять сохранённые API-ключи, пользовательские модели, промпты или журнал.

Экран завершения установки

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

• регистрация модуля — AI Core должен быть зарегистрирован в системе;
• таблицы базы данных — все необходимые таблицы должны быть доступны;
• тип базы данных — должен поддерживаться текущей версией модуля;
• административные страницы — после установки должны открываться разделы AI Core;
• фоновые задания — модуль использует два системных задания: обработку очереди и очистку просроченного кэша;
• начальные настройки — должны быть записаны значения по умолчанию.

Если рядом с каким-либо пунктом выводится предупреждение, не начинайте подключение реального AI-провайдера, пока причина не будет устранена. Для дополнительной проверки после установки откройте страницу «Диагностика».

Первый вход в модуль

После установки в административном меню появляется раздел Sendev: AI Core. В нём доступны:

• Дашборд — общая сводка состояния AI Core;
• Провайдеры — подключения к текстовым и графическим AI-сервисам;
• Промпты — библиотека шаблонов запросов;
• Песочница — ручная проверка подключения и промптов;
• Журнал — история запросов и ошибок;
• Лимиты — ограничения по запросам, токенам и стоимости;
• Диагностика — проверка структуры, очереди, окружения и безопасности;
• Документация — встроенная справочная страница для интеграции.

Дополнительные глобальные параметры доступны на стандартной странице настроек модуля 1С-Битрикс.

Обязательная проверка защиты секретов

AI Core хранит учётные данные провайдеров в зашифрованном виде. Для этого на сайте должен быть настроен мастер-ключ шифрования. Сам ключ не хранится среди обычных настроек AI Core.

Проверить готовность можно на странице «Диагностика». В блоке безопасности должна отображаться информация о том, что защищённое хранилище готово к работе.

Если диагностика сообщает, что защищённое хранилище не настроено, перед добавлением реальных API-ключей обратитесь к администратору сервера. Не рекомендуется сохранять рабочие ключи до устранения этого предупреждения.

Рекомендуемый порядок первоначальной настройки

1. Откройте «Диагностику». Убедитесь, что таблицы созданы, фоновые задания доступны, необходимые расширения PHP подключены, а защищённое хранение секретов настроено.
2. Откройте «Провайдеры». Выберите готовый профиль нужного сервиса или создайте собственный. Для реального подключения укажите API-ключ или другой способ авторизации.
3. Не включайте сразу все профили. Для начала достаточно одного текстового и, при необходимости, одного графического провайдера. Это упрощает первичную проверку маршрутизации.
4. Проверьте библиотеку промптов. В разделе «Промпты» уже есть стандартные сценарии. Их можно использовать как основу и дополнять собственными.
5. Запустите «Песочницу». Сначала проверьте тестовый профиль Dummy. Такой тест не требует внешнего API и позволяет убедиться, что сам AI Core работает.
6. Проверьте реальный профиль. После успешного Dummy-теста выполните короткий запрос через подключённого провайдера и убедитесь, что ответ отображается без ошибки.
7. Откройте «Журнал». Проверьте, что тестовый вызов записан, а в строке видны провайдер, модель, статус и длительность.
8. При необходимости настройте лимиты. Если AI используется несколькими модулями или пользователями, задайте ограничения до начала активной эксплуатации.

[Скриншот 2: меню AI Core и рекомендуемые разделы для первоначальной настройки]

Проверка без реального AI-сервиса

В AI Core предусмотрены служебные профили Dummy для текста и Dummy Image для изображений. Их удобно использовать сразу после установки.

Dummy-профили позволяют проверить:

• работу административных страниц;
• выбор провайдера и модели;
• подстановку переменных в промпт;
• создание записи в журнале;
• работу общего механизма AI Core без расходования внешней квоты.

Графический Dummy Image возвращает тестовое изображение локально. Для такого теста не нужен API-ключ, оплаченный аккаунт или доступ к внешнему сервису.

Подключение реального текстового провайдера

Для текстовых запросов в модуле есть готовые профили для сервисов с OpenAI-совместимым API, а также отдельный вариант Bothub. В стандартной поставке присутствуют шаблоны подключений, например для OpenRouter, DeepSeek, Qwen/DashScope, Mistral, Groq, Together, Cerebras и Hugging Face Router.

Наличие готового профиля означает, что основные параметры подключения уже заполнены. Обычно администратору остаётся проверить адрес сервиса, указать ключ, выбрать модель и активировать профиль.

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

Подключение генерации изображений

Для графических задач AI Core поддерживает отдельные профили. В поставке предусмотрены варианты для OpenAI Images, Google Gemini Image, Qwen Image, Black Forest Labs/FLUX и универсального REST-подключения.

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

Права доступа

AI Core использует стандартные права доступа модуля. Для обычной работы можно назначить:

• Нет доступа — раздел модуля недоступен;
• Чтение — пользователь может просматривать доступную информацию;
• Запись — пользователь может работать с функциями, требующими изменения данных.

Настройка провайдеров и параметров безопасности предназначена для администратора. Запуск запросов в «Песочнице» также требует права записи, потому что реальный вызов может расходовать квоту или баланс AI-сервиса.

Что проверить перед передачей модуля пользователям

• Диагностика не показывает критических ошибок.
• Защищённое хранение секретов настроено.
• Нужные провайдеры активны, а ненужные отключены.
• У каждого рабочего профиля выбрана корректная модель по умолчанию.
• Тестовые запросы успешно проходят в «Песочнице».
• Журнал фиксирует запросы и ошибки в ожидаемом объёме.
• При необходимости настроены ограничения расходов.
• Права пользователей соответствуют их задачам.

[Скриншот 3: страница «Диагностика» после успешной первоначальной настройки]

Обновление модуля

После установки новой версии рекомендуется открыть «Диагностику». AI Core выполняет необходимые добавочные обновления структуры автоматически и показывает текущую версию схемы.

Стандартные профили и промпты также можно дополнить из административных разделов. Команды восстановления стандартных записей создают недостающие элементы и не предназначены для принудительной перезаписи уже настроенных ключей или пользовательских изменений.

Удаление модуля

Перед удалением AI Core проверьте, не используется ли он другими модулями SenDev. Если функциональный модуль обращается к AI Core, после удаления его AI-возможности перестанут работать.

Также заранее определите, нужны ли вам сведения о подключениях, промптах, журнале и лимитах. Удаление служебных данных следует выполнять осознанно.

Итог

После установки не требуется сразу подключать все доступные сервисы. Надёжный порядок — проверить диагностику, настроить один рабочий профиль, выполнить тест через Dummy и реального провайдера, проверить журнал и только затем подключать AI Core к рабочим сценариям сайта.