Ассистенты

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

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

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

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

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

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

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

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

На телефоне откройте Ассистенты через кнопку меню в шапке. Используйте поиск и сортировку, затем нажмите верхнюю часть карточки, чтобы перейти к переписке. Чтобы выбрать другого ассистента во время разговора, откройте главное меню. Меню ⋯ у строки ассистента позволяет закрепить его или изменить порядок без перетаскивания.

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

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

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

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

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

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

1. Откройте раздел Ассистенты.
2. Нажмите Создать ассистент.
3. В открывшемся окне укажите Название.
4. При желании выберите иконку и цвет, добавьте описание и инструкцию ассистента.
5. Нажмите Создать.

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

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

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

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

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

В окне выбора иконки символ и цвет сначала меняются в предпросмотре. Нажмите Готово, чтобы применить выбор, или Отмена, чтобы оставить прежнюю иконку. Доступны серый, коричневый, жёлтый, оранжевый, зелёный, синий, фиолетовый и розовый цвета. Фирменный цвет Уника AI зарезервирован за системными ассистентами. Ранее сохранённый красный цвет продолжает отображаться, но выбрать его заново в палитре нельзя.

Предел длины инструкции

Под полем Инструкция ассистента идёт счётчик формата <введено> из 50 000 символов — он же виден в большом редакторе. Предел общий для всех промптов платформы: библиотеки промптов, инструкции ассистента и промпта действия. Текст сверх предела не обрезается, но сохранение ждёт правки.

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

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

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

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

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

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

Чат-ассистент

В секции Как работает ассистент тип выбирается карточками Чат-ассистент и Сценарный ассистент. Второй вариант доступен только при разрешении администратора.

Вариант Чат-ассистент — основной режим обработки. Он отвечает по инструкции, использует выбранную модель и подключённые знания. Платформа сама ведёт переписку: обращается к модели, ищет по базам знаний и файлам ассистента, показывает источники в ответе, запускает встроенную транскрибацию и действия над сообщениями.

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

Сценарный ассистент

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

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

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

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

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

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

Как поручить создание ассистента агенту

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

Ограничения те же, что у формы: системных ассистентов агент не меняет, у ассистента из сборки в режиме Только использовать меняет только базы знаний, а удаление и архив остаются в интерфейсе. Как составить просьбу и что показывает карточка — в главе Агент.

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

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

Базы знаний

Базы знаний подключаются на вкладке Знания, и один ассистент может работать сразу с несколькими. Нажмите Подключить базу, отметьте нужные базы и подтвердите выбор кнопкой Подключить одну базу либо, например, Подключить 3 базы или Подключить 5 баз — подпись меняется по числу выбранных баз. Выбранные базы сразу появляются в группе Источники для ответов; отдельно сохранять ассистента не нужно. Выбирайте базу знаний, когда документы ведёт вся команда, нужна структура папок, разным документам нужны разные уровни доступа или один набор знаний используют несколько ассистентов.

Для одного сообщения можно указать базу через @ в чате с любым ассистентом. Поиск для этого сообщения ограничится указанными базами, даже если выбраны другие источники; под ответом появится строка Искали в: …. На следующее сообщение указание не переносится. Подробнее — Чаты.

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

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

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

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

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

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

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

Источники для ответов и рабочие материалы

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

Новый файл сразу добавляется в Источники для ответов — выбирать роль перед загрузкой не нужно. Чтобы изменить назначение, откройте меню ⋯ у файла и выберите Сделать рабочим материалом. Вернуть его в поиск можно прямым действием Сделать источником для ответов. Одинаковые действия доступны в настройках и в панели ассистента.

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

Материалы подаются экономно: в контекст чата попадает короткий список доступных материалов, а полный текст читается по требованию. В режиме Агент ассистент читает как текст материал любого поддерживаемого формата: таблицу XLSX — по листам и строкам, скан PDF — через OCR-провайдер инсталляции, если он подключён.

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

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

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

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

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

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

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

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

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

Действия

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

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

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

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

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

Навыки

Навык — инструкция для агента, которую агент открывает, когда задача подходит под описание навыка. Экран Навыки агента показывает отдельные карточки в разделах Подключённые и Доступные. Кнопки Подключить и Отключить применяют изменение сразу, без общей или отдельной кнопки сохранения. Если подключённый навык стал недоступен, вместо Отключить отображается Убрать. Подключённые навыки доступны ассистенту в режиме «Агент», и применить навык в конкретном ответе решает модель. Подробнее — Навыки.

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

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

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

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

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

Раздел предлагает два взаимоисключающих варианта.

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

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

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

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

Результат транскрибации

Раздел Результат транскрибации доступен только для встроенного распознавания.

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

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

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

Вкладка Качество в настройках ассистента собирает итоги проверки достоверности за последние 30 дней — она заполняется, когда администратор включил проверку для пространства и ассистент отвечает по базам знаний или файлам.

• Плитки Ответов с источниками, Подтверждено, Частично и Без опоры показывают долю ответов по вердиктам и изменение к предыдущему периоду; график ниже — те же вердикты по дням.
• Блок Пробелы в знаниях группирует вопросы, на которые ассистент отвечал без опоры на источники. Если в пространстве есть база знаний по этой теме, но она не подключена к ассистенту, блок предложит её — кнопка ведёт на вкладку Знания.
• Блок Рекомендации по поиску подсказывает, что изменить на вкладке Поиск и контекст: включить ранжирование фрагментов моделью, поднять минимальную релевантность, увеличить число фрагментов в контексте. Каждая рекомендация показывает, на скольких ответах она основана.
• Список Последние ответы без опоры ведёт в чаты, где ответ не подтвердился, — так проще понять, чего не хватает в базах.

Замкнуть петлю можно без администратора платформы: подключить недостающую базу, поправить поиск и через несколько дней проверить, как изменились плитки.

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

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

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

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

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

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

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

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

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

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

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

Для ассистента со сценарием в сборку входит последняя опубликованная версия сценария, поэтому сначала опубликуйте сценарий в редакторе. Базы знаний, которые сценарий читает, при публикации становятся доступны на чтение всем пространствам инсталляции — окно перечисляет их и просит отметить подтверждение. Для этого шага нужно право kb:share:manage, базы из чужих пространств расшарить может только их владелец.

Шаблоны документов .docx, загруженные в узлы Типизированный шаблон, входят в сборку сами: при установке они копируются в пространство, куда ставят сборку. Если файл шаблона не найден, публикация пройдёт с предупреждением — загрузите шаблон в узел заново, опубликуйте сценарий и выпустите новую версию сборки.

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

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

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

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

Файлы и базы знаний. Файлы ассистента едут в архиве и заново индексируются у получателя. Базы знаний остаются у владельца, архив несёт только ссылки на них. Импорт подключает базу, если пространство получателя может её читать. Это собственная база пространства или база, доступ к которой владелец открыл этому пространству или всей инсталляции. Иначе ассистент импортируется без базы, а отчёт называет её и подсказывает, что сделать. На той же инсталляции нужно попросить владельца открыть доступ на чтение и затем подключить базу в разделе Знания. На другую инсталляцию базу переносят отдельным архивом базы знаний.

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

Навыки. Системный навык импорт ставит в пространство и подключает. Навык пространства едет текстом вместе с файлами навыка-папки, и импорт создаёт его заново или подключает такой же навык пространства получателя.

Сценарий. Ассистент на системном сценарии переносится, если такой сценарий опубликован на инсталляции получателя. Для ассистента на своём сценарии пространства импорт создаёт копию сценария и публикует её. Если опубликовать не удалось, импорт отменяется целиком. Шаблоны .docx узлов Типизированный шаблон едут в архиве и копируются в пространство получателя. Если файла шаблона не было в исходном пространстве, ассистент импортируется, а отчёт называет шаблон и узел: загрузите шаблон в узел заново и опубликуйте сценарий.

Импорт создаёт то, на что у участника есть права:

Без права на действие или навык импорт пропускает их и перечисляет в отчёте. Без прав на сценарий ассистент со своим сценарием не импортируется.

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

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

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

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

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

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

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

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

Для разового вопроса по определённой базе введите @ в поле сообщения и выберите базу. Это ограничит поиск для данного сообщения; подробнее — Чаты.

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

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

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

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

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

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

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

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

Что дальше

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