Ассистенты

Ассистент — это настраиваемый собеседник рабочего пространства: он объединяет инструкцию для языковой модели (LLM), набор источников знаний, доступные в чате действия и порядок обработки аудио и видео. Ассистенты перечислены в разделе Ассистенты, и каждый чат привязан ровно к одному ассистенту. В каждом пространстве уже есть системный ассистент Unica Chat, которым можно пользоваться сразу; свои ассистенты создают под конкретную задачу, команду или процесс. Настройки системных ассистентов задаёт администратор инсталляции платформы, и изменить их из рабочего пространства нельзя.

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

• право assistants:view, чтобы видеть ассистентов пространства, и assistants:create, чтобы создавать новых;
• право assistants:edit, чтобы менять настройки уже созданного ассистента;
• языковая модель, доступная вашему пространству: её подключает администратор инсталляции платформы;
• провайдер эмбеддингов, если планируете подключать базы знаний или загружать файлы в роли RAG-источник;
• готовые базы знаний, если ответы должны опираться на документы пространства.

Как найти ассистентов пространства

Ассистенты пространства собраны в разделе Ассистенты. Список открывается на вкладке В пространстве; вторая вкладка Витрина появляется, только если пространству разрешены сборки и у вас есть право builds:view. Если сборки пространству не разрешены или права builds:view нет, вкладки не показываются и раздел открывает один список.

Для длинного списка используйте поле Найти ассистента и селектор сортировки: Недавно изменённые, Давно изменённые, А–Я или Я–А. Архивные ассистенты вынесены в отдельный раскрывающийся блок Архивные под основной сеткой.

Что показывает карточка

Верхняя часть карточки открывает чат с ассистентом, нижняя полоса Настройки — его конфигурацию. Под названием карточка выводит описание и строку конфигурации: для обычного ассистента это провайдер и модель, для сценарного — название привязанного сценария. Значок Только использование означает ассистента, установленного из витрины в защищённом режиме: его настройки менять нельзя.

Меню Действия с ассистентом (значок вертикального многоточия) собирает операции над карточкой.

Набор пунктов зависит от состояния карточки и ваших прав: у архивного ассистента нет Открыть чат и Архивировать, а Опубликовать сборку появляется только при разрешённой публикации сборок и праве builds:publish. У системных ассистентов меню не показывается.

Как создать ассистента и выбрать режим работы

Ассистента создают кнопкой Создать ассистент в разделе Ассистенты. Минимально рабочая конфигурация — название, инструкция и модель; всё остальное подключается позже.

1. Откройте раздел Ассистенты.
2. Нажмите Создать ассистент.
3. В блоке Метаданные выберите иконку и цвет иконки, заполните Название и Описание.
4. В поле Обработка оставьте вариант Внутри платформы.
5. В блоке Инструкция опишите роль ассистента, задачу, формат и тон ответа.
6. В блоке Модель LLM задайте значение поля LLM провайдер и модель.
7. Нажмите Сохранить.

Платформа сохраняет ассистента и открывает остальные разделы формы. До первого сохранения Файлы ассистента, Подключенные действия, Стартовые подсказки и Навыки недоступны.

Из чего состоит форма ассистента

Форма разбита на семь разделов. На широком экране они собраны в левом меню, на узком — в полосе над содержимым.

Цвет иконки выбирается из девяти вариантов. Фирменный цвет Unica зарезервирован за системными ассистентами, а красный доступен только тем ассистентам, у которых красный цвет уже сохранён.

Как улучшить инструкцию

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

Кнопка активна, когда в поле уже есть текст и у вас есть право assistants:edit. Результат сразу подставляется в поле, а в уведомлении появляется кнопка Отменить, которая возвращает прежний вариант. Если администратор инсталляции платформы выключил улучшение инструкции, вызов завершается сообщением Не удалось улучшить инструкцию.

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

Для длинного текста откройте Большой редактор кнопкой в правом нижнем углу поля: он правит ту же инструкцию ассистента.

Внутри платформы

Вариант Внутри платформы («С использованием LLM и RAG») — основной режим обработки. Платформа сама ведёт переписку: обращается к модели, ищет по базам знаний и файлам ассистента, показывает источники в ответе, запускает встроенную транскрибацию и действия над сообщениями.

В этом режиме доступен блок Модель LLM. В списке моделей первым идёт вариант По умолчанию — ассистент берёт модель из политики платформы, и она обновляется централизованно. У остальных вариантов показан уровень стоимости (Free, Low, Medium, High, Very high), а у выключенных провайдеров — подпись Провайдер отключён.

Сценарий

Вариант Сценарий появляется в поле Обработка, только если администратор инсталляции платформы разрешил вашему пространству сценарный режим. По умолчанию режим выключен, и в поле Обработка виден один вариант.

В сценарном режиме ответ ассистента собирает опубликованный сценарий (workflow), и платформа всегда берёт его последнюю опубликованную версию. Источником может быть глобальный шаблон платформы или сценарий рабочего пространства — какие источники доступны, тоже решает администратор. В списке Сценарий видны только сценарии с опубликованной версией и без привязки к другому ассистенту.

Часть настроек в этом режиме переезжает в сценарий: параметры поиска задаются в блоке Поиск по знаниям редактора сценария, аудио и видео приходят в сценарий обычными вложениями, а отдельный маршрут транскрибации не выбирается. Базы знаний по-прежнему выбираются в форме ассистента.

Поле Инструкция доступно и в сценарном режиме: её текст приходит в шаги сценария переменной {{inputs.assistant.instruction}}. Держите в инструкции политику и доменные правила, а порядок шагов задавайте узлами сценария.

Какие параметры генерации доступны

Параметры генерации собраны в блоке Расширенные параметры LLM раздела Основное и работают только в режиме Внутри платформы. Пустое поле означает значение провайдера.

Как подключить знания и файлы

Ассистент работает с двумя типами источников: базами знаний рабочего пространства и файлами ассистента. Без источников ассистент отвечает только знаниями модели; с источниками платформа ищет релевантные фрагменты и показывает в чате, на что опирается ответ.

Базы знаний

Базы знаний выбираются в блоке Источники знаний раздела Основное, и один ассистент может работать сразу с несколькими. Выбирайте базу знаний, когда документы ведёт вся команда, нужна структура папок, разным документам нужны разные уровни доступа или один набор знаний используют несколько ассистентов.

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

Подробнее — Базы знаний.

Файлы ассистента

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

По умолчанию действуют ограничения: до 10 файлов за одну загрузку, до 20 МБ на файл и до 20 материалов на ассистента. Администратор инсталляции платформы меняет эти значения для всей инсталляции, поэтому в вашей установке они могут быть другими.

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

Подробнее — Файлы, вложения и импорты.

Роль файла: RAG-источник или Материал

При загрузке платформа открывает окно Тип загружаемых файлов и просит выбрать роль. Роль меняется позже кнопкой Роль рядом с файлом.

• RAG-источник — файл индексируется, и в ответ попадают релевантные фрагменты. Роль по умолчанию, подходит для документов, по которым ассистент отвечает.
• «Материал (доступен целиком)» — файл доступен ассистенту целиком как рабочий артефакт: шаблон для заполнения, образец формата или пример. Материал не индексируется и в поиск не попадает, ассистент читает его по требованию.

Материалы подаются экономно: в контекст чата попадает короткий список доступных материалов, а полный текст читается по требованию. Если положить XLSX-шаблон реестра как материал, пакетное извлечение возьмёт его автоматически. Когда материал-XLSX у ассистента один, он подставляется как шаблон по умолчанию; если таких материалов несколько, нужный материал указывается явно. Провайдер эмбеддингов материалам не нужен.

Важно. Загрузка файла в роли RAG-источник требует настроенного провайдера эмбеддингов: без провайдера платформа отклоняет загрузку.

Как настроить поиск по знаниям

Тонкие параметры поиска собраны в разделе Расширенные настройки и работают только в режиме Внутри платформы. Поле Режим поиска предлагает два варианта.

• Использовать активный профиль поиска — ассистент целиком наследует профиль поиска пространства.
• Кастомный режим — ассистент переопределяет для себя стратегию поиска, Top K, пороги релевантности, переформулирование запросов и переранжирование результатов.

Там же настраиваются Embedding-модель для запросов (меняйте, только если базы знаний вручную переиндексированы другой моделью), История диалога (до 20 сообщений, 0 отключает историю), Умное переформулирование запросов и Кэширование контекста с временем жизни от 60 до 1800 секунд.

Подробнее — RAG и поиск по знаниям.

Как настроить чат: подсказки, действия и навыки

Три раздела формы отвечают за то, что вы видите и можете нажать в чате: Стартовые подсказки, Подключенные действия и Навыки. Все три доступны после первого сохранения ассистента. У стартовых подсказок и навыков свои кнопки сохранения; изменения в подключенных действиях уходят вместе с общей кнопкой Сохранить внизу формы.

Стартовые подсказки

Стартовые подсказки — готовые промпты, которые платформа показывает в пустом чате этого ассистента вместо общих подсказок. Их до шести: счётчик показан на кнопке «Добавить подсказку (N/6)».

Порядок подсказок меняется кнопками Выше и Ниже, лишняя убирается кнопкой Удалить, а блок Предпросмотр в пустом чате показывает результат. Переключатель «Отправлять сразу — промпт уйдёт без редактирования» решает, отправится подсказка сразу или сначала попадёт в поле ввода. Промпт с переменными вида {{имя_клиента}} в обоих случаях сначала просит заполнить значения. Изменения применяются кнопкой Сохранить подсказки.

Подключенные действия

Действия — операции над сообщением, стенограммой, выделенным фрагментом или всей перепиской, которые вы запускаете в чате по кнопке. Раздел Подключенные действия показывает библиотеку действий пространства с переключателем включения для этого ассистента, целью, режимом результата и местом, где кнопка появится: на холсте, в сообщении или на панели. Кнопки Создать действие и Библиотека действий ведут в раздел Настройки → Рабочее пространство → Действия ассистентов.

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

Навыки

Навык — инструкция, которая подмешивается ответу агента, когда задача похожа на ту, под которую навык создан. Раздел Навыки привязывает навыки пространства к ассистенту; привязка сохраняется кнопкой Сохранить навыки. Привязанные навыки доступны ассистенту в режиме «Агент», и применить навык в конкретном ответе решает модель. Подробнее — Навыки и конструктор навыков.

Что видно в самом чате

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

Как обработать аудио и видео

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

Маршрут транскрибации

Блок Маршрут транскрибации предлагает два варианта.

• Стандартный — встроенный маршрут платформы.
• Через workflow — запуск опубликованного сценария рабочего пространства, выбранного в поле Сценарий транскрибации.

Маршрут Через workflow нужен, когда после распознавания требуется дополнительная обработка: классификация, маршрутизация, сборка документа, согласование или передача в смежную систему. У ассистента в режиме Сценарий маршрут не выбирается: медиафайл получает основной сценарий и сам решает, когда запускать распознавание.

В стандартном маршруте платформа открывает окно запуска транскрибации при загрузке аудио или видео в чат. Если автозапуск выключен, файл сохраняется как обычное вложение. Флажок Диаризация (разделение стенограммы по говорящим) доступен при трёх условиях.

• Диаризация включена в разделе Транскрипция ассистента.
• Сервис распознавания речи из поставки платформы доступен в инсталляции.
• В окне запуска отмечен флажок «Запустить транскрипцию сразу после загрузки файла».

Поведение при транскрибировании

Блок Поведение при транскрибировании решает, что происходит с готовой стенограммой.

• Только транскрипция — платформа создаёт стенограмму без дополнительных шагов.
• «Транскрипция + авто-действие» — после стенограммы автоматически запускается действие, выбранное в поле Действие для авто-запуска.

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

Как поделиться ассистентом и убрать его из работы

Готового ассистента можно выложить в витрину инсталляции платформы как сборку, перенести архивом ZIP между пространствами или убрать из работы архивированием. Публикация, экспорт и архивирование запускаются из меню Действия с ассистентом на карточке, импорт — кнопкой Импортировать в шапке раздела.

Как установить ассистента из витрины

Вкладка Витрина показывает сборки, доступные вашему пространству; поиск идёт по названию, описанию и категории. Действие карточки зависит от состояния сборки: Установить для новой, Открыть чат для уже установленной, Обновить при доступной новой версии. Установленную сборку убирает пункт Удалить из пространства в меню карточки витрины.

Окно установки предлагает выбрать способ.

После установки в режиме Только использовать платформа открывает чат, после режима Создать свою копию — настройки копии. Если часть состава установилась с замечаниями, окно сначала показывает отчёт, а кнопка Открыть настройки ведёт к исправлению конфигурации.

Выбор способа установки. Режим влияет на то, будут ли приходить обновления сборки.

Как опубликовать сборку

Пункт Опубликовать сборку создаёт неизменяемую версию настроек и действий ассистента; базы знаний и секреты остаются в пространстве. В окне публикации задаются Версия в формате X.Y.Z с кнопками повышения, Видимость (Все пространства или Текущее пространство), Название сборки, Категория, Что нового и переключатель «Включить файлы ассистента — после установки они проиндексируются». История выпусков сохраняется и видна в том же окне.

Важно. Публикация сборок выключена по умолчанию: пункт меню появляется, только если администратор инсталляции платформы разрешил публикацию вашему пространству, а у вас есть право builds:publish.

Как перенести ассистента между пространствами

Пункт Экспортировать выгружает конфигурацию ассистента в архив ZIP. Кнопка Импортировать в шапке раздела загружает такой архив обратно и создаёт ассистента в текущем пространстве. Обе операции требуют права assistants:edit. Администратор инсталляции платформы может выключить экспорт и импорт для всей инсталляции — тогда обе операции завершаются отказом.

Как отправить ассистента в архив

Пункт Архивировать убирает ассистента из работы. Новые чаты с архивным ассистентом создать нельзя, а все связанные чаты переходят в режим только для чтения и скрываются из списка чатов. Архивные ассистенты собраны в блоке Архивные, откуда их возвращает пункт Восстановить.

Важно. Архивирование ассистента, установленного из витрины, удаляет установку сборки: карточка в витрине снова покажет действие Установить.

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

Почему ассистента не видно в списке

Ассистент архивирован или недоступен вашей роли. Проверьте:

• ассистент не находится в блоке Архивные;
• у вас есть право assistants:view;
• открыто то рабочее пространство, в котором создан ассистент.

Почему ассистент не отвечает по документам

Источники не подключены или ещё не готовы. Проверьте:

• нужная база знаний выбрана в блоке Источники знаний и изменения сохранены;
• у документов базы знаний завершена индексация;
• файлы ассистента в роли RAG-источник дошли до статуса Загружен;
• у ассистента в режиме Сценарий в самом сценарии есть узел Поиск по знаниям.

Почему не получается сохранить ассистента

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

• в режиме Внутри платформы заполнено поле LLM провайдер и модель; вариант По умолчанию тоже подходит;
• в режиме Сценарий выбран сценарий с опубликованной версией;
• у вас есть право assistants:edit;
• кнопка сохранения не подписана Защищено или Недоступно — так помечены ассистент из сборки в режиме Только использовать и системный ассистент.

Почему чат стал доступен только для чтения

Чат или его ассистент выведены из работы. Проверьте:

• сам чат не переведён в архив;
• ассистент, к которому привязан чат, не архивирован;
• у вас остались права на этот чат и ассистента.

Что дальше

• Чаты — как вести переписку с ассистентом и читать источники ответа.
• Действия ассистентов — как собрать действие и подключить его к ассистенту.
• Навыки и конструктор навыков — как зафиксировать повторяемое поведение агента.
• Базы знаний — как подготовить документы, по которым отвечает ассистент.
• Роли и права доступа — какие права нужны для создания и публикации ассистентов.