# Фича-флаги FEATURES: возможность включать и выключать блоки функций в Swarmica # Описание Фича-флаги позволяют включать и выключать определенные функции системы в рамках лимитов установленной лиценизии. Мехнизм подключения фичей следующий: * Лицензия определяет, какие фичи **можно** включать * Набор фича-флагов в `/root/swarmica/.env` в переменной `FEATURES` определяет, какие фичи на данном инстансе включены В результате, применяется пересечение того, что разрешает лицензия и того, что записано в `FEATURES`: * Если фича есть и в лицензии и в `FEATURES`, то фича будет **включена** * Если фича есть только в лицензии, но нет в `FEATURES` - она будет **выключена**. А если прописать ее в `FEATURES` и перезагрузить приложение, тогда это сводится к предыдущему пункту, т.е. фича будет включена * Если фича есть в `FEATURES`, но нет в лицензии, то она будет **выключена**. Чтобы она заработала, необходимо связаться с аккаунт-менеджером или поддержкой Swarmica и подтвердить подключение фичи на лицензии. После чего можно будет в разделе **Настройки > Основные настройки > Лицензия Swarmica** обновить данные ключа и фича будет включена. Фича-флаги с префиксом `__` не проверяются лицензией. :::caution Все фича-флаги должны быть указаны через запятую, без пробелов: ```txt FEATURES=automations,automations_outgoing_emails,... ``` ::: # Фича-флаги | Фича-флаг | Что делает | Появился в версии | | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- | | `__ai_create_draft` | Включает фичу автосоздания черновика KCS, требует `ai` | 4.7.2 | | `__ai_assistant` | Включает ИИ ассистента по нейропоиску, требует `ai` | 4.7.0 | | `__ai_agent` | Включает ИИ-агента, который может отвечать на тикеты. Требует `ai`, и должен быть настроенный публичный AI assistant | 5.2.0, не используется с 6.0.0 | | `__ai_mcp_agents` | Включает возможность создания ИИ-агентов (см. [возможности ИИ провайдеров](https://support.swarmica.com/article/ru/1615)) | 6.0.0 | | `__ai_ticket_classifier` | Включает ИИ классификатор тикетов, требует `ai` | 4.7.0 | | `__ai_ticket_summary` | Для провайдеров, которые поддерживают возможность резюмировать заявки, включает фичу резюмирования заявки, требует `ai` | начиная с 5.12.0 | | `__ai_mdxeditor` | Включает ИИ ассистента в редакторе статей, требует флаг `ai` | 4.6.0 | | `automations` (до v5.8.0 `__automations`) | Включает API и UI автоматизаций (исходящие вебхуки, емейлы, рантайм скрипты, триггеры, кронджобы) | 5.2.0 | | `__customer_chat` | Разрешает клиентам инициировать чат из UI свормики | 4.6.0 | | `__customers_search_cfs` | Включает быстропоиск по кастомфилдам для клиентов | 5.5.0 | | `__delete_comment_attachments` | Разрешает удалять вложения из заявок | начиная с 5.12.0 | | `__employee_segments` | Добавляет возможность экспериментальной функциональности - сегменты сотрудников (установка Навыков, статуса, Группы и Роли в сегментах) | начиная с 5.9.2 | | `__empty_requester` | Убирает автоматическую подстановку учетной записи текущего пользователя в поле "Заявка от" на форме создания тикета (только для сотрудников) | начиная с 5.10.0 | | `__helpcenter` | Отключает роутинг запросов хелпцентра в приложении frontend, требуется отдельный контейнер helpcenter для обслуживания хелпцентра | не используется с 5.9.0 | | `external_tickets` (до v5.8.0 `__external_tickets`) | Включает UI для работы с External Ticket | 5.3.0 | | `__llmstxt` | Включает [индексацию публичных статей для LLM](https://support.swarmica.com/article/ru/1483) (генерирует файл /llms.txt) | 5.9.0 | | `__mandatory_timelog` | Заставляет заполнять таймлог, чтобы отправить публичный ответ в тикет, требует флага `time_tracking` | | | `__password_blacklist` | Включает возможность управления списком скомпроментированных паролей и запрещать их к использованию. [Читать подробнее](https://support.swarmica.com/article/ru/1756-zapret-na-ispolzovanie-skompromentirovannyh-parolej.html) | 6.0.0 | | `__private_attachments` | Отключает возможность отправлять вложенные файлы в почтовых уведомлениях, а так же дополнительно защищает доступ к таким файлам | начиная с 5.12.0 | | `__smtp_email_channel` | Разрешает создавать новые SMTP каналы. Если этого флага нет, то новые каналы можно создавать только как IMAP каналы, а старые SMTP все так же будут доступны для настройки. Для тех, кто включает эту фичу, так же нужно добавить postfix контейнер в docker-compose.yml | | | `__show_jwt_token` | Добавляет возможность копировать JWT токен пользователям в своем профиле (только для ролей Агент, Менеджер, Администратор) и использовать в автоматизациях через API | начиная с 5.9.2 | | `__helpcenter_home_products` | Делает стартовую страницу хелпцентра страницей выбора продуктов | 4.6.0 | | `__widget_closed_chats` | Показывает завершенные чаты в виджете | | | `__show_ticket_duplicates` | Показывает блок "Возможные дубли" в тикете | 5.1.3 | | `2fa` | Включает возможность настройки двухфакторной аутентификации 2FA | 5.9.0 | | `ai` | Включает (разрешает) все AI фичи, автоматически включается перефразировщик в редакторе комментариев, все остальные фичи включаются отдельными фича-флагами `__ai*` | | | `__article_comments` (до v5.8.0 `article_comments`) | Разрешает публичные комментарии к статьям от клиентов | | | `assets` | Включает управление Активами | 4.8.0 | | `billmanager` | Включает интеграцию с Billmanager6 | | | `beeline_pbx` | Включает интеграцию с Beeline Cloud PBX | 5.3.0 | | `chats` | Включает фичу Чаты. | | | `child_tickets` | включает возможность создавать связанные дочерние тикеты, по аналогии с `external_tickets`, но внутренние дочерние тикеты учитываются в статистике и предназначены для работы сотрудников компании, а не внешних получателей | 6.0.0 | | `widgets` | Включает фичу Виджеты, так же требует `chats` | | | `__csat_anytime` (до v5.8.0 `csat_anytime`) | Включает сурвей "звездочки" на комментария | | | *`disable_helpcenter`* | Выключает публичный хелп-центр. | **Не используется с 5.9.0** | | `external_search` | Разрешает создавать и использовать источники внешнего поиска | 5.6.0 | | `mango_office` | Подключает интеграцию Mango Office | | | `qa` | Включает фичу QA | | | `reporting` | Включает фичу Advanced Reporting (API\&UI) | 5.3.0 | | `__sensitive_data` (до v5.8.0 `sensitive_data`) | Включает фичу Конфиденциальные Данные | | | `telegram` | Включает поддержку Telegram. Так же требует спец. секции в docker-compose.yml и рестарта | | | `whatsapp_green` | Включает поддержку Whatsapp через Green API. Так же требует спец. секции в docker-compose.yml и рестарта | | | `vk` | Включает поддержку VK. Так же требует спец. секции в docker-compose.yml и рестарта | | | `time_tracking` | Включает поддержку учета трудозатрат | | | `wfm` | Включает WFM фичи (гистограмма активности агентов) | | | `max` | Включает интеграцию с мессенджером MAX | 5.8.0 | | `automations_outgoing_emails` | Разрешает создавать исходящие емейлы в автоматизациях (требует флага `automations`) | 5.8.0 | | `automations_outgoing_webhooks` | Разрешает создавать исходящие вебхуки в автоматизациях (требует флага `automations`) | 5.8.0 | | `automations_macros` | Разрешает создавать макросы в автоматизациях (требует флага `automations`) | 5.8.0 | | `automations_scripts` | Разрешает создавать скрипты в автоматизациях (требует флага `automations`) | 5.8.0 | | `api_keys` | Разрешает использовать API ключи для API интеграций | 5.8.0 | | `issue_tracker` | Разрешает подключать трекеры задач | 5.8.0 | | `webhooks` | Начиная с 5.8.0 не используется | | | `ui_widgets` | Включает возможность встраивать в интерфейс Swarmica произвольные виджеты | 6.0.0 | | `rca` | включает управление документами анализа первопричин (Root Cause Analysis, RCA) | 6.0.0 | **ВАЖНО!** После редактирования `.env` файла обязательно нужно выполнить рестарт сервисов, чтобы применить нужные флаги: ```shell docker compose down && docker compose up -d ```