Настройки модуля "База знаний

Доступ к настройкам:

1. Перейдите в раздел "Настройки" -> "База знаний"
2. Или в системной админке: "Kb" -> "KB settings"

Настройки раздела "Основные настройки":

• KB_RESPONSIBLE (Int) - Ответственный за базу знаний
• Пользователь, ответственный за управление базой знаний (ID пользователя)
• Значение по умолчанию: пусто
• KB_HELPDESK_INTEGRATION (Bullet) - Интеграция с модулем техподдержки
• Включить интеграцию базы знаний с модулем техподдержки (обязательное ознакомление и связанные сценарии)
• Значение по умолчанию: False
• KB_AI_REQUEST_INTEGRATION (Bullet) - AI-интеграция заявок с базой знаний
• Мастер-флаг: рекомендации статей в карточке заявки, кнопка «Установить и добавить статью» при закрытии, генерация/дополнение черновиков через локальный LLM (Ollama)
• Значение по умолчанию: False (выключено)
• Руководство пользователя: Интеграция с заявками
• KB_DEFAULT_HELPDESK_CATEGORY (Int) - Категория по умолчанию для техподдержки
• Категория, которая будет автоматически назначена для записей техподдержки (ID категории)
• Значение по умолчанию: пусто
• KB_DEFAULT_HELPDESK_TYPE (Int) - Тип по умолчанию для техподдержки
• Тип записи, который будет автоматически назначен для записей техподдержки (ID типа)
• Значение по умолчанию: пусто

Примечание: устаревшие флаги KB_CREATE_FROM_REQUEST_ENABLED и KB_RECOMMENDATIONS_ON_REQUEST_ENABLED кодом не используются; достаточно KB_AI_REQUEST_INTEGRATION.

• KB_SET_EXPIRATION_DATE (Bullet) - Назначать срок актуальности записи
• Указывать срок актуальности для каждой страницы базы знаний
• Значение по умолчанию: True
• KB_DEFAULT_EXPIRATION_DAYS (Int) - Актуальность записи по умолчанию в днях
• Срок актуальности записи по умолчанию для всех типов страниц
• Значение по умолчанию: 365
• KB_DEFAULT_RESPONSIBLE_IS_AUTHOR (Bullet) - Ответственный за записи по умолчанию автор
• Автор записи автоматически назначается ответственным за актуализацию, уведомления и доступы
• Значение по умолчанию: True
• KB_REQUIRE_DEPARTMENT_HEAD_APPROVAL (Bullet) - Согласовывать запись с руководителем подразделения
• Требовать согласования записи руководителем подразделения автора перед публикацией
• Значение по умолчанию: False
• KB_REQUIRE_ADMIN_APPROVAL (Bullet) - Согласовывать запись с ответственным за базу знаний
• Требовать согласования записи администратором базы знаний перед публикацией
• Значение по умолчанию: False
• KB_REQUIRE_CATEGORY_RESPONSIBLE_APPROVAL (Bullet) - Согласовывать запись с ответственным за категорию
• Требовать согласования записи ответственным за категорию перед публикацией
• Значение по умолчанию: True
• KB_MAX_FILE_SIZE_OCR (Int) - Максимальный размер файла для распознавания
• В мегабайтах
• Значение по умолчанию: 20
• KB_ALLOWED_FILE_TYPES (String) - Разрешённые типы файлов для загрузки
• Через запятую без пробелов и переносов строк
• Значение по умолчанию: pdf,doc,docx,xls,xlsx,txt,jpg,jpeg,png,gif,json
• KB_MAX_FILE_SIZE (Int) - Максимальный размер файла для загрузки
• В мегабайтах
• Значение по умолчанию: 50
• KB_HIDE_ACKNOWLEDGE_BUTTON (Bullet) - Скрывать кнопку об ознакомлении при недостаточном времени чтения
• Требовать минимальное время на странице перед возможностью отметить ознакомление
• Значение по умолчанию: True
• KB_SHOW_EMPTY_CATEGORIES (Bullet) - Отображать категории без записей
• Показывать в списке категории, которые не содержат записей
• Значение по умолчанию: False
• KB_COLLAPSED_CATEGORIES (Bullet) - Отображать категории свернутыми
• По умолчанию показывать категории в свернутом виде
• Значение по умолчанию: False
• KB_ACK_REMINDER_DAYS (Int) - Напоминание сотруднику об ознакомлении
• Через сколько дней напоминать сотруднику, что ему нужно ознакомиться с документом
• Значение по умолчанию: 3
• KB_MANAGER_ACK_REMINDER_DAYS (Int) - Напоминание руководителю об ознакомлении сотрудника
• Через сколько дней напоминать руководителю, что его сотрудник должен ознакомиться с документом
• Значение по умолчанию: 5
• KB_NOTIFY_CATEGORY_RESPONSIBLE (Bullet) - Уведомлять ответственного за категорию при истечении срока актуальности
• Отправлять уведомление ответственному за категорию когда страница становится неактуальной
• Значение по умолчанию: True
• KB_NOTIFY_ADMIN (Bullet) - Уведомлять ответственного за базу знаний при истечении срока актуальности
• Отправлять уведомление администратору базы знаний когда страница становится неактуальной
• Значение по умолчанию: False
• KB_NOTIFY_AUTHOR (Bullet) - Уведомлять автора записи при истечении срока актуальности
• Отправлять уведомление автору страницы когда она становится неактуальной
• Значение по умолчанию: True
• KB_NOTIFY_ADMIN_ON_RELATED_PAGE_CHANGE (Bullet) - Уведомлять ответственного за базу знаний при изменении связанных страниц
• Отправлять уведомление администратору базы знаний при изменении связанных страниц
• Значение по умолчанию: False
• KB_NOTIFY_AUTHOR_ON_RELATED_PAGE_CHANGE (Bullet) - Уведомлять автора при изменении связанных страниц
• Отправлять уведомление автору страницы при изменении связанных страниц
• Значение по умолчанию: True
• KB_NOTIFY_CATEGORY_RESPONSIBLE_ON_RELATED_PAGE_CHANGE (Bullet) - Уведомлять ответственного за категорию при изменении связанных страниц
• Отправлять уведомление ответственному за категорию при изменении связанных страниц
• Значение по умолчанию: True
• KB_NOTIFY_CATEGORY_RESPONSIBLE_CHANGES (Bullet) - Уведомлять ответственного за категорию при изменениях
• Отправлять уведомление ответственному за категорию при изменении в этой категории
• Значение по умолчанию: True
• KB_NOTIFY_AUTHOR_ON_COMMENT (Bullet) - Уведомлять автора записи о комментариях
• Отправлять уведомление автору страницы при добавлении нового комментария
• Значение по умолчанию: True

Локальный LLM (Ollama) для генерации статей

Генерация названия, категории и структуры черновика (при KB_AI_REQUEST_INTEGRATION) выполняется на том же хосте через Ollama (приложение ml_services).

Быстрый старт на сервере:

cd /path/to/ask
sudo bash ml_services/scripts/setup_ollama.sh --model qwen2_5_7b_instruct_q8

Скрипт ставит Ollama (при необходимости), настраивает systemd (OLLAMA_MODELS=/var/lib/ask-ollama, хост 127.0.0.1:11434), при отсутствии GGUF скачивает модель с Hugging Face (~8 GB) и выполняет ollama create. Офлайн: --skip-download, если GGUF уже лежит в ml_models/.

Важно: runtime-данные Ollama не должны лежать в /home/... с правами 750 — user ollama туда не зайдёт, сервис уйдёт в crash-loop. По умолчанию используется /var/lib/ask-ollama.

Переменные окружения Django (опционально):

Если Ollama недоступна, при закрытии заявки всё равно создаётся шаблонный черновик — закрытие не блокируется.

Проверка:

curl -s http://127.0.0.1:11434/api/tags
ollama list

Подробности и ручная установка: ml_services/models/README.md в репозитории ASK.

Справочники модуля:

• Типы страниц - категории страниц базы знаний
• Категории страниц - иерархическая структура категорий