#2118: Update v6.1.x
Отредактирована: сегодняInstruction
IMPORTANT! Before updating to v6.1.x, you must have a version of Swarmica not lower than v6.0.x.
If you have a version below v6.0.x, first update to v6.0.x manually, following the instructions for each intermediate version: for example, if you have v5.10.x, you need to update to v5.11.x first, then to v5.12.x, and finally to v6.0.x.
Update
Starting from v6.0.x, the update is performed using the auto-update mechanism. Intermediate versions do not need to be installed: the update plan is built to the latest release automatically.
There will be a service interruption for several minutes; it is recommended to perform the update during hours when system usage is minimal.
Execute in the Swarmica installation directory:
cd /root/swarmica
make upgrade-plan # show the update plan without making any changes
make upgrade # perform the update
If you have not yet switched to auto-update, follow the steps in the «Switching to Auto-Update» section in the update installation instructions.
✨ Key Improvements
🤖 AI Agents
AI agents have received six new competencies: now they not only check quality but also handle appeals regarding assessments and take on routine work with the knowledge base. The features are available with the __ai_mcp_agents feature flag enabled.
- ⚖️ Handling appeals for service quality (QA), content quality (AQI), and accuracy of linkage (LAI) — the AI agent analyzes the objections of the assessed employees, corrects the assessment if there are reasonable arguments, and in other cases provides a detailed explanation and summarizes the review in a general comment.
- ✍️ Article editor — brings checked articles to the company's content standard and style: corrects grammar, standardizes formatting, and publishes ready-made articles.
- 🔎 SEO/GEO/AEO optimization of articles — fills in meta tags and JSON-LD markup of published articles so that search engines and neural networks rank the knowledge base correctly.
- 🌐 Article translator — translates published articles that have only one locale, preserving formatting.
- 🎛️ Updated dialog for selecting competencies when creating an AI agent and quick search by competencies.
- 🔄 The status of the AI agent and the progress of its tasks are updated in the interface in real time, and launch statuses are highlighted in color.
- 💰 The token consumption has been significantly reduced when working with AI agents through YandexGPT — the cost of launches has become comparable to ChatGPT.
- 🧠 The default AI agent prompt has been improved: the responses rely only on the provided materials.
- 🇬🇧 Built-in prompts and instructions for AI functions in new installations are provided in English, which reduces token consumption; prompts are not changed on already running systems.
📚 Help Center and SEO
- 🏷️ JSON-LD fields (schema.org markup) and arbitrary HTML for
<head>in the SEO tab of the article — the data is automatically displayed on help center pages and helps articles rank higher in search results and neural network responses. - 🤖 Article pages suggest the Markdown version of the article to LLM bots, and with the
__llmstxtfeature flag enabled, they provide a link to llms.txt. - ⚡ Opening of knowledge base categories has been accelerated.
💬 Chats and Chat Widget
- 🔑 Registration and password reset in the chat widget (for email authorization) with support for password policy and license agreement — users whose accounts were created automatically can now contact support through the widget. A code for manual entry has been added to registration emails.
- 🔀 «Reply + Status» button in chats, similar to requests.
- 📝 The draft message is saved when switching between chats — convenient when an agent is conducting multiple dialogues simultaneously.
- 🖼️ Preview of images and files when writing a message in the widget and support for images inside chat messages.
- ⚡ The loading of the chat and message list has been accelerated.
- 👥 Chats are automatically assigned to agents with the «In Chat» status: first to «Online» agents, then considering the load on others.
🖥️ UI/UX Improvements
- 🔗 When creating a request by a link with parameters, you can pass the
$nullvalue to clear the form field (for example, a copy of CC) — this excludes the substitution of data from the previous request and sending emails to incorrect addresses when creating requests in bulk from the personal account. - ⚠️ Clear error messages when uploading files in the request creation form and when exceeding the request limit.
- 🔔 A warning about new changes in the article appears immediately, without reloading the page.
- 📜 «Show More» button in dropdown lists with search (categories, groups, organizations, users, skills, licenses, etc.).
- 🧹 The «User Status» has been removed from auto-assignment conditions — statuses now directly control auto-assignment.
- 🖼️ Only supported file formats are available when uploading a favicon, logo, and spinner.
⚙️ Performance and Maintenance
- 🔄 Automatic update with the commands
make upgrade-planandmake upgrade. - 🐧 Support for Ubuntu 26.04 LTS and AltLinux 11.
- 🩺 Improved checking of Docker service health.
- 🏷️ Command
python manage.py show_versionto view the current version of Swarmica.
🐞 Fixes
- 💬 Chats: automatic statuses «In Chat» and «End Chat» restored, duplication and loss of messages fixed, chat forking, forwarding of responses to messages with images from Telegram, updating the employee status and indicator on the avatar.
- 🪟 Chat widget: session reset when switching between personal account pages fixed, Ctrl+V screenshot insertion, styles, and headings in the chat list.
- 📧 Mail: handling of emails in non-standard encodings (including ISO-2022-JP) fixed, truncation of part of the email, quoting correspondence, handling of large emails, and notification subject with chat расшифровки.
- 🎫 Requests: reset of the responsible person when creating, status transitions, operation of sub-requests, clearing the «SLA Expiration» field, display of OLA policies and locale of the signature fixed.
- 📚 Knowledge base: neural search no longer suggests the original article as a duplicate, code blocks and screenshots do not disappear in the KCS widget, image enlargement after locale change and error when canceling changes in the article editor fixed.
- 📈 Quality control: empty AQI/LAI cards on new installations and minor interface errors fixed.
- ⚙️ Settings: brand domain in links, removal of products with versions and editions, disabling maximum password length, creation of administrator when license seats are insufficient, selection of employee roles when license has expired, display of all groups in employee settings, export of «Notification Channels» field, theme field when creating a macro.
- 🤖 AI: loading of files by AI agents via MCP, creation of AI agents by unsupported providers, quality of translation by AI assistant.
- 🔐 Vulnerabilities fixed and system security enhanced.