Настройки платформы

Общие настройки, действующие на всю установку: адреса для доступа инструментов к файлам чата и просмотр офисных документов.

Как читать этот раздел

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

Что на экране

Два раздела: адреса для файлов чата и настройки просмотра офисных документов. Настройки хранятся в базе и применяются без перезапуска.

Адреса для файлов чата

Эти адреса попадают внутрь ключа доступа, который платформа выдаёт сервисам MCP. По ним сервис будет обращаться к файлам чата.

Поле	Для чего
Внутренний base URL	Для источников, у которых выбран внутренний режим адреса. Также используется как запасное значение для адреса платформы в настройках просмотра документов
Внешний base URL	Для источников с внешним режимом адреса. Это режим по умолчанию

Требования к формату строгие

Допускается только схема, хост и порт. Ни пути, ни параметров, ни косой черты на конце. Только http или https. Нарушение формата вернёт ошибку при сохранении.

Пустое поле означает возврат к значению переменной окружения PUBLIC_API_URL.

К выбранному адресу платформа сама добавляет /api/chat-s3.

Самая частая ошибка настройки

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

Просмотр офисных документов

Позволяет пользователям открывать файлы Word, Excel и PowerPoint прямо в чате. По умолчанию выключен.

Поле	Для чего
Включить	Общий переключатель возможности
URL Document Server	Внутренний адрес сервиса просмотра, доступный только платформе
URL платформы	Адрес платформы глазами контейнера сервиса просмотра. Нужен, чтобы сервис мог скачать файл
TTL токена файла	Срок жизни ключа доступа к файлу, от 60 до 86400 секунд
JWT включён	Должен совпадать с настройкой самого сервиса просмотра
JWT header и JWT secret	Общий секрет с сервисом просмотра

Порт сервиса просмотра наружу открывать не нужно

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

Просмотр документов только для чтения

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

Если возможность выключена, пользователь увидит сообщение «Превью Office-файлов отключено».

Что задаётся переменными окружения только один раз

Значения переменных окружения для просмотра документов используются лишь при первом создании настроек. Дальше настройки меняются здесь, и переменные окружения на них уже не влияют.

Полный список переменных на странице Переменные окружения.