Update v6.0.x

Preparation

To update, check that the configuration file .env has the following version:

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

Update

Perform the update with a system restart:

docker compose pull
docker compose down
docker compose up -d

After update

After all containers have started and the service becomes available through the web interface, perform post-upgrade steps:

1. Run the post_start command to update static files, search indexes, and perform other necessary procedures:

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

2. Run the cleanup of unused data:

docker system prune -a

New feature flags

__ai_mcp_agents - enables the creation of AI agents (see AI provider capabilities)

rca - enables managing Root Cause Analysis (RCA) documents

ui_widgets - enables embedding arbitrary widgets into the Swarmica interface

child_tickets - enables creating related child tickets, similar to external_tickets, but internal child tickets are counted in statistics and are intended for the work of company employees, not external recipients

__password_blacklist - enables managing the list of compromised passwords and prohibiting their use. Read more

🚀 What's new in the update

🤖 AI agents

The ability to create full-fledged AI agents has appeared, which can use MCP tools to perform routine tasks, taking over monotonous work from employees. This update introduces three AI agent competencies:

1. Quality Assurance evaluator (QA evaluator)
2. Content Quality evaluator (AQI evaluator)
3. Relevance Accuracy evaluator (LAI evaluator)

These features are available with YandexGPT and ChatGPT AI providers and are enabled by the feature flag __ai_mcp_agents

🔍 RCA

The ability to create documents with Root Cause Analysis of an incident (RCA) has been added, as well as the ability to share these documents with clients through the system interface or export in PDF and Markdown formats. For greater convenience when working with RCA, there are the following functions:

• 🤖 AI-generated RCA document
• 📋 RCA templates
• 🔒 The ability to add internal information that will not be visible to clients

Enabled by the feature flag rca

🎨 Customizing the interface

This update introduces powerful and flexible tools for personalizing and styling the system interface to meet your support team's needs.

• 🧩 Custom settings for the main screens in the ticket, article, user card, organization, license key, and activation. The ability to set the order of boxes, the order of fields, hide fields, which is applied to all users by default.
• 🧩 Adding web plugins via the custom widgets mechanism (feature flag ui_widgets) will expand the capabilities of the Swarmica interface and connect various external systems and web widgets for employees and clients
• ✉️ The ability to add customizable messages in the ticket form to inform clients about various important details: for example, where to turn for product purchase inquiries, how to extend the license, etc. The message is flexibly parametrized using Jinja templates.
• 👁️ The ability to hide the "Priority" field on the ticket creation form
• 🖼️ The ability to set a custom icon for the embedded chat widget
• 🎨 Support for styling the embedded chat widget via CSS brand themes