Навыки и конструктор навыков

Навык — это сохранённая инструкция, которая подмешивается ответу агента, когда задача похожа на ту, под которую навык создан. Навыки рабочего пространства живут в разделе Настройки → Рабочее пространство → Навыки, а работают только у ассистента в режиме «Агент» и только после привязки к нему. Пользовательский навык — это текст: программного кода в нём нет, и платформа вырезает код при сохранении. Применить навык в конкретном ответе решает модель, поэтому навык задаёт предпочтительное поведение, а не гарантирует его: для обязательного порядка шагов нужен сценарий (workflow).

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

право skills:author — оно есть у ролей owner, manager и member, у роли viewer его нет;
право assistants:edit, чтобы привязать навык к ассистенту;
ассистент, у которого доступен режим «Агент»;
сформулированная повторяемая задача: формат ответа, набор полей, чек-лист или тон.

Раздел «Навыки пространства»: колонка «Мои навыки» с кнопкой «Новый» и форма справа с полями «Название», «Инструкция», «Триггеры» и «Релевантные операции» — **Навыки пространства: список слева и форма навыка справа**. Раздел навыков рабочего пространства. Слева — собственные навыки, справа — редактор выбранного навыка.

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

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

Сущность	Что это	Кто запускает	Где настраивается
Навык	Текстовая инструкция для агента	Модель по смыслу запроса	Настройки → Рабочее пространство → Навыки
Действие	Операция над сообщением, стенограммой, выделением или перепиской	Читатель кнопкой в чате	Настройки → Рабочее пространство → Действия ассистентов
Сборка	Неизменяемая опубликованная версия ассистента	Участник другого пространства при установке	Ассистенты → Витрина

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

Какие навыки уже есть в платформе

Платформа приносит собственные навыки, и устанавливать их не требуется. Агент получает их автоматически там, где ему доступно выполнение кода, а конструктор навыков доступен всегда.

Навык	Для чего
`unica_docx`, `unica_xlsx`, `unica_pdf`, `unica_pptx`	Сборка и разбор документов, таблиц, `PDF` и презентаций
`criteria_scoring`	Оценка текста по набору критериев или рубрике
`reconcile`	Сверка двух источников по ключу и разбор расхождений
`extract_structured`	Извлечение структурных записей из связного текста
`constrained_text`	Переработка текста под ограничения: глоссарий, стиль, длина
`admin_analytics`	Статистика инсталляции для системного ассистента Admin Console
`skill_author`	Конструктор навыков: помогает собрать собственный навык прямо в чате

Примечание. Раздел Навыки пространства показывает только навыки, созданные в вашем пространстве. Навыки платформы в этот список не попадают и удалению не подлежат.

Как включить режим «Агент» в чате

Режим ответа переключается селектором Режим ответа в поле ввода чата: значения Чат и Агент. Навыки, привязанные к ассистенту, работают только в режиме Агент.

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

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

Поле ввода чата с раскрытым селектором «Режим ответа» и пунктами «Чат» и «Агент» — **Селектор режима ответа: «Чат» и «Агент»**. Переключатель режима ответа в поле ввода. Значение действует на следующий запрос.

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

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

Откройте чат с ассистентом и выберите в поле ввода режим Агент.
Напишите запрос обычными словами: «Создай навык, который…», «Сделай навык для агента, чтобы он…», «Улучши мой навык…».
Ответьте на уточняющие вопросы: что навык делает, когда срабатывает, какой формат ответа нужен.
Посмотрите черновик и результаты пробного прогона — конструктор показывает ответ с навыком и без него.
Скажите, что поправить, и повторите прогон нужное число раз.
Подтвердите создание навыка.

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

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

После создания навык появляется в разделе Навыки пространства и становится доступен для привязки к ассистенту.

Как создать навык вручную в разделе «Навыки»

Навык можно собрать и без конструктора — в разделе Настройки → Рабочее пространство → Навыки. Кнопка Новый очищает форму, кнопка Создать навык сохраняет её; у сохранённого навыка кнопка называется Сохранить изменения. Навык из списка удаляется значком корзины рядом с названием.

Поле	Что указать	Обязательно
Название	Короткое имя, по которому навык видно в списке и в привязке	Да
Описание	Одна строка о том, для чего навык; видна в списке	Нет
Инструкция	Что и как делает агент, когда навык применим; примеры «вход → выход»	Да
Триггеры (по строке)	Слова и формулировки запросов, при которых навык уместен	Нет
Релевантные операции (по строке)	Операции, при которых инструкция навыка попадает в промпт агента	Да

Поле Релевантные операции решает, дойдёт ли инструкция до агента. По умолчанию в нём стоят chat.get_context, chat.get_messages и knowledge.search — этого набора хватает для обычных вопросов и для вопросов по базам знаний. Оставьте значения по умолчанию, если не уверены: пустое или неподходящее значение и есть самая частая причина, по которой навык «не срабатывает».

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

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

Откройте раздел Ассистенты и нажмите Настройки на карточке нужного ассистента.
Перейдите в раздел Навыки.
Отметьте нужные навыки в списке.
Нажмите Сохранить навыки.

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

Раздел «Навыки» формы ассистента: список навыков пространства с отмеченными пунктами и кнопка «Сохранить навыки» — **Раздел «Навыки» в настройках ассистента**. Привязка навыков к ассистенту. Отмеченные навыки становятся доступны агенту в чатах этого ассистента.

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

Навык создан, но агент его не применяет

Инструкция навыка не доходит до агента или сам навык не выбран моделью. Проверьте:

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

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

В навык не получается добавить код

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

Раздела «Навыки» нет в настройках пространства

Пункт меню виден только при праве skills:author. Проверьте:

ваша роль в пространстве — owner, manager или member;
открыто то рабочее пространство, в котором вы ожидаете увидеть навыки;
владелец пространства не сузил права вашей роли.

Конструктор не отзывается на запрос «создай навык»

Переписка идёт не в режиме «Агент» или запрос сформулирован слишком общо. Проверьте:

в поле ввода выбран режим Агент, а сам селектор доступен вашему пространству;
запрос начинается с явной формулировки: «создай навык, который…»;
у вас есть право skills:author, иначе создание завершится отказом на последнем шаге.

Что дальше

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