Первый запуск платформы

Первый запуск — сквозной маршрут от развёрнутой, но пустой инсталляции до работающего чата: рабочее пространство с владельцем, подключённая языковая модель (LLM), провайдер эмбеддингов и настроенная отправка почты. Порядок шагов задаёт встроенный чек-лист Первичный запуск по адресу /settings/administration/setup, он же показывает, что ещё не готово. Все настройки действуют сразу, перезапуск платформы не требуется. Транскрибация, биллинг, интеграции и агент в минимальный маршрут не входят: их подключают после того, как чат заработал.

Что вам понадобится

• учётная запись администратора платформы с доступом к разделу Администрирование;
• адрес и ключ доступа провайдера языковых моделей;
• адрес и ключ доступа провайдера эмбеддингов;
• параметры почтового сервера: хост, порт, учётные данные, адрес отправителя;
• режим поставки инсталляции: DEPLOYMENT_MODE=cloud или DEPLOYMENT_MODE=onprem.

Как проверить готовность инсталляции

Откройте /settings/administration/setup. Экран Первичный запуск собирает состояние четырёх подсистем в карточке Настроить по порядку: Доступ и роли, LLM и модели, Базы знаний, Транскрибация. В каждой строке есть кнопка перехода в нужный раздел, а ниже — карточка После запуска со ссылками на Журнал действий, Запуски LLM и Запуски ASR. Пункта для этого экрана в боковом меню нет: открывайте его по прямой ссылке.

Готовность шага несёт цвет номера слева от названия. Чего именно не хватает, экран не расшифровывает — условия перечислены в таблице ниже.

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

Как создать рабочее пространство и владельца

Откройте Администрирование → Доступ → Рабочие пространства (/settings/administration/access/workspaces) и нажмите Создать пространство. Кнопка доступна только в коробочной поставке (DEPLOYMENT_MODE=onprem); в облачной поставке платформа выводит вместо неё строку «Режим cloud: создание новых пространств недоступно», и пространства заводит служба эксплуатации.

1. Нажмите Создать пространство.
2. Укажите Название.
3. Выберите Тариф — в списке только активные тарифы.
4. Выберите Владелец из списка пользователей или нажмите Назначить меня.
5. Нажмите Создать.

Платформа создаёт пространство и назначает выбранного пользователя владельцем.

Важно. Администратор, создавший пространство, не попадает в его участники автоматически: доступ выдают отдельно.

Пользователей добавляют в разделе Администрирование → Доступ → Пользователи (/settings/administration/access/users) кнопкой Добавить пользователя: Email, ФИО и назначение в рабочее пространство с ролью. Роль owner эта форма не назначает — владельца задают при создании пространства. Разбор ролей, прав и внешнего входа — в главе Доступ, пользователи и пространства.

Как подключить провайдер языковых моделей

Языковую модель подключают в два приёма: сначала провайдер, затем запись модели в реестре AI-модели. Одного провайдера недостаточно — шаг LLM и модели останется жёлтым, пока в реестре нет активной модели типа LLM.

1. Откройте Администрирование → LLM и сценарии → Провайдеры LLM (/settings/administration/llm/providers) и нажмите Создать провайдер.
2. Заполните форму и включите Провайдер активен. Набор полей зависит от выбранного Шаблона провайдера, Контракта API и Режима авторизации.
3. Откройте Администрирование → Платформа → AI-модели (/settings/administration/platform/models) и создайте запись модели.

Если модель не должна списывать кредиты, отметьте «Бесплатная модель — кредиты за токены не списываются»: платформа обнуляет обе цены и закрывает их для правки.

Последний шаг — модель по умолчанию. Откройте Администрирование → LLM и сценарии → Политики LLM и OCR (/settings/administration/llm/policies), вкладка Ассистенты и чаты, карточка Модели ассистентов. В меню нужной строки выберите Назначить по умолчанию.

Примечание. Без явно назначенной модели по умолчанию платформа подставляет в ассистенты первую доступную активную модель.

Разбор формы провайдера по секциям, режимы авторизации и потоковая передача — в главе Провайдеры языковых моделей. Лимиты модели, политики LLM и OCR — в главе Модели и политики.

Как подключить провайдер эмбеддингов

Эмбеддинги нужны базам знаний: без них документы не индексируются и поиск не работает. Настройка состоит из двух частей — провайдер и глобальная пара «провайдер + модель». Модель эмбеддингов выбирают один раз на всю инсталляцию, отдельной настройки на уровне рабочего пространства нет.

1. Откройте Администрирование → Знания и поиск → Провайдеры эмбеддингов (/settings/administration/knowledge/embeddings), нажмите Создать провайдер, заполните форму и сохраните.
2. Откройте сохранённого провайдера и в секции Проверка подключения нажмите Проверить. Платформа векторизует тестовый текст и показывает размерность вектора и число токенов. Кнопка недоступна, пока поле Тестовый текст пустое или в форме есть несохранённые правки.
3. Откройте Администрирование → Знания и поиск → Индексация и поиск (/settings/administration/knowledge/indexing) и перейдите на вкладку Глобальные RAG-настройки.
4. В поле Глобальная embedding-модель выберите пару «провайдер + модель». Отдельного поля для провайдера нет: платформа подставляет провайдера вместе с моделью.
5. Заполните Размерность вектора значением, которое вернула проверка подключения, и сохраните форму.

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

Формы провайдеров, ограничения по адресам и последствия смены модели разобраны в главе Провайдеры эмбеддингов. Профили индексации, профили поиска и векторное хранилище — в главе Администрирование знаний.

Как настроить отправку почты

Почта нужна для приглашений, сброса пароля и служебных уведомлений. Настройки живут в разделе Администрирование → Платформа → SMTP (/settings/administration/platform/smtp) на вкладке Настройки. Экран Первичный запуск этот шаг не проверяет, поэтому его пропускают чаще остальных.

Сохраните настройки и нажмите Тестовое письмо в шапке секции Подключение. Укажите Email получателя и нажмите Отправить. Результат отправки видно на вкладке Журнал уведомлений той же страницы. Режим обслуживания, политики очистки и аналитика инсталляции описаны в главе Эксплуатация платформы.

Как проверить результат

Маршрут пройден, когда чат в рабочем пространстве отвечает на сообщение, а загруженный документ индексируется. Проверка занимает несколько минут и требует одного тестового файла.

1. Войдите в рабочее пространство и создайте чат.
2. Отправьте сообщение и дождитесь ответа.
3. Откройте Администрирование → Центр активности → Запуски LLM (/settings/administration/llm-executions) и убедитесь, что появилась запись об успешном запуске.
4. Загрузите документ в базу знаний и дождитесь завершения индексации.
5. Вернитесь на /settings/administration/setup и убедитесь, что шаги Доступ и роли, LLM и модели и Базы знаний отмечены зелёным.

Если ответ в чате не приходит, а записи в Запуски LLM нет, проверьте активность провайдера и наличие активной модели типа LLM в реестре AI-модели. Если запись появилась со статусом ошибки, в её карточке видно текст ответа провайдера.

Что настроить после запуска

Минимальный маршрут даёт рабочий чат и рабочие базы знаний. Остальные разделы включают по мере надобности: ни один из них запуск не блокирует.

Распознавание сканов описано в главе Распознавание документов и речи, а переменные и справочники — в главе Глобальные переменные и справочники.

Раздел Настройки агента (/settings/administration/llm/agent-settings) задаёт, какими моделями пользуется агент: Основная модель агента — для шагов агента в сценариях (workflow), Модель fast-path — для коротких прямых запросов, Запасные модели (каскад) — две ступени подмены при сбое основной модели роли. Для роли агента выбирают модели с поддержкой вызова инструментов.

Остальные параметры раздела Настройки агента — контроль перегрузки, возобновление после сбоя, предзагрузка базы знаний — меняют, когда нагрузка выходит за рамки типовой. Ограничители на стороне моделей и распознавания задаются отдельно — см. Модели и политики.

Частые вопросы

Почему на странице «Обзор» нет чек-листа запуска

Страница Обзор показывает аналитику инсталляции: запуски, потребление и активность. Чек-лист первичного запуска живёт по отдельному адресу /settings/administration/setup, и пункта для него в боковом меню нет — сохраните ссылку в закладках браузера.

Почему нет кнопки «Создать пространство»

Создание пространств из интерфейса доступно только в коробочной поставке. Проверьте:

• в шапке страницы платформа выводит строку «Режим cloud: создание новых пространств недоступно»;
• значение DEPLOYMENT_MODE в конфигурации инсталляции равно onprem;
• в облачной поставке пространство заводит служба эксплуатации по заявке.

Почему шаг «Базы знаний» не становится зелёным

Одного провайдера эмбеддингов недостаточно: платформа проверяет ещё и глобальные RAG-настройки. Проверьте:

• провайдер эмбеддингов активен, и Проверка подключения проходит без ошибки;
• в поле Глобальная embedding-модель выбрана пара «провайдер + модель»;
• выбранная модель есть в списке моделей провайдера — иначе над формой появляется предупреждение «Выбранная модель эмбеддингов недоступна», и настройку нужно пересохранить.

Почему шаг «Транскрибация» остаётся не зелёным

Шаг закрывает только реальная расшифровка: распознавание речи работает сервисами поставки, но платформа ждёт подтверждения делом. Загрузите короткое аудио в чат и дождитесь стенограммы, затем проверьте, что в журнале Запуски ASR появилась операция со статусом успеха.

Что дальше

• Раздел администрирования — карта разделов и переходы к профильным главам.
• Доступ, пользователи и пространства — роли, права и внешний вход.
• Провайдеры языковых моделей — разбор формы провайдера по секциям.
• Администрирование знаний — лимиты файлов, профили индексации и векторное хранилище.
• Тарифы, кредиты и биллинг — тарифы пространств и журналы списаний.