# Обновление 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-ustanovka-obnovlenij-swarmica.html#perehod-na-avtoobnovlenie). После успешной установки обновления, запустите очистку неиспользуемых данных: ```txt docker system prune -a ``` ## ✨ Основные улучшения ### 🤖 ИИ-агенты ИИ-агенты получили шесть новых компетенций: теперь они не только проверяют качество, но и разбирают апелляции по оценкам и берут на себя рутинную работу с базой знаний. Функции доступны при включённом фича-флаге `__ai_mcp_agents`. * ⚖️ Обработка апелляций по качеству сервиса (QA), качеству контента (AQI) и точности связанности (LAI) — ИИ-агент анализирует возражения оцениваемых сотрудников, при обоснованных доводах корректирует оценку, а в остальных случаях даёт развёрнутое объяснение и подводит итог рассмотрения в общем комментарии * ✍️ Редактор статей — приводит проверенные статьи к контент-стандарту и стилю компании: исправляет грамматику, стандартизирует оформление и публикует готовые статьи * 🔎 SEO/GEO/AEO-оптимизация статей — заполняет мета-теги и разметку JSON-LD опубликованных статей, чтобы поисковики и нейросети корректно ранжировали базу знаний * 🌐 Переводчик статей — переводит опубликованные статьи, у которых есть только одна локаль, с сохранением форматирования * 🎛️ Обновлённый диалог выбора компетенции при создании ИИ-агента и быстрый поиск по компетенциям * 🔄 Статус ИИ-агента и ход выполнения его задач обновляются в интерфейсе в реальном времени, а статусы запусков выделены цветом * 💰 Существенно снижен расход токенов при работе ИИ-агентов через YandexGPT — стоимость запусков стала сопоставимой с ChatGPT * 🧠 Улучшен промпт ИИ-агента по умолчанию: ответы опираются только на предоставленные материалы * 🇬🇧 Встроенные промпты и инструкции ИИ-функций на новых установках поставляются на английском языке, что снижает расход токенов; на уже работающих системах промпты не меняются ### 📚 Хелпцентр и SEO * 🏷️ Поля JSON-LD (разметка schema.org) и произвольный HTML для `` во вкладке SEO статьи — данные автоматически выводятся на страницах хелпцентра и помогают статьям подниматься выше в поисковой выдаче и ответах нейросетей * 🤖 Страницы статей подсказывают LLM-ботам Markdown-версию статьи, а при включённом фича-флаге `__llmstxt` — ссылку на llms.txt * 📄 Файл `/llms-full.txt` с публичными статьями базы знаний для LLM; число статей в `/llms.txt` и `/llms-full.txt` задаётся переменной `NEXT_PUBLIC_LLMSFULL_MAX_ARTICLE` * ⚡ Ускорено открытие категорий базы знаний ### 💬 Чаты и чат-виджет * 🔑 Регистрация и сброс пароля в чат-виджете (для авторизации по email) с поддержкой политики паролей и лицензионного соглашения — пользователи, чьи аккаунты были созданы автоматически, теперь могут обратиться в поддержку через виджет. В письма о регистрации добавлен код для ручного ввода * 🔀 Кнопка «Ответ + статус» в чатах, как в заявках * 📝 Черновик сообщения сохраняется при переключении между чатами — удобно, когда агент ведёт несколько диалогов одновременно * 🖼️ Превью изображений и файлов при написании сообщения в виджете и поддержка изображений внутри сообщений чата * ⚡ Ускорена загрузка списка чатов и сообщений * 👥 Чаты автоматически назначаются и на агентов в статусе «В чате»: сначала на агентов «Онлайн», затем с учётом загрузки на остальных ### 🖥️ Улучшения UI/UX * 🔗 При создании заявки по ссылке с параметрами можно передать значение `$null`, чтобы очистить поле формы (например, копию CC) — это исключает подстановку данных из предыдущей заявки и отправку писем на неверные адреса при массовом создании заявок из личного кабинета * ⏸️ В быстром выборе срока отложенного статуса появились варианты на 15 и 30 минут * ⚠️ При смене продукта в массовом редактировании заявок показывается предупреждение о том, что зависимые поля будут сброшены * 💬 Счётчик общих комментариев к оценке качества — сразу видно, есть ли комментарии, без раскрытия блока * ⚠️ Понятные сообщения об ошибках при загрузке файлов в форме создания заявки и при превышении лимита запросов * 🔔 Предупреждение о новых изменениях в статье появляется сразу, без перезагрузки страницы * 📜 Кнопка «Показать ещё» в выпадающих списках с поиском (категории, группы, организации, пользователи, навыки, лицензии и др.) * 🧹 Из условий автоназначения убран «Статус пользователя» — статусы теперь напрямую управляют автоназначением * 🖼️ При загрузке фавикона, логотипа и спиннера доступны только поддерживаемые форматы файлов ### ⚙️ Производительность и обслуживание * 🔄 [Автоматическое обновление](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, обновление статуса сотрудника и индикатора на аватаре, работа кнопки «Ответ + статус», закрытие чата и отправка опроса CSAT в виджете, самопроизвольная смена статуса агента из «Не в сети» * 🪟 Чат-виджет: исправлены сброс сессии при переходе между страницами личного кабинета, вставка скриншотов через Ctrl+V, стили и заголовки в списке чатов * 📧 Почта: исправлена обработка писем в нестандартных кодировках (в том числе ISO-2022-JP), обрезание части письма, цитирование переписки, обработка больших писем и писем с некорректной разметкой, тема уведомления с расшифровкой чата * 🎫 Заявки: исправлены сброс ответственного при создании, переходы статусов, работа дочерних заявок, очистка поля «Истечение SLA», отображение политик OLA и локаль подписи * ⚙️ Автоматизации: в контекст триггеров и периодических задач передаются переменные по умолчанию, исправлены условия с исключением значений в триггерах * 📚 База знаний: нейропоиск больше не предлагает исходную статью как дубликат, в KCS-виджете не пропадают блоки кода и скриншоты, исправлены увеличение изображений после смены локали, вставка изображений в таблицы и ошибка при отмене изменений в редакторе статьи, ошибки при обходе хелпцентра поисковыми роботами * 📈 Контроль качества: исправлены пустые карточки AQI/LAI на новых установках и мелкие ошибки интерфейса * ⚙️ Настройки: домен бренда в ссылках, удаление продуктов с версиями и редакциями, отключение максимальной длины пароля, создание администратора при нехватке мест в лицензии, выбор ролей сотрудников при истёкшей лицензии, отображение всех групп в настройках сотрудника, выгрузка поля «Каналы уведомлений», поле темы при создании макроса * 🤖 ИИ: загрузка файлов ИИ-агентами через MCP, создание ИИ-агентов у неподдерживаемых провайдеров, качество перевода ИИ-ассистентом * 🔐 Исправлены уязвимости и повышена безопасность системы ## Новые переменные окружения В версии 6.1.0 появились новые параметры в файле `.env`. Задавать их не обязательно: если переменная не указана, используется значение по умолчанию. | Переменная | По умолчанию | Описание | | ----------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `UPLOAD_BASE64_MAX_SIZE_MB` | `15` | Максимальный размер файла (МБ), загружаемого через API в формате base64. `0` — без ограничений. | | `REQUEST_BODY_MAX_SIZE_MB` | `15` | Максимальный размер тела запроса к API (МБ) в формате JSON или form-urlencoded. На загрузку файлов через multipart не влияет. `0` — без ограничений. | | `UPLOAD_MULTIPART_MAX_SIZE_MB` | `2048` | Максимальный размер файла (МБ), загружаемого через multipart/form-data. `0` — без ограничений. | | `COMMENT_ATTACHMENT_UPLOAD_THROTTLE_RATE` | `20/min` | Ограничение частоты загрузки вложений к комментариям для одного пользователя в формате `<число>/`. `0` — без ограничений. | | `CHAT_WRAPUP_MINUTES` | `15` | Сколько минут агент находится в статусе «Завершение чата» после последнего активного чата, прежде чем вернуться в статус «В сети». `0` — агент сразу возвращается в статус «В сети». | Ограничения на размер и частоту загрузки не распространяются на вложения во входящих письмах. В версии 6.1.1 добавлена переменная хелпцентра: | Переменная | По умолчанию | Описание | | ---------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `NEXT_PUBLIC_LLMSFULL_MAX_ARTICLE` | `500` | Число публичных статей с доступом «Все», которые попадают в `/llms.txt` и `/llms-full.txt`. Если задаёте больше 500, увеличьте и `MAX_PAGINATION_LIMIT`. |