AI-сервис EmplDocs
AI-сервис EmplDocs — веб-платформа для настройки и тестирования AI-ассистентов EmplDocs. Здесь создают ассистентов, навыки, базу знаний, подключают LLM-провайдеры и MCP-серверы, а затем проверяют поведение в playground.
Доступ
Учётные данные выдаёт администратор платформы. После регистрации новый аккаунт должен быть одобрен суперадмином в разделе Пользователи.
| Поле | Описание |
|---|---|
| Электронная почта | Логин (корректный email) |
| Пароль | Минимум 8 символов |
Кнопки: Войти, ссылка Нет аккаунта? Зарегистрироваться.
После входа открывается выбранный ассистент (или предложение создать первого). В шапке слева можно переключать ассистента.
Основные сущности
| Сущность | Назначение |
|---|---|
| Ассистент | AI-агент со своими моделями, навыками, документами и настройками |
| Навык (skill) | Инструкции, сценарии и инструменты под конкретную задачу |
| Документы | База знаний в Markdown; можно загружать pdf / docx / xlsx |
| MCP-сервер | Внешний сервер Model Context Protocol — ресурсы и инструменты для навыков |
| Провайдер | Подключение к LLM (OpenAI, Anthropic, OpenRouter, LM Studio) |
| Модель | Chat- или embedding-модель провайдера |
| Тестовый пользователь | Логин EmplDocs для сборки runtimeContext в playground |
Структура интерфейса
Боковое меню делится на блоки:
Ассистент
| Раздел | Назначение |
|---|---|
| Обзор | Сводка ассистента, навыки, аналитика |
| Навыки | Библиотека навыков и редактор |
Ресурсы
| Раздел | Назначение |
|---|---|
| Документы | База знаний |
| MCP серверы | Внешние MCP |
Инфраструктура
| Раздел | Назначение |
|---|---|
| Провайдеры | LLM-провайдеры и модели |
| Настройки | Модели, чат, песочница, API |
Администрирование
| Раздел | Назначение |
|---|---|
| Пользователи | Одобрение, блокировка, удаление аккаунтов |
В шапке доступна кнопка Открыть playground — тестовый чат открывается в правой панели и сохраняется при переходах между страницами.
Индикатор НЕВАЛИДЕН означает, что конфигурация ассистента ещё неполная (нет моделей, тестового пользователя и т.п.).
Обзор ассистента
На обзоре отображаются:
- название ассистента и текущая chat-модель;
- владелец и режим совместного доступа;
- список подключённых навыков (вкл/выкл);
- кнопки Редактировать, удалить, Добавить навык, Открыть playground;
- аналитика сообщений и токенов (по часам / дням / месяцам).
Редактирование ассистента
| Поле | Обязательное | Описание |
|---|---|---|
| Название | Да | Отображаемое имя (например, DEMO_MAIN) |
| Инструкции ассистента | Нет | Общие правила в Markdown: тон, ограничения, приоритеты |
| URL API Empldocs | Да | Адрес API EmplDocs (например, https://demo.empldocs.app/data/) |
После создания настройте провайдеры, модели, навыки и тестовых пользователей.
Навыки
Библиотека навыков — набор инструкций и инструментов, которые подключаются к ассистенту.
- Поиск — по названию, инструментам, сценариям.
- Создать навык — новый навык с нуля или из шаблона.
- На карточке: название, краткое описание, действия редактирования и удаления.
Создание навыка
Два варианта:
- Создать с нуля — пустая форма.
- Шаблон — готовая основа (заявки, отпуск, зарплата и др.) с поиском по шаблонам.
Редактор навыка
Слева — форма навыка, справа — AI-помощник конструктора (чат для уточнения логики и правок черновика). Изменения из чата не публикуются, пока вы не нажмёте Сохранить.
Контекст и сценарии
| Поле | Обязательное | Описание |
|---|---|---|
| Название | Да | Имя навыка (минимум 2 символа) |
| Сценарии использования | Да | По одному сценарию на строку — когда навык включается |
| Примеры вопросов | Нет | Типичные запросы пользователя |
Инструкции навыка
Подробные правила в Markdown: порядок действий, ссылки на документы, ограничения.
Доступы и источники
| Блок | Описание |
|---|---|
| Поиск по базе знаний | Включает семантический поиск; можно ограничить папками/файлами. Если ничего не выбрано — доступна вся база |
| Встроенные инструменты | Инструменты из registry платформы |
| MCP-доступы | Ресурсы и инструменты подключённых MCP-серверов |
| Локальные инструменты | Пользовательские функции навыка |
Пользовательская функция
| Поле | Описание |
|---|---|
| Имя (name) | Системное имя, латиница (getVacationDays) |
| Заголовок / Действие | Человекочитаемое имя и текст для UI во время вызова |
| Описание | Что делает функция и когда её вызывать |
| Схемы входа/выхода | JSON Schema |
| Код функции | Исполняемый скрипт |
Функция доступна только этому навыку.
Документы (база знаний)
Слева — дерево папок и файлов, справа — Markdown-редактор.
Папки
| Действие | Описание |
|---|---|
| Создать папку | Новая папка в базе знаний |
| Переименовать | Изменить название |
| Удалить | Только пустую папку |
Документы
| Действие | Описание |
|---|---|
| Создать документ | Новый Markdown-файл |
| Загрузить | pdf / docx / xlsx — конвертируются в Markdown |
| Редактировать | Правка содержимого |
| Удалить | Безвозвратно |
При загрузке генерируются заголовок и краткое описание — для этого нужна chat-модель из Настройки → Summary документов.
Статусы индексации отображаются на карточках (очередь, индексация, готово, ошибка).
MCP серверы
Подключение внешних MCP: их ресурсы и инструменты становятся доступны навыкам.
| Поле | Обязательное | Описание |
|---|---|---|
| Название | Да | Имя в интерфейсе |
| URL | Да | Адрес MCP-сервера |
| HTTP-заголовки (JSON) | Нет | Объект со строковыми значениями, по умолчанию {} |
| Передавать Empldocs авторизацию | Нет | Добавляет X-Token и Employee-Id из runtimeContext |
На карточке: имя, URL, статус авторизации, число заголовков. Быстрые действия: обновить ресурсы / инструменты / шаблоны, редактировать, удалить.
Для серверов с пробросом авторизации нужен настроенный runtimeContext (тестовый пользователь в playground).
Провайдеры и модели
Провайдер
| Поле | Обязательное | Описание |
|---|---|---|
| Название | Да | Имя подключения (OpenRouter) |
| Тип | Да | openai, anthropic, openrouter, lmstudio |
| Пользовательский URL | Нет | Свой endpoint вместо стандартного |
| Прокси-сервер | Нет | URL прокси (http:// / https://) |
| API-ключ | Нет | Ключ доступа |
На карточке видны статусы: задан ли api-ключ и прокси.
Модель
| Поле | Обязательное | Описание |
|---|---|---|
| Провайдер | Да | К какому провайдеру относится |
| Название | Да | Отображаемое имя |
| ID модели | Да | Технический id для API |
| Тип | Да | Чат или Эмбеддинг |
| Reasoning Effort | Нет | xhigh / high / medium / low / minimal / none |
Настройки
Раздел Инфраструктура → Настройки содержит группы: Модели, Чат, Песочница, API.
Модели
Модели по умолчанию
| Поле | Описание |
|---|---|
| Default chat-модель | Основной диалог и fallback для chat-функций |
| Default embedding-модель | Индекс документов и встроенные инструменты skill-builder |
Переопределения chat-функционалов
| Функция | Назначение |
|---|---|
| Автосжатие контекста | Сжимает длинную историю чата |
| Долговременная память | Memory-collector обновляет память по итогам сессии |
| Summary документов | Заголовок и описание при загрузке |
| Извлечение из документов | Субагент для точечных запросов к одному документу |
| Assistant pane конструктора навыков | ИИ-помощник в редакторе навыка |
Дополнительно: Максимальный размер документа для inline-режима (байты) — документы меньше порога читаются целиком (по умолчанию 32768).
Переопределения embedding-функционалов
| Функция | Назначение |
|---|---|
| Индекс документов | Индексация и поиск по базе знаний |
| Индекс встроенных инструментов skill-builder | Векторный поиск инструментов в конструкторе |
При смене effective embedding-модели система предложит переиндексировать документы и/или инструменты.
Долговременная память
| Поле | Описание |
|---|---|
| Включить память | Сбор и использование фактов о пользователе между сессиями |
| Порог неактивности сессии (секунд) | После этого времени без сообщений сессия завершена. По умолчанию 120 |
Автосжатие истории
| Поле | Описание |
|---|---|
| Включить автосжатие | Сжатие ранних сообщений |
| Порог токенов истории | При превышении запускается сжатие (~20000) |
| Лимит токенов сохраняемого хвоста | Последние сообщения без изменений (~4000) |
Интерактивные инструменты
| Переключатель | Описание |
|---|---|
| Задавать уточняющие вопросы | Инструмент askUserQuestions |
| Запрашивать подтверждение действия | Инструмент askForConfirmation |
Тестовые пользователи
| Поле | Обязательное | Описание |
|---|---|---|
| Логин | Да | Учётная запись EmplDocs |
| Пароль | Да | Хранится в sandbox-хранилище платформы |
Используются для быстрой авторизации и сборки runtimeContext в playground и ai-factory.
Доступ к API
| Элемент | Описание |
|---|---|
| Endpoint ассистента | POST /api/assistant/{assistantId} — необходимо указать в 1С в Настройках приложения - Поддержка для агента Доки/Эмпи |
| Разрешённые origin | CORS-origin фронтенда (ЛКС, «Доки»). Глобальные origin сервера действуют всегда |
Конструктор форм AI
API для генерации JSON-схемы заявки EmplDocs из текстового описания (ИИ-Ассистент в конструкторе заявок ЛКС).
| Элемент | Описание |
|---|---|
| Endpoint | POST /api/assistant/{id}/issue-template-builder/generate |
| Тело | { message, current_form_json?, model?, session_id? } |
| Ответ | { result: { json, changes }, session_id } |
| Включить API | Если выключено — endpoint возвращает 404 |
| Модель | Override chat-модели; иначе — default chat-модель |
Playground
Изолированный чат для проверки ассистента и навыков. Открывается кнопкой Открыть playground в шапке и работает в правой панели на любых страницах.
| Элемент | Описание |
|---|---|
| Выбор ассистента | Какой ассистент тестируется |
| Навык | Подключить/отключить skill для хода |
| Модель запуска | Override или модель по умолчанию ассистента |
| runtimeContext | Контекст EmplDocs (employeeId, accessToken, userId) — через тестового пользователя или вручную |
| Поле сообщения | Текст запроса; Enter — отправить, Shift+Enter — новая строка |
| Сбросить сессию | Очистить историю текущего теста |
Без авторизованного runtimeContext (тестовый пользователь) отправка сообщений недоступна — в панели будет ошибка «Пользователь не авторизован».
История playground не сохраняется между перезагрузками страницы.
Типовой порядок настройки
- Войти на ai.empldogs.ru и дождаться одобрения аккаунта.
- Создать / отредактировать ассистента — название, URL API EmplDocs, общие инструкции.
- В Провайдеры — добавить LLM-провайдера, chat- и embedding-модели.
- В Настройки → Модели — выбрать default chat- и embedding-модели.
- В Документы — загрузить или создать базу знаний (при необходимости).
- В MCP серверы — подключить внешние инструменты (при необходимости).
- В Навыки — создать навыки под сценарии (отпуск, заявки и т.д.).
- В Настройки → Тестовые пользователи — добавить sandbox-логин EmplDocs.
- В Playground — проверить диалог с нужным runtimeContext.
- В Настройки → Доступ к API — добавить origin фронтенда, если API вызывается из браузера.
Связь с EmplDocs
| Интеграция | Где в EmplDocs | Что делает Emplai |
|---|---|---|
| ИИ-Ассистент в конструкторе заявок | Админ → Конструктор заявок → «Основное» | API Конструктор форм AI генерирует JSON-схему формы |
| Создание заявок через чат | Флаг «Включить создание заявки через ИИ-Ассистента» | Навык ассистента + runtimeContext пользователя ЛКС |
| «Доки», интеллектуальный режим | Помощник документации | Ассистент с навыками и документами |