#2118: Update v6.1.x

Instruction

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.

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.

After successfully installing the update, run the cleanup of unused data:

docker system prune -a

✨ 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.

• ⚖️ Processing 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 verified articles to the content standard and company 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.
• 💰 Significantly reduced token consumption when AI agents work through YandexGPT — the cost of launches has become comparable to ChatGPT.
• 🧠 Improved default AI agent prompt: responses rely only on the provided materials.
• 🇬🇧 Built-in prompts and instructions for AI functions in new installations are 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 custom 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 __llmstxt feature flag enabled, they provide a link to llms.txt.
• 📄 /llms-full.txt file with public articles from the knowledge base for LLM; the number of articles in /llms.txt and /llms-full.txt is set by the NEXT_PUBLIC_LLMSFULL_MAX_ARTICLE variable.
• ⚡ Faster opening of knowledge base categories.

💬 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 input is added to registration emails.
• 🔀 «Response + Status» button in chats, like in requests.
• 📝 The draft message is saved when switching between chats — convenient when an agent is conducting several dialogs simultaneously.
• 🖼️ Preview of images and files when writing a message in the widget and support for images inside chat messages.
• ⚡ Accelerated loading of the chat list and messages.
• 👥 Chats are automatically assigned to agents in the «In Chat» status: first to «Online» agents, then taking into account the load on others.

🖥️ UI/UX Improvements

• 🔗 When creating a request by a link with parameters, you can pass the $null value to clear the form field (for example, a CC copy) — this prevents the substitution of data from the previous request and the sending of emails to incorrect addresses when creating requests in bulk from the personal account.
• ⏸️ The quick selection of the deferred status period now includes options for 15 and 30 minutes.
• ⚠️ When changing the product in bulk editing of requests, a warning is displayed that dependent fields will be reset.
• 💬 Counter of common comments to the quality assessment — you can immediately see if there are comments without opening the block.
• ⚠️ 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.).
• 🧹 «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-plan and make upgrade.
• 🐧 Support for Ubuntu 26.04 LTS and AltLinux 11.
• 🩺 Improved checking of the health of Docker services.
• 🏷️ Command python manage.py show_version to view the current version of Swarmica.

🐞 Fixes

• 💬 Chats: automatic «In Chat» and «End Chat» statuses restored, duplication and loss of messages fixed, chat forking, forwarding of responses to messages with images from Telegram, updating of employee status and avatar indicator, «Response + Status» button working, chat closing and sending CSAT survey in the widget, agent status changing from «Offline» spontaneously.
• 🪟 Chat widget: fixed session reset when switching between personal account pages, Ctrl+V screenshot insertion, styles, and headings in the chat list.
• 📧 Email: 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 emails with incorrect markup, chat notification subject with расшифровкой.
• 🎫 Requests: fixed reset of the responsible person when creating, status transitions, work of sub-requests, clearing the «SLA Expiration» field, display of OLA policies and locale signature.
• ⚙️ Automations: default variables passed to triggers and periodic tasks, conditions with value exceptions in triggers 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, fixed image enlargement after locale change, image insertion into tables, and error when canceling changes in the article editor, errors when crawling the help center by search robots.
• 📈 Quality control: fixed empty AQI/LAI cards on new installations and minor interface errors.
• ⚙️ Settings: brand domain in links, deletion of products with versions and editions, disabling maximum password length, creating an administrator when there are not enough license seats, selecting employee roles with an expired license, displaying all groups in employee settings, exporting the «Notification Channels» field, macro subject field.
• 🤖 AI: AI agent file loading via MCP, creating AI agents with unsupported providers, AI assistant translation quality.
• 🔐 Vulnerabilities fixed and system security improved.

New Environment Variables

In version 6