Конфигурация и система

Настройки интеграций

• GET /api/config — конфигурация интеграций, секреты замаскированы.
• PUT /api/config — изменить её. Замаскированное значение не перезаписывает сохранённый секрет, а секрет никогда не переносится на изменённый адрес. Настройки действуют на всю установку, поэтому нужен администратор (403 для лида проекта).

Администратор нужен и для проверок подключений (POST /api/config/test-adapter, /test-confluence, /test-task-manager, POST /api/repo/test), которые отправляют сохранённые учётные данные наружу. /test-confluence и /api/repo/test также требуют модуль agents (Pro).

Переменные окружения сервера описаны в разделе Настройки.

Модели агентов

llm.agentModels в конфигурации хранит собственные настройки модели каждого агента: { agent1?, agent2?, agent3?, custom?, chat?: { provider?, model?, temperature?, maxTokens? } } (agent2 — генерация кода и проверка в CI, chat — чат в боковой панели и составление воркфлоу). В интерфейсе — «Настройки → Языковая модель → Агенты».

• Все поля необязательны: без provider агент использует llm.activeProvider, без model — модель, сохранённую для этого провайдера, без temperature (от 0 до 1) или maxTokens — сохранённое значение провайдера, иначе 0.2 и 8192.
• Вызовы вне агентов используют активного провайдера; вызов, который сам задаёт температуру (оценка, отчёты), сохраняет её.
• Неизвестные агенты и пустые поля отбрасываются; неизвестный провайдер, температура вне 0–1 или maxTokens, который не является целым положительным числом, — 400.
• Расход записывается на провайдера и модель, которые ответили.

POST /api/ai/test-llm (администратор установки) — проверить провайдера моделей. Сбой несёт error — одну строку — и problem — то же, но по частям: title (что пошло не так), hint (что делать) и, если собственные слова провайдера дополняют заголовок, said с by (чьи это слова).

POST /api/ai/ollama-models (администратор установки) { config } — модели, загруженные на хост Ollama, models, с sizes ({ "qwen2.5:3b": "3.1B" }, как их сообщает Ollama).

Проверки состояния

• GET /healthz — liveness, публичный и никогда не обращается к базе данных. Его опрашивают HEALTHCHECK контейнера и liveness-проба Helm, чтобы сбой базы данных не приводил к перезапуску контейнера: перезапуск не починит базу и потеряет выполняющиеся задачи агентов.
• GET /api/health — liveness с версией сборки и коммитом. Указывайте оба в обращениях в поддержку.
• GET /readyz (также /api/ready) — readiness; 503, пока база данных недоступна. Направьте сюда readiness-пробу оркестратора, чтобы во время сбоя перестать направлять трафик, не убивая процесс.

Публичные адреса

• GET /api/downloads/* — CI-клиенты, публичные и отдаются до аутентификации: kvalli.mjs, kvalli-playwright-reporter.mjs, pytest_kvalli.py. Как их использовать — в разделе Отправка результатов из CI.
• GET /share/:token — публичная страница отчёта без сессии; токен — единственные учётные данные. См. Экспорт отчётов и публичные ссылки.

Сброс базы для тестов

POST /api/test-support/reset очищает базу данных и заново заполняет её для набора тестов Playwright. Маршрут подключается, только когда KVALLI_TEST_RESET_ENABLED=true, и отклоняет запрос, если имя базы данных не похоже на тестовое.

DANGER

Никогда не включайте KVALLI_TEST_RESET_ENABLED на рабочей установке.