Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v6.0.2
SW_BACKEND_VERSION=v6.0.2
SW_HELPCENTER_VERSION=v6.0.2

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

2. Запустите очистку неиспользуемых данных:

docker system prune -a

Новые фича-флаги

__ai_mcp_agents - включает возможность создания ИИ-агентов (см. возможности ИИ провайдеров)

rca - включает управление документами анализа первопричин (Root Cause Analysis, RCA)

ui_widgets - включает возможность встраивать в интерфейс Swarmica произвольные виджеты

child_tickets - включает возможность создавать связанные дочерние тикеты, по аналогии с external_tickets, но внутренние дочерние тикеты учитываются в статистике и предназначены для работы сотрудников компании, а не внешних получателей

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

🚀 Что нового в обновлении

🤖 ИИ-агенты

Появилась возможность создавать полноценных ИИ-агентов, которые могут использовать инструменты MCP для выполнения рутинных задач, забирая на себя монотонную работу с сотрудников. В этом обновлении представлены три компетенции ИИ-агентов:

1. Проверяющий качества сервиса (QA evaluator)
2. Проверяющий качества контента (AQI evaluator)
3. Проеряющий точность связанности (LAI evaluator)

Эти функции доступны с ИИ-провайдерами YandexGPT и ChatGPT и подключаются фича-флагом __ai_mcp_agents

🔍 RCA

Добавилась возможность создавать документы с анализом первопричин инцидента (Root Cause Analysis, RCA), а так же делиться этими документами с клиентами через интерфейс системы или экспорт в форматах PDF и Markdown. Для большего удобства работы с RCA есть следующие функции:

• 🤖 Генерация документа RCA с помощью ИИ
• 📋 Шаблоны RCA
• 🔒 Возможность добавлять внутреннюю информация, которая не будет видна для клиентов

Включается фича-флагом rca

🎨 Кастомизация интерфейса

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

• 🧩 Собственные настройки основных экранов в заявке, стате, карточке пользователя, организации, лицензионного ключа и актива. Возможность задавать порядок боксов, порядок полей, скрывать поля, который применяется для всех пользователей по умолчанию.
• 🧩 Добавление веб-плагинов через механизм кастомных виджетов (фича-флаг ui_widgets) позволит расширить возможности интерфейса Swarmica и подключить различные внешние системы и веб-виджеты для сотрудников и клиентов
• ✉️ Возможность добавлять кастомизируемое сообщение в форме тикета, для того, чтобы проинформировать клиентов о различных важных нюансах: например, куда обращаться с запросами по приобритению продукта, как продлить лицензию и т.д. Сообщение гибко параметризуется за счет использования шаблонов Jinja.
• 👁️ Возможность скрывать поле «Приоритет» на форме создания
• 🖼️ Возможность задавать кастомную иконку для встраиваемого чат-виджета
• 🎨 Поддержка стилизации встраиваемого чат-виджета через CSS темы бренда

⚙️ ITIL/ITSM

В релизе добавились механизмы, упрощающие внедрения практик ITIL/ITSM:

• ⏱️ Механизм подсчета Операционного Соглашения (Operation-level Agreement, OLA):
  • 🔧 Механизм OLA и политики OLA для различных команд
  • 📊 Графики OLA и соблюдения политик OLA в аналитике
• 📑 Возможность создавать различные Типы запросов по ITIL/ITSM (Запрос на обслуживание, Инцидент, Проблема и т.д.)
• ✉️ Дочерние заявки (фича-флаг child_tickets) для того, чтобы создавать связанные с запросом клиента задачи во внутренние отделы компании и отслеживать их статус
• 🗓️ Производственные календари и быстрое применение праздников к расписаниям для более гибкого и точного подсчета SLA и OLA

📈 Большие изменения в работе с оценкой качества LAI/AQI/QA

• 🖥️ Новые более удобные экраны работы с оценкой, на которых отображается вся необходимая информация
• 💬 Возможность добавлять общий комментарий к оценке
• 🔗 Удобное управление связями «проверяющий — правило» (из правила назначать проверяющих и наоборот)
• ⚡ Возможность сгенерировать оценки по правилу «прямо сейчас», указав нужных проверяющих и количество оценок
• 👥 Возможность указывать количество оценок на проверяющего для каждого правила, создаваемых по расписанию
• 🧮 Возможность назначать оценки, игнорируя загруженность проверяющего
• ⚖️ Алгоритм перебалансировки, учитывающий загруженность проверяющего
• 📊 Возможность создать оценки AQI для редактора и для автора
• 🗑️ Возможность удалять созданные оценки при удалении соответствующего правила

🖥️ Улучшения UI/UX

• 🔎 Поиск по полям в фильтрах
• 📑 Сортировки и быстрый поиск по разделам в настройках
• 🛠️ Визуальный конструктор форм к кастомным скриптам + новый тип поля «Выпадающий список»
• 📋 Быстрый список заявок при выборе целевой заявки для объединения
• 📝 Кнопка «копируемый блок» в редакторе статей
• ⬇️ Индикатор скачивания большого вложенного файла
• 🚫 Индикатор заблокированного пользователя
• 🖼️ Предварительный просмотр изображений на форме создания тикета и коммента
• 🔍 Фильтрация событий в заявке
• ✍️ Удобное написание коммента (автофокус)
• 💾 Сохранение данных в форме до успешного создания тикета

📚 Хелпцентр

• 👍👎 Помогло/Не помогло на статье для неавторизованных пользователей
• 📖 Содержание раздела
• 🖼️ Оптимизация загруженных картинок на обложку продукта и раздела базы знаний, что улучшает скорость загрузки и положительно влияет на SEO

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

• 🔑 Возможность задавать политику сложности паролей
• 🚫 Возможность запретить использовать скомпроментированные и популярные пароли

⚙️ Улучшения производительности и обслуживания

• 🔄 Механизм автоматического выполнения post-upgrade команд при обновлении
• 🔌 Переход на единое соединение вебсокета вместо нескольких, автоматическое переподключение и keepalive проверки для более стабильного соединения и устойчивости при нестабильной скорости и качестве Интернет-соединения
• 🛠️ Возможность настройки параметров celery для тонкой настройки производительности сервера
• 📏 Лимит максимального количества объектов на одной странице API запроса LIST

🌐 Разное

• 💬 Поддержка чатов в МАКС
• 🆕 Новый тип каналов — Web / API и возможность отключать их
• ⏲️ Настройка автоматических переходов и автоматических уведомлений с гранулярностью до секунд
• 🔄 Возможность задать алгоритм действий с событиями из прошлого для триггерных автоматизаций
• 👤 Управление аватарками сотрудников (для админов)
• 🔌 Поддержка динамических переменных в адресе URL для исходящего вебхука
• 🔍 Новые возможности в фильтрах:
  • 🔘 оператор isnull для разделов статей в фильтрах
  • 🔘 оператор НЕРАВНО для авторов статей в фильтрах
  • 🔘 оператор isnull для группы в фильтрах тикетов