Плагин: НейроЯдро
О плагине
- @package neuroCore
- @author SalesMan Team
- @version v.0.24 от 05.10.2026
Нейроядро — это «мотор» нейросетей для SalesMan CRM. Оно не пишет тексты само: его задача — дать всем нейро-функциям (генерация писем, краткое описание сделки, разбор звонков, ответы по базе знаний) один общий способ обращаться к модели.
Что это значит на практике: ключи, подключения, стоимость вызовов и очередь заданий настраиваются один раз здесь, а не в каждом плагине отдельно. Подключили новую нейросеть — ею сразу могут пользоваться все нейро-функции.
Возможности
- Подключение любых нейросетей. Подходит любой сервис с OpenAI-совместимым API (OpenAI, DeepSeek, OpenRouter, Groq, Mistral, VseGPT), а для Google Gemini есть отдельный режим. Новая нейросеть добавляется настройкой, без обновления CRM.
- Диагностика подключения. Кнопка «Проверить» делает настоящий запрос и показывает модель, задержку, токены или дословную причину отказа: ключ, модель, адрес, квота.
- Очередь заданий. Долгие обращения к модели выполняются в фоне и не задерживают работу в CRM: задание переживает закрытие страницы и перезапуск сервера.
- Учёт расхода. Видно, сколько вызовов, токенов и денег ушло — по дням, сотрудникам, типам задач и моделям.
- Кэш ответов. Тот же самый вопрос не отправляется модели второй раз, поэтому не оплачивается повторно.
- Журнал и оповещения. Если подключение перестало работать или очередь встала, администраторы узнают об этом из уведомления, а не из жалоб сотрудников.
- Защита данных клиентов. Телефоны, почта, ФИО и реквизиты можно не отправлять провайдеру: вместо них модель увидит условные обозначения.
Быстрый старт
- Установите и включите плагин Нейроядро в разделе «Плагины».
- Откройте раздел Нейроядро → Подключения и нажмите «Добавить подключение»: укажите название, тип, адрес API, модель и ключ.
- Нажмите Проверить. Увидите ответ модели или понятную причину отказа. Учтите: проверка — это обычный платный запрос, он попадает в отчёт по расходу.
- Включите галочку Подключение активно и сохраните.
- Если планируете пользоваться очередью, установите плагин Планировщик заданий — задание для Нейроядра создаётся автоматически.
Готово: нейро-функции CRM теперь могут обращаться к модели.
Разделы Нейроядра
| Раздел | Для чего |
|---|---|
| Подключения | Нейросети: адрес, модель, ключ, цены, ограничения |
| Промпты | Инструкции для модели: тексты, версии, проверка на примере |
| Очередь | Задания в работе и завершённые, их результаты и ошибки |
| Расход | Вызовы, токены и стоимость за выбранный период |
| Журнал | Что происходило: итоги заданий, отказы, очистка кэша |
| Настройки | Таймаут, повторы, кэш, сроки хранения, оповещения |

Подключения
В одном подключении задаются:
- Название — как вы будете его узнавать в списке.
- Тип — OpenAI-совместимый API или Google Gemini.
- Адрес API — можно указать и корень сервиса, и адрес с версией.
- Модель — например,
deepseek-chat. - Ключ — вводится прямо в форме (см. «Где хранится ключ»).
- Температура, максимум токенов, таймаут — необязательные уточнения.
- Режим JSON — нужен, если ответ должен приходить в строгом виде. Не все сервисы это поддерживают: если появится ошибка про формат ответа, верните «Не использовать».
- Цены и валюта — нужны только для отчёта по расходу.
- Разрешить отправлять персональные данные клиентов — см. «Защита данных».
Подключений может быть несколько — например, дешёвая модель для массовых задач и сильная для сложных. Включённые подключения сразу доступны нейро-функциям CRM.
Промпты
Промпт — это инструкция для модели с переменными вида {{client}}, которые подставляет CRM. Промпты принадлежат нейро-функциям, а не ядру.
- Плагин приносит свои промпты и регистрирует их при активации.
- Ваши правки не перезаписываются. Если плагин позже обновит свой текст, в списке появится пометка «в плагине другой текст», а сохранённый вариант останется: решение принимаете вы, а не программа.
- У промпта есть версии и кнопка проверки на примере — можно посмотреть, что ответит модель с вашими данными, и сохранить только удачный вариант.
Очередь заданий
Ответ модели приходит за секунды, а иногда за десятки секунд, а массовая операция — это сотни вызовов. Держать такую работу в открытой странице нельзя, поэтому задания выполняются в фоне.
- Задания не дублируются: одинаковые задания (тот же промпт, версия, данные и автор) не встанут в очередь второй раз, пока первое не завершено. Двойной клик не оплачивается дважды.
- Задание не теряется. Если сервер перезапустился или фоновая задача была прервана, через 15 минут задание вернётся в очередь и будет выполнено.
- Повтор только по делу. Занятость сервиса, сбои на стороне провайдера, таймаут и обрыв сети повторяются с растущей паузой; отказ по ключу или по правилам провайдера не повторяется — это только тратило бы деньги.
- Отмена возможна, пока задание не начало выполняться. Задание в работе отменить нельзя: запрос уже отправлен и будет оплачен.
- Уведомление об окончательной ошибке придёт в «колокольчик» автору задания всегда, об успехе — если задание поставлено с уведомлением.
Статусы заданий: в очереди, в работе, выполненные, с ошибкой, отменённые.
Если планировщик на сервере не запущен, задания будут копиться и не выполнятся сами: вкладка «Очередь» предупредит об этом, а разобрать очередь вручную сможет ваш системный администратор.
Кэш ответов
Кэш экономит деньги: буквально тот же вопрос не отправляется модели второй раз, ответ берётся из сохранённых. В интерфейсе такой ответ помечается как «взято из кэша» и в расход не попадает. Изменились данные — изменился вопрос, ответ будет свежим.
Срок жизни кэша задаётся в настройках (по умолчанию 60 минут). Значение 0 выключает кэш полностью.
Защита данных клиентов
В подключении есть переключатель «Разрешить отправлять персональные данные клиентов». По умолчанию он включён: промпт уходит провайдеру как есть.
Если галочку снять, Нейроядро заменит телефоны, почту, ФИО и реквизиты условными обозначениями вида [PHONE_1], а в ответе модели подставит настоящие данные обратно: модель видит структуру письма, но сами данные остаются в CRM. Каждая такая отправка отмечается в журнале — без самих значений.
Границы честности: названия компаний, должности и текст переписки не маскируются — по ним клиент всё ещё узнаваем. Это защита от утечки реквизитов, а не полная анонимизация.
Журнал
Журнал отвечает на вопрос «что вообще происходило»: итоги заданий, отказы подключений, очистка кэша, маскирование данных. Текстов промптов и ответов модели здесь нет — только служебные сведения; полный ответ задания виден в его карточке.
Есть фильтры по уровню (подробно, информация, предупреждение, ошибка), периоду и номеру задания. Срок хранения журнала задаётся в настройках (по умолчанию 30 дней), а удалить старые записи можно и вручную, кнопкой.
Оповещения
Нейроядро сообщает администраторам о том, что иначе осталось бы незамеченным:
- подключение не работает: ключ отозван, не задана переменная окружения, ключ не расшифровывается или нет ни одного включённого подключения;
- очередь не разбирается — обычно это значит, что не запускается планировщик.
Оповещения приходят в «колокольчик» и попадают в журнал. Одно и то же не повторяется чаще, чем указано в настройках (по умолчанию — раз в 6 часов). Для отправки уведомлений во внешние каналы (Telegram, Viber) нужен отдельный модуль интеграции.
Виджет рабочего стола
Виджет «Нейроядро: очередь и расход» показывает состояние очереди, расход за сегодня и последние ошибки. Он доступен только администраторам — и в списке виджетов, и на рабочем столе.
Включить его можно в разделе Мои настройки → Виджеты.
Инструкция для разработчиков
Если вы делаете свой плагин и хотите пользоваться нейросетью, не заводя второй ключ и второй отчёт о расходе, — нажмите Инструкция для разработчиков в шапке раздела. Откроется отдельное окно с руководством по программному интерфейсу Нейроядра: подключение классов, реестр промптов, вызов модели, очередь заданий, разбор JSON-ответов, учёт расхода, безопасность — с примерами кода целиком, вплоть до небольшого плагина.
Руководство открывается только администратору: оно описывает внутреннее устройство ядра. Текст лежит в файле plugins/neuroCore/developers.md.
Требования
- SalesMan CRM 2025.2 и выше
- PHP 7.2 … 8.1
- Исходящий доступ в интернет по HTTPS к API выбранной нейросети
- Плагин Планировщик заданий — чтобы очередь разбиралась автоматически

