SenDev: AI Core — единый модуль для работы с искусственным интеллектом

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

Модуль используется как самостоятельный центр настройки AI и как инфраструктура для других решений SenDev. Вместо хранения ключей, моделей и правил подключения в каждом продукте эти данные настраиваются один раз в AI Core.

[Скриншот 1: меню SenDev: AI Core в административной части 1С-Битрикс]

Для чего нужен AI Core

AI Core решает несколько задач:

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

Текстовые AI-провайдеры

Для текстовых задач AI Core поддерживает подключения с OpenAI-совместимым API, Bothub и тестовый Dummy-профиль. В поставку входят готовые шаблоны для ряда популярных сервисов. Администратор может использовать готовый профиль или создать собственный.

Каждый профиль содержит свой адрес API, способ авторизации, список моделей, модель по умолчанию, цены и параметры журнала.

Генерация изображений

Графические запросы настраиваются отдельно от текстовых. Поддерживаются профили OpenAI Images, Google Gemini Image, Qwen Image, Black Forest Labs/FLUX, универсальный REST-драйвер и тестовый Dummy Image.

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

Промпты и сценарии

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

В поставке есть стандартные текстовые сценарии и стартовые шаблоны для генерации изображений.

Основные разделы

Дашборд

Сводная информация о провайдерах, промптах, журнале, очереди и состоянии AI Core.

Провайдеры

Настройка текстовых и графических подключений, ключей, моделей, приоритета, проверки и баланса.

Промпты

Библиотека шаблонов AI-запросов с категориями, версиями, переменными и сценариями.

Песочница

Ручное тестирование текста и изображений через выбранный профиль. Позволяет проверить промпт, переменные, модель и результат.

Журнал

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

Лимиты

Дневные и месячные ограничения по запросам, токенам и стоимости для всего AI Core, отдельного модуля, сценария или пользователя.

Диагностика

Проверка версии схемы, таблиц, очереди, фоновых заданий, PHP-окружения и защищённого хранения секретов.

Документация

Встроенная справочная информация о возможностях и принципах интеграции AI Core.

Глобальные настройки

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

[Скриншот 2: дашборд AI Core после первоначальной настройки]

Как начать работу

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

Проверка без внешних расходов

Профили Dummy и Dummy Image позволяют проверить основные механизмы без внешнего API. Они особенно полезны после установки и обновления. Если Dummy работает, а реальный сервис нет, проблема обычно находится в профиле, ключе, модели, квоте или настройках внешнего провайдера.

Безопасность

API-ключи хранятся в зашифрованном виде. Перед сохранением рабочих секретов нужно убедиться, что на сервере настроен мастер-ключ шифрования. Его состояние видно в «Диагностике» и глобальных настройках.

Журнал умеет маскировать ключи, токены, заголовки авторизации, cookie, e-mail и телефоны. При этом администратор сам определяет, нужно ли сохранять маскированный предпросмотр запросов и ответов.

Контроль расходов

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

Очередь и фоновые задачи

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

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

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

Что важно учитывать

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

[Скриншот 3: связка разделов «Провайдеры», «Промпты», «Песочница» и «Журнал»]

Итог

SenDev: AI Core объединяет инфраструктуру искусственного интеллекта в одном административном разделе. Для ежедневной работы основная цепочка проста: настроить провайдера, выбрать или создать промпт, проверить его в Песочнице и контролировать результат через журнал. Остальные разделы помогают управлять нагрузкой, расходом и системным состоянием.