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

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

Если у вас установлена версия ниже v6.0.x, сначала обновитесь до v6.0.x вручную, последовательно выполняя инструкции для каждой промежуточной версии: например, если у вас v5.10.x, то сначала нужно обновиться до v5.11.x, затем до v5.12.x и до v6.0.x.
:::

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

Начиная с v6.0.x обновление выполняется с помощью [механизма автообновления](https://support.swarmica.com/article/ru/1955). Промежуточные версии можно не устанавливать: план обновления строится до последнего релиза автоматически.

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

Выполните в каталоге установки Swarmica:

```bash
cd /root/swarmica
make upgrade-plan    # показать план обновления, ничего не меняя
make upgrade         # выполнить обновление
```

Если вы ещё не перешли на автообновление, выполните шаги из раздела «Переход на автообновление» в [инструкции по установке обновлений](https://support.swarmica.com/article/ru/1955).

## ✨ Основные улучшения

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

ИИ-агенты получили шесть новых компетенций: теперь они не только проверяют качество, но и разбирают апелляции по оценкам и берут на себя рутинную работу с базой знаний. Функции доступны при включённом фича-флаге `__ai_mcp_agents`.

*   ⚖️ Обработка апелляций по качеству сервиса (QA), качеству контента (AQI) и точности связанности (LAI) — ИИ-агент анализирует возражения оцениваемых сотрудников, при обоснованных доводах корректирует оценку, а в остальных случаях даёт развёрнутое объяснение и подводит итог рассмотрения в общем комментарии
*   ✍️ Редактор статей — приводит проверенные статьи к контент-стандарту и стилю компании: исправляет грамматику, стандартизирует оформление и публикует готовые статьи
*   🔎 SEO/GEO/AEO-оптимизация статей — заполняет мета-теги и разметку JSON-LD опубликованных статей, чтобы поисковики и нейросети корректно ранжировали базу знаний
*   🌐 Переводчик статей — переводит опубликованные статьи, у которых есть только одна локаль, с сохранением форматирования
*   🎛️ Обновлённый диалог выбора компетенции при создании ИИ-агента и быстрый поиск по компетенциям
*   🔄 Статус ИИ-агента и ход выполнения его задач обновляются в интерфейсе в реальном времени, а статусы запусков выделены цветом
*   💰 Существенно снижен расход токенов при работе ИИ-агентов через YandexGPT — стоимость запусков стала сопоставимой с ChatGPT
*   🧠 Улучшен промпт ИИ-агента по умолчанию: ответы опираются только на предоставленные материалы
*   🇬🇧 Встроенные промпты и инструкции ИИ-функций на новых установках поставляются на английском языке, что снижает расход токенов; на уже работающих системах промпты не меняются

### 📚 Хелпцентр и SEO

*   🏷️ Поля JSON-LD (разметка schema.org) и произвольный HTML для `<head>` во вкладке SEO статьи — данные автоматически выводятся на страницах хелпцентра и помогают статьям подниматься выше в поисковой выдаче и ответах нейросетей
*   🤖 Страницы статей подсказывают LLM-ботам Markdown-версию статьи, а при включённом фича-флаге `__llmstxt` — ссылку на llms.txt
*   ⚡ Ускорено открытие категорий базы знаний

### 💬 Чаты и чат-виджет

*   🔑 Регистрация и сброс пароля в чат-виджете (для авторизации по email) с поддержкой политики паролей и лицензионного соглашения — пользователи, чьи аккаунты были созданы автоматически, теперь могут обратиться в поддержку через виджет. В письма о регистрации добавлен код для ручного ввода
*   🔀 Кнопка «Ответ + статус» в чатах, как в заявках
*   📝 Черновик сообщения сохраняется при переключении между чатами — удобно, когда агент ведёт несколько диалогов одновременно
*   🖼️ Превью изображений и файлов при написании сообщения в виджете и поддержка изображений внутри сообщений чата
*   ⚡ Ускорена загрузка списка чатов и сообщений
*   👥 Чаты автоматически назначаются и на агентов в статусе «В чате»: сначала на агентов «Онлайн», затем с учётом загрузки на остальных

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

*   🔗 При создании заявки по ссылке с параметрами можно передать значение `$null`, чтобы очистить поле формы (например, копию CC) — это исключает подстановку данных из предыдущей заявки и отправку писем на неверные адреса при массовом создании заявок из личного кабинета
*   ⚠️ Понятные сообщения об ошибках при загрузке файлов в форме создания заявки и при превышении лимита запросов
*   🔔 Предупреждение о новых изменениях в статье появляется сразу, без перезагрузки страницы
*   📜 Кнопка «Показать ещё» в выпадающих списках с поиском (категории, группы, организации, пользователи, навыки, лицензии и др.)
*   🧹 Из условий автоназначения убран «Статус пользователя» — статусы теперь напрямую управляют автоназначением
*   🖼️ При загрузке фавикона, логотипа и спиннера доступны только поддерживаемые форматы файлов

### ⚙️ Производительность и обслуживание

*   🔄 [Автоматическое обновление](https://support.swarmica.com/article/ru/1955) командами `make upgrade-plan` и `make upgrade`
*   🐧 Поддержка Ubuntu 26.04 LTS и AltLinux 11
*   🩺 Улучшена проверка работоспособности сервисов Docker
*   🏷️ Команда `python manage.py show_version` для просмотра текущей версии Swarmica

### 🐞 Исправления

*   💬 Чаты: восстановлены автоматические статусы «В чате» и «Завершение чата», исправлены дублирование и пропадание сообщений, форк чата, пересылка ответов на сообщения с изображениями из Telegram, обновление статуса сотрудника и индикатора на аватаре
*   🪟 Чат-виджет: исправлены сброс сессии при переходе между страницами личного кабинета, вставка скриншотов через Ctrl+V, стили и заголовки в списке чатов
*   📧 Почта: исправлена обработка писем в нестандартных кодировках (в том числе ISO-2022-JP), обрезание части письма, цитирование переписки, обработка больших писем и тема уведомления с расшифровкой чата
*   🎫 Заявки: исправлены сброс ответственного при создании, переходы статусов, работа дочерних заявок, очистка поля «Истечение SLA», отображение политик OLA и локаль подписи
*   📚 База знаний: нейропоиск больше не предлагает исходную статью как дубликат, в KCS-виджете не пропадают блоки кода и скриншоты, исправлены увеличение изображений после смены локали и ошибка при отмене изменений в редакторе статьи
*   📈 Контроль качества: исправлены пустые карточки AQI/LAI на новых установках и мелкие ошибки интерфейса
*   ⚙️ Настройки: домен бренда в ссылках, удаление продуктов с версиями и редакциями, отключение максимальной длины пароля, создание администратора при нехватке мест в лицензии, выбор ролей сотрудников при истёкшей лицензии, отображение всех групп в настройках сотрудника, выгрузка поля «Каналы уведомлений», поле темы при создании макроса
*   🤖 ИИ: загрузка файлов ИИ-агентами через MCP, создание ИИ-агентов у неподдерживаемых провайдеров, качество перевода ИИ-ассистентом
*   🔐 Исправлены уязвимости и повышена безопасность системы
