# Обновление v6.0.x
# Инструкция

:::danger
ВАЖНО! Перед обновлением на v6.0.x необходимо иметь версию Swarmica не ниже [v5.12.x](https://support.swarmica.com/article/ru/1670 "v5.12.x")

Обновления важно выполнять последовательно: если версия Swarmica ниже v5.12.x, например, v5.3.x, то сначала нужно обновиться до v5.4.x, затем до v5.5.x, и так далее.
:::

### Подготовка

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

```bash
~# grep VERSION .env
SW_FRONTEND_VERSION=v6.0.3
SW_BACKEND_VERSION=v6.0.3
SW_HELPCENTER_VERSION=v6.0.3
```

###

### Обновление

:::tip
Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально
:::

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

```bash
docker compose pull
docker compose down
docker compose up -d
```

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

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

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

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

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

```bash
docker system prune -a
```

:::tip
ВАЖНО! Убедитесь, что все контейнеры успешно запустились, перед запуском этой команды
:::

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

`__ai_mcp_agents `- включает возможность создания ИИ-агентов  (см. [возможности ИИ провайдеров](https://support.swarmica.com/article/ru/1615))

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

`ui_widgets` - включает возможность встраивать в [интерфейс Swarmica произвольные виджеты](https://support.swarmica.com/article/ru/1898-sobstvennye-vidzhety-v-swarmica-veb-plaginy.html)

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

`__password_blacklist` - включает возможность управления списком скомпроментированных паролей и запрещать их к использованию. [Читать подробнее](https://support.swarmica.com/article/ru/1708-zapret-na-ispolzovanie-skompromentirovannyh-parolej.html)

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

## 🤖 ИИ-агенты

Появилась возможность создавать полноценных ИИ-агентов, которые могут использовать инструменты 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`

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

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

*   🧩 Собственные настройки основных экранов в заявке, статье, карточке пользователя, организации, лицензионного ключа и актива. Возможность задавать порядок боксов, порядок полей, скрывать поля, который применяется для всех пользователей по умолчанию.
*   🧩 [Добавление веб-плагинов через механизм кастомных виджетов](https://support.swarmica.com/article/ru/1898-sobstvennye-vidzhety-v-swarmica-veb-plaginy.html) (фича-флаг `ui_widgets`) позволит расширить возможности интерфейса Swarmica и подключить различные внешние системы и веб-виджеты для сотрудников и клиентов
*   ✉️ Возможность добавлять кастомизируемое сообщение в форме тикета, для того, чтобы проинформировать клиентов о различных важных нюансах: например, куда обращаться с запросами по приобритению продукта, как продлить лицензию и т.д. Сообщение гибко параметризуется за счет использования шаблонов Jinja.
*   👁️ Возможность скрывать поле «Приоритет» на форме создания
*   🖼️ Возможность задавать кастомную иконку для встраиваемого чат-виджета
*   🎨 [Поддержка стилизации встраиваемого чат-виджета](https://support.swarmica.com/article/ru/1823-css-stili-v-vidzhete.html) через 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 для группы в фильтрах тикетов