Инструкция

Подготовка

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

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.0.1
SW_BACKEND_VERSION=v5.0.1

Обновление

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

docker compose pull
docker compose up -d --remove-orphans
docker compose restart traefik

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

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

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

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

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команду обновления числа статей, привязанных к заявкам:

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

3. Запустите команду перенастройки почтовых уведомлений в системе:

docker exec --env-file .env -it swarmica-django-1 python manage.py setup_email_notifications --update-existing

4. Если в системе используются функции ИИ, то необходимо запустить подсчет метрики потребления токенов:

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

Если ИИ не используется, то данную команду запускать не нужно.

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

docker system prune -a

🧠 AI-функции

• ✍ Перефразировка текста — сохранение нужного tone of voice в тикетах, статьях и чатах.
• ✅ Проверка текста (Proofread) — автоматическая корректура текста в тикетах, статьях и чатах.
• 🌐 Перевод ответов — на русский и английский языки (можно добавлять любые другие).
• 🔍 Автопоиск решения — при написании ответа выполняется поиск информации в «глобальном интернете».
• 📏 Сжатие и расширение текста — сокращение длинных или детализация коротких ответов.
• 🎯 Нулевая линия — автоматическая классификация входящих заявок и маршрутизация на агентов по навыкам и загрузке, с возможностью обучения.
• 🤝 Синергия с KCS
  • 💡 Автоматическое предложение решения клиенту ещё до создания заявки.
  • 🛠 ИИ-ассистент для агента — помощь в поиске узкоспециализированного решения в Базе знаний.
  • 📝 Автоматический анализ заявки и создание черновика статьи базы знаний.
  • 🔎 Проверка создаваемой статьи на возможные дубликаты.

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

• 📦 Массовые действия с тикетами — обновление сразу нескольких заявок, уведомления о выполнении.
• ⚙️ QA: Конфигурируемые карточки наборов критериев для разных групп агентов.
• 🤖 Новые возможности автоназначения — правила по навыкам агентов, времени создания тикета, удобный выбор исполнителя.
• 📧 Работа с копиями (CC) — добавление и управление адресами копий при создании, обновлении и форке тикетов, в UI и через API.
• 🛑 Блокировка автоответов — возможность отключать автоматические ответы сторонних систем для предотвращения "битвы роботов".
• 💬 Цитирование комментариев — поддержка цитат в тикетах, в том числе в VK и Telegram.
• 🔗 Новые поля и типы данных — кастомное поле «ссылка», расширенные параметры форм тикетов.
• 📊 Статистика потребления AI-токенов с фильтрацией и экспортом.
• 🔍 Улучшенный фильтр и поиск — новые операторы поиска (по задачам/issues, организациям, навыкам, идентичности пользователей), удобный выбор пользователей в фильтрах.
• 🖱 Формы и кнопки — унифицированные кнопки сохранения/отмены в редакторах правил, фильтров, EULA.
• 🎨 UI и UX улучшения
  • Тёмная тема с поддержкой собственного логотипа и спиннера.
  • Отправка сообщений в чат по Ctrl/Cmd+Enter.
  • Подсветка синтаксиса Jinja2, поддержка Kotlin и YAML в редакторе кода.
  • Более удобное редактирование данных о пользователях, организациях и заявках.
  • Возможность копировать системные фильтры, автоматические правила и другие настройки.
  • Оптимизация скорости работы таблиц и редактора статей.

🔧 Исправленные ошибки

• ✅ Обновление статуса и мердж тикетов — исправлены проблемы с изменением статуса и логикой объединения заявок.
• 🔗 Поля и ссылки — корректное сохранение пользовательских полей, отображение ссылок и связанных статей.
• 👥 Автоназначение — исправлено поведение при изменении исполнителя системой.
• 💬 Работа с чатом
  • Устранено «скакание» курсора в Firefox.
  • Исправлена логика кнопок отправки сообщений.
• 🛡 Лицензии, фильтры и роли — корректная работа прав доступа и фильтров при различных настройках лицензий.
• 🌍 Локализация — исправлено отображение статей и переводов при смене языка.
• 📝 Редакторы — исправлены ошибки при подсветке синтаксиса в шаблонах писем и вставке ссылок.
• 🔄 Интеграции с Billmanager — исправлены ошибки синхронизации пользователей и тикетов.
• 📎 Вложения — исправлена обработка вложений и превью в массовых операциях.