Первые шаги после установки

Что настроить сразу после установки, чтобы платформой можно было пользоваться, и в каком порядке это делать.

Порядок настройки

Платформа после установки работоспособна, но бесполезна: в ней нет ни одной языковой модели. Порядок такой.

1. Смените пароль администратора

При первичном наполнении базы создаётся администратор с логином и паролем из переменных окружения, по умолчанию admin и admin.

Повторное наполнение базы сбрасывает пароль

Если запустить наполнение базы ещё раз, а учётная запись с таким логином уже существует, платформа перезапишет ей пароль, роль, состояние и имя. Учитывайте это при обновлениях.

2. Проверьте общие настройки платформы

Раздел Настройки. Здесь задаются базовые адреса, по которым сервисы инструментов будут обращаться к файлам чата, и настройки просмотра офисных документов.

Особенно важен внешний базовый адрес: именно он попадает в ключ доступа, который платформа выдаёт сервисам MCP. Если сервисы работают в своих контейнерах, адрес 127.0.0.1 для них бесполезен.

3. Добавьте провайдера и модель

Раздел Модели. Сначала провайдер, то есть внешний сервис с OpenAI-совместимым API: название, базовый адрес и ключ доступа. Затем модели этого провайдера.

Ключи хранятся в базе, а не в переменных окружения

Ключ провайдера задаётся через интерфейс и хранится в базе в зашифрованном виде. В переменных окружения его быть не должно.

У модели важно заполнить размер контекстного окна. Без него в чате не будет работать показ заполненности контекста и автоматическое сжатие переписки.

4. Проверьте лимиты

Раздел Рантайм. Значения по умолчанию рассчитаны на небольшую нагрузку: три процесса, три сессии на процесс, четыре одновременных шага.

Для установки на много пользователей эти значения нужно поднимать осознанно, глядя на возможности сервера.

5. Подключите инструменты, если они нужны

Раздел MCP. Инструменты не обязательны. Платформа без них работает как обычный чат с моделью.

6. Создайте роли и пользователей

Раздел Роли, затем Пользователи. Встроенных ролей две, и они не редактируются: Администратор с полным доступом и Пользователь с базовым набором прав.

Базовая роль скрывает два раздела

С правами по умолчанию пользователь не увидит разделы Правила и Агенты: ему выдано только чтение, а для открытия раздела нужно право изменения. Если сотрудники должны настраивать правила или агентов, создайте отдельную роль и выдайте ей эти права.

Что проверить перед передачей пользователям

Проверка	Как убедиться
Модель отвечает	Написать сообщение в чате и получить ответ
Заполненность контекста считается	В заголовке чата кружок показывает проценты, а не пустое значение
Файлы загружаются	Приложить документ к сообщению
Инструменты подключены	В разделе MCP у источников состояние «подключено»
Просмотр документов работает	Открыть загруженный файл Word в чате
Расход считается	В разделе Использование появились записи