Перейти к содержимому
Активное действие

Спросить агента

ИИ-помощник для модуля Incident Manager: аналитик задаёт вопрос из карточки инцидента, ответ модели появляется комментарием в истории работы. Работает с любым OpenAI-совместимым LLM API, поставляется одним скриптом без внешних зависимостей.
Актуально для Smart Monitor 6.1.0 · 31 июля 2026

«Спросить агента» добавляет в карточку инцидента модуля Incident Manager кнопку вызова ИИ-помощника. Аналитик пишет вопрос — «Что это за инцидент?», «Составь план реагирования», «Похоже ли это на brute-force?» — или оставляет поле пустым для общего разбора. После выполнения запроса в истории работы с инцидентом появляется комментарий с ответом: разбор по фактам инцидента и списки шагов; имена хостов и хеши выделены как код.

Ответ строится на данных конкретного инцидента: модель получает поля карточки, описание, историю работы и обогащение из Smart Monitor — техники MITRE ATT&CK и связанные инциденты. Системный промпт требует от модели отвечать на русском языке в формате Markdown и опираться только на данные инцидента.

Сценарии использования

  • первичная оценка инцидента дежурным аналитиком;
  • план реагирования из нескольких шагов;
  • проверка гипотезы («это brute-force или ошибка сервиса?»);
  • черновик уведомления или отчёта по инциденту.

Для типовых запросов создайте несколько копий действия с разными значениями поля prompt — «Оценить критичность», «План реагирования», «Черновик отчёта».

Как работает

Активное действие — штатный механизм расширения модуля Incident Manager: платформа запускает скрипт и передаёт ему контекст инцидента.

Кнопка в карточке инцидента
  → Smart Monitor запускает ai_assist.py (контекст инцидента на stdin)
    → скрипт собирает карточку, описание и историю, добавляет обогащение
    → запрос chat/completions к LLM
  ← результат действия фиксируется платформой
  ← комментарий с ответом появляется в истории инцидента

При сбое LLM действие завершается со статусом «Ошибка» и текстом ошибки; подробности записываются в лог скрипта.

Состав поставки

  • ai_assist.py — скрипт активного действия: один файл без внешних зависимостей, только стандартная библиотека Python;
  • инструкция по установке и настройке.

Требования

  • Smart Monitor версии 6.1 и выше;
  • модуль Incident Manager;
  • Python версии 3.6 и выше на сервере Smart Monitor Web;
  • доступ с сервера к OpenAI-совместимому LLM API — локальный vLLM или LiteLLM-прокси либо облачный провайдер;
  • учётная запись Data Storage с правом записи в индекс истории инцидентов.

Контекст инцидента передаётся в LLM целиком, поэтому для обработки чувствительных данных размещайте модель внутри защищённого контура организации.

Установка

  1. Скачайте архив и поместите ai_assist.py в каталог активных действий $OSD_HOME/config/actions/ (обычно /app/opensearch-dashboards/config/actions/). Содержимое каталога сохраняется при обновлении платформы.
  2. Назначьте файлу те же владельца и права, что и у остальных действий:
chown opensearch:opensearch ai_assist.py && chmod 600 ai_assist.py
  1. Задайте параметры подключения к LLM и Data Storage — переменными окружения службы Smart Monitor Web или в файле .env рядом со скриптом. Параметры приведены в таблице ниже.
  2. Перезапустите Smart Monitor Web:
systemctl restart opensearch-dashboards
  1. Создайте активное действие: «Менеджер инцидентов» → «Настройки» → «Активные действия» → «Создать». Скрипт — ai_assist.py, режим — ручной запуск; в блоке «Дополнительные поля» добавьте текстовое поле prompt.
  2. Включите действие в представлении типа инцидента: «Параметры системы» → «Настройки модулей» → «Менеджер инцидентов» → «Типы инцидентов» → нужный тип → вкладка «Представления» → блок «Активные действия». Без этого кнопка в карточке не появится.
  3. Для проверки откройте любой инцидент и запустите действие с вопросом «Что это за инцидент?». В истории появятся событие запуска и комментарий с ответом.

Параметры

ПеременнаяПо умолчаниюНазначение
AI_ASSIST_URL—OpenAI-совместимый эндпоинт chat/completions: vLLM, LiteLLM, облачный провайдер
AI_ASSIST_MODEL—Имя модели
AI_ASSIST_API_KEYпустоBearer-токен, если эндпоинт требует авторизацию
AI_ASSIST_TIMEOUT240Время ожидания ответа LLM, секунд
AI_ASSIST_MAX_TOKENS3000Максимальная длина ответа, токенов
AI_ASSIST_TEMPERATURE0.5Вариативность ответа: 0 — ответ без вариаций, 0.7 и выше — более свободный
AI_ASSIST_THINKINGtrueРежим рассуждений модели: разбор подробнее, но ответ формируется дольше
AI_ASSIST_THINKING_BUDGET5000Бюджет токенов на рассуждения сверх предела ответа
AI_ASSIST_SEED42Фиксированный seed для воспроизводимых ответов; пустое значение отключает фиксацию
AI_ASSIST_SM_URLhttps://localhost:5601Frontend API Smart Monitor для обогащения контекста (MITRE, связанные инциденты)
AI_ASSIST_CONTEXT_LIMIT40000Максимальное число символов в одном блоке контекста
SMART_MONITOR_HOST—Узел Data Storage для записи комментария в историю
SMART_MONITOR_USER / SMART_MONITOR_PASSWORD—Учётные данные Data Storage
SMART_MONITOR_CAпустоCA-сертификат; если не задан, сертификат TLS не проверяется

Настройка

Константы в начале скрипта задают системный промпт (роль, язык, контекст организации), промпт по умолчанию для пустого поля prompt и список полей инцидента, которые не передаются модели.

Устранение неполадок

Лог скрипта — /app/logs/ai_assist.log (если каталог недоступен для записи — /tmp/ai_assist.log). В лог записываются входящий контекст, параметры запроса, расход токенов и результат записи в историю.

СимптомПричина и решение
Скрипта нет в списке при создании действияПосле добавления файла не перезапущен Smart Monitor Web
Действие сразу завершается с ошибкой, лог пустСкрипт запускается командой python из PATH службы — убедитесь, что это Python версии 3.6 и выше
«LLM вернул ошибку 401/403»Эндпоинт требует авторизацию — задайте AI_ASSIST_API_KEY
«Не удалось выполнить запрос к LLM»Эндпоинт недоступен с сервера: проверьте сетевую связность и межсетевой экран
Ответ обрываетсяУвеличьте AI_ASSIST_MAX_TOKENS
Пустой ответ при включённом режиме рассужденийУвеличьте AI_ASSIST_THINKING_BUDGET
Действие завершается по таймаутуУвеличьте AI_ASSIST_TIMEOUT или уменьшите AI_ASSIST_MAX_TOKENS
Ответ получен, комментария в истории нетПроверьте учётные данные и адрес Data Storage (SMART_MONITOR_*)
Разработчик
VolgaBlob
Актуально для
6.1.0
31 июля 2026 · Что нового?
Категория
Безопасность · ИТ-мониторинг · Инциденты и реагирование
Тип
Активное действие
Скрипт активного действия Менеджера инцидентов
Стоимость
Бесплатно
Модуль
Функциональный модуль

Посмотреть на Smart Monitor в действии

Оставьте заявку, мы свяжемся с вами в ближайшее время и ответим на все вопросы
Модули Smart Monitor
Подскажите, как к вам обращаться
Укажите название компании
Нужна почта, пришлём на неё ответ
Проверьте номер телефона
Invalid Input