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

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

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

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

Загружаем изображение…

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

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

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

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

На страницах Провайдеры LLM и Провайдеры эмбеддингов строка «Системный провайдер контура» над таблицей показывает состав каталога, время последней синхронизации, интервал опроса и кнопку Синхронизировать сейчас. Если строка есть, провайдер и модели заведены платформой, а шаги LLM и модели и Базы знаний могут стать зелёными без ручного создания. Если строки нет, инсталляция работает с провайдерами, заведёнными вручную.

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

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

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

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

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

Загружаем изображение…

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

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

Ручное подключение языковой модели нужно для моделей за пределами контура и для инсталляции без системного провайдера. Сначала создайте провайдера, затем запись модели в реестре 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 — в главе Модели и политики.

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

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

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 — для коротких прямых запросов, Запасные модели (каскад) — две ступени подмены при сбое основной модели роли. Для роли агента выбирают модели с поддержкой вызова инструментов.

Пустой селект означает «По умолчанию» — агент наследует модель ассистентов из политики LLM и следует за её сменой. Настраивать раздел при первом запуске не требуется, явный выбор нужен только когда агенту назначают отдельную модель.

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

Блок Честность ответов чата в том же разделе по умолчанию выключен: селект Только с опорой на источники предлагает «Авто (выключено)», Включено и Выключено. При включённом гейте перед ответом модель роутера (поле Модель роутера блока «Роутер режима «Авто»»; если она не задана — Модель fast-path, затем основная модель агента и запасные модели каскада) решает, требует ли вопрос опоры на документы-источники — нормативные акты, регламенты, договоры, приложенные файлы, базы знаний — или это общие знания. Если требует, ассистент отвечает только по подключённым источникам с указанием, откуда взято, а без источников начинает ответ с прямого сообщения, что подтвердить нечем. Вопросы на общие знания («когда умер Пушкин») гейт не трогает. Если ни одна модель каскада не ответила в бюджет «Таймаут решения», а у ассистента настроены базы знаний или файлы, платформа считает, что источники нужны, и ищет в них — ответ по памяти без вердикта невозможен. Соседние настройки Пост-проверка чисел и цитат и Системные базы знаний в ответах могут стоять в режиме «Авто (включено)», но при выключенном гейте не срабатывают. Явный выбор базы знаний через @ в сообщении работает и при выключенном гейте. Осознанное действие администратора — включить гейт; пока он выключен, ассистент отвечает без обязательной опоры на источники, а системные базы знаний в ответы Уники AI не подключаются.

В той же карточке блок Проверка достоверности после ответа задаёт, как платформа проверяет уже отданный ответ с подключёнными источниками: воркер считает лексическое покрытие и косинусную близость, а судья-модель разбивает ответ на утверждения и сверяет каждое с фрагментами. Время ответа не меняется — проверка идёт после него. Настройки: Режим проверки (выключено; только сигналы и близость — без отметки пользователю; сигналы, близость и судья — по умолчанию), Модель судьи (пусто — наследовать: модель роутера → fast-path → основная модель агента с каскадом запасных), Параллельность воркера (1–8, по умолчанию 2 на процесс), пороги вердикта «подтверждено» и «частично» (0,8 и 0,5), Показывать отметку (всем, только администраторам, никому), срок хранения утверждений (90 дней), Учёт стоимости (платформенная — по умолчанию — или списание с пространства), а также судья и его модель для арены знаний. Проверка включается по пространствам функцией Проверка достоверности ответов в Доступ → Функции — по умолчанию она выключена, включите её для пилотных пространств или правилом «для всех». Итоги видны на странице Знания и поиск → Качество.

Блок Роутер режима «Авто» там же задаёт, как платформа выбирает исполнителя в режиме Авто у Уника AI: LLM-роутер включён или выключен (тогда работают только детерминированные правила — короткие реплики, явная просьба о файле, табличное вложение), какая модель принимает решение (пусто — модель fast-path, затем основная модель агента и запасные модели каскада), Таймаут решения — бюджет на все модели каскада (по умолчанию 10 с; первая модель получает бюджет за вычетом резерва на запасную), Пауза после сбоя модели — на сколько секунд модель, не ответившая в срок или по сети, уходит в конец очереди (по умолчанию 60 с, 0 — выключено), и порог уверенности (по умолчанию 70 %), ниже которого запрос идёт в чат, а не агенту. Сам режим Авто включается для пространств функцией «Режим «Авто» у Уники AI» в разделе Доступ → Функции.

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

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

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

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

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

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

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

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

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

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

Это системный провайдер контура: платформа создаёт его по адресам шлюзов при старте. В таблице такой провайдер отмечен Системный, а карточки его моделей в реестре AI-модели содержат признак «Карточка заведена автоматически». Провайдеров, созданных администратором, автоматика не читает и не меняет. Подробнее см. Провайдеры языковых моделей и Провайдеры эмбеддингов.

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

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

Что дальше

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