Установка AI-ассистента

Общая информация

Серверная часть AI-ассистента состоит из двух сервисов:

Компонент	Назначение
SM-AI	Подключает языковую модель к Smart Monitor. Через него работают AI-ассистент и команда ai
SM-MCP	Принимает вопросы из интерфейса, обращается к модели через SM-AI, выполняет операции с данными под учетной записью пользователя и сохраняет историю диалогов

Модель устанавливается или подключается отдельно. В дистрибутивы сервисов она не входит. Интерфейс чата входит в Smart Monitor Web.

Для установки используются архивы с инсталляторами setup.sh. Подробные шаги приведены в статьях Настройки SM-AI и Настройки SM-MCP.

Требования

• серверы Linux x86_64 с systemd, bash, curl и openssl
• права root или возможность выполнять команды через sudo
• доступ к модели с OpenAI-совместимым API /v1/chat/completions и поддержкой вызова инструментов (tools, tool_calls)
• административная учетная запись платформы на время настройки
• обычная учетная запись для проверки доступа к данным, корпусу знаний и скиллам
• сертификат удостоверяющего центра кластера, сертификаты и ключи сервисов
• окно обслуживания для поочередного перезапуска узлов хранилища при включении защиты истории

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

Требования к ресурсам сервера модели зависят от выбранной модели и числа одновременных обращений.

Сетевые подключения

Порты в таблице соответствуют значениям установщиков по умолчанию. При изменении портов скорректируйте правила сетевого доступа.

Источник	Назначение	Порт по умолчанию
Smart Monitor Web	API чата SM-MCP по HTTPS	8088
SM-MCP	SM-AI по HTTPS	8010
Узлы с поисковым движком	SM-AI для команды ai по HTTPS	8010
SM-AI и SM-MCP	API хранилища Smart Monitor по HTTPS	9200
SM-AI	API модели	Задается провайдером модели

Доступ к API чата SM-MCP предоставьте серверам Smart Monitor Web. Маршрут /mcp доступен на том же порту, что и API чата, поэтому сетевое ограничение действует и на него. Для внешних клиентов можно настроить дополнительный порт MCP.

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

Подготовка сертификатов

1. Подготовьте сертификат удостоверяющего центра кластера в формате PEM
2. Для SM-AI и SM-MCP подготовьте отдельные серверные сертификаты и ключи в формате PEM. Имена, по которым к сервисам будут обращаться другие компоненты, должны входить в SAN сертификатов
3. Для SM-AI используйте сертификат от удостоверяющего центра кластера: его проверяют и SM-MCP, и поисковый движок
4. Для SM-MCP используйте сертификат от удостоверяющего центра, указанного в opensearch.ssl.certificateAuthorities файла opensearch_dashboards.yml на серверах Smart Monitor Web

Вместо готовой пары сертификат/ключ инсталлятору можно передать сертификат и ключ удостоверяющего центра: он выпустит сертификат сервиса. Ключ удостоверяющего центра нужен только для выпуска сертификата; храните его в соответствии с правилами вашей организации.

Сертификаты сервисов

Не используйте приватные ключи узлов хранилища для сервисов. Сертификаты SM-AI и SM-MCP должны иметь назначение serverAuth; их DN не должен соответствовать шаблонам plugins.security.nodes_dn.

Порядок установки

1. Подготовьте модель: адрес API, идентификатор модели у провайдера и ключ доступа, если он требуется
2. Установите SM-AI и добавьте модель в реестр
3. Проверьте доступ к SM-AI с сервера SM-MCP и с узла поискового движка. Если используется команда ai, настройте ее подключение
4. Установите SM-MCP, указав адрес SM-AI и имя записи из реестра моделей
5. Загрузите корпус знаний и скиллы, подготовьте историю. Эти действия можно выполнить при установке SM-MCP
6. Включите защиту и сохранение истории: измените настройки всех узлов хранилища, поочередно перезапустите их и выполните enable-history
7. Подключите Smart Monitor Web к SM-MCP

к сведению

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

Проверка результата

1. Проверьте службы и диагностические ответы по инструкциям SM-AI и SM-MCP
2. Под обычной учетной записью задайте в чате вопрос по доступному источнику, например о количестве событий за последние сутки. Укажите имя своего источника и период
3. Дождитесь ответа, проверьте источник, период и полученное значение
4. Откройте другую беседу и вернитесь к проверочной: сообщения должны восстановиться из истории
5. Повторите вопрос под пользователем без доступа к проверяемым данным: ответ не должен содержать эти данные

Успешный ответ /health или /healthz подтверждает запуск службы. Для проверки всего подключения требуется вопрос в чате с обращением к модели и данным.