UnicaДокументацияНа сайт

Ассистенты

Статус: актуально для текущего интерфейса платформы

Документ исторически относился к legacy-линейке документации про старую продуктовую сущность, но в актуальном интерфейсе она называется ассистент. Именно ассистент определяет, как платформа отвечает в чате, какие знания использует, какие действия доступны пользователю и как обрабатываются аудио- и видеофайлы.

Что такое ассистент

Ассистент объединяет в одной настройке:

  • поведение модели;
  • системную инструкцию;
  • подключённые базы знаний;
  • файлы ассистента;
  • действия, доступные в чате;
  • маршрут транскрибации.

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

Когда нужен отдельный ассистент

Создавайте отдельного ассистента, если вам нужно:

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

Если этого не требуется, можно начать с Unica AI и перейти к собственной конфигурации позже.

Как создать ассистента

  1. Откройте раздел Ассистенты.
  2. Нажмите Создать ассистент.
  3. Заполните основные поля:
    • название;
    • описание;
    • иконку.
  4. Выберите режим обработки:
    • Внутри платформы;
    • Глобальный сценарий.
  5. Сохраните ассистента.

После первого сохранения становятся доступны остальные настройки: знания, файлы, действия, транскрибация и архивные операции.

Основные настройки

На основной странице ассистента обычно настраивают:

  • название и описание;
  • иконку;
  • системный промпт;
  • LLM-провайдера и модель;
  • режим обработки;
  • источники знаний;
  • параметры поиска по знаниям.

Минимально рабочая конфигурация выглядит так:

  • понятное имя;
  • краткое описание;
  • режим Внутри платформы;
  • модель;
  • при необходимости одна или несколько баз знаний.

Режимы обработки

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

Это основной режим для большинства пользовательских сценариев.

Он подходит, если вам нужен:

  • обычный диалог с LLM внутри платформы;
  • поиск по базам знаний;
  • ответы по файлам ассистента;
  • показ источников в чате;
  • встроенная транскрибация;
  • действия поверх сообщений и документов.

В этом режиме расширенные параметры поиска и показа источников настраиваются прямо в карточке ассистента.

Глобальный сценарий

Этот режим нужен, когда ответ ассистента должен управляться опубликованным workflow-сценарием.

Что важно:

  • в настройках ассистента выбирается конкретный глобальный сценарий;
  • платформа использует его последнюю опубликованную версию;
  • если сценарий использует узел Поиск по знаниям, базы знаний всё равно выбираются в ассистенте;
  • детальные настройки RAG в этом режиме настраиваются уже в самом workflow, а не в форме ассистента.

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

Источники знаний

Ассистент может использовать два типа источников:

  • базы знаний рабочего пространства;
  • файлы ассистента.

Если источники не подключены, ассистент работает как обычный LLM-ассистент. Если они подключены, платформа может искать релевантный контент и показывать пользователю, на что именно опирается ответ.

Базы знаний

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

Используйте этот вариант, если:

  • знания должны обновляться командой централизованно;
  • документы нужно организовать по папкам;
  • для разных документов нужны разные уровни доступа;
  • один и тот же набор знаний нужен нескольким ассистентам.

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

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

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

Поддерживаются:

  • PDF;
  • DOC;
  • DOCX;
  • TXT;
  • XLSX.

Ограничения:

  • до 10 файлов за одну загрузку;
  • до 100 MB на файл.

У каждого файла есть статус обработки: загрузка, обработка, готовность или ошибка.

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

Поиск по знаниям и RAG

Для ассистентов в режиме Внутри платформы доступны расширенные параметры retrieval и генерации.

Можно выбрать один из двух подходов:

  • использовать активный search profile рабочего пространства;
  • перейти в кастомный режим и задать параметры только для этого ассистента.

В кастомном режиме обычно настраивают:

  • стратегию поиска: RRF, Weighted Thresholded или Union;
  • Top K и другие лимиты;
  • пороги релевантности;
  • query rewrite;
  • LLM rerank;
  • кеш контекста;
  • объём истории, который передаётся в контекст;
  • показ источников пользователю.

Если ассистент работает через workflow, тонкая настройка RAG переносится в сам сценарий.

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

Транскрибация

У ассистента есть отдельный блок Маршрут транскрибации. Он определяет, как платформа обрабатывает аудио- и видеофайлы.

Доступны два варианта:

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

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

Действия ассистента

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

Обычно действия используют для того, чтобы:

  • запускать обработку сообщения;
  • запускать обработку транскрипта;
  • создавать документы;
  • вызывать шаги workflow по кнопке;
  • предлагать пользователю структурированное продолжение сценария.

Доступность конкретного действия зависит от:

  • настройки самого ассистента;
  • прав пользователя;
  • состояния выбранного чата;
  • связанного workflow или ресурса.

Импорт, экспорт и архив

В разделе ассистентов доступны базовые операции жизненного цикла:

  • создание;
  • импорт ассистента из ZIP;
  • экспорт ассистента;
  • архивирование;
  • восстановление из архива.

Что важно знать об архивировании:

  • новые чаты с архивным ассистентом создавать нельзя;
  • существующие связанные чаты переходят в режим read-only;
  • ассистент можно восстановить позже;
  • архивные ассистенты показываются отдельно от активных.

Ограничения и частые причины ошибок

Ассистент не виден в списке для нового чата

Проверьте:

  • не архивирован ли он;
  • есть ли у вас право на просмотр ассистентов;
  • сохранён ли ассистент без ошибок;
  • открыт ли корректный workspace.

Нет ответа по документам

Обычно причина в одном из пунктов:

  • нужная база знаний не подключена;
  • документы ещё не проиндексированы;
  • файлы ассистента ещё обрабатываются;
  • в workflow-режиме поиск по знаниям не настроен внутри сценария.

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

Чаще всего проблема в следующем:

  • не выбрана модель;
  • для режима Глобальный сценарий не выбран опубликованный workflow;
  • у пользователя только права просмотра;
  • редактируется системный ассистент с ограничениями на изменение.

Почему чат стал read-only

Обычно это происходит, если:

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

Связанные разделы