Навыки

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

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

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

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

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

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

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

Платформа приносит собственные навыки, и устанавливать их не требуется. Навыки форматов агент получает в каждом запуске, а навык-методику — когда его закрепляет агентская команда. Так системная команда Вычитать документ закрепляет навык proofread. Команду со своими закреплёнными навыками пространство создаёт в разделе Действия ассистентов.

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

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

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

Пункт Авто показывается только в чате системного ассистента Уника AI и только если администратор инсталляции включил функцию «Режим «Авто» у Уники AI». К Уника AI навыки не привязываются, его раздел навыков доступен только для чтения, поэтому у ассистентов с навыками выбор остаётся между Чат и Агент.

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

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

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

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

1. Откройте чат с ассистентом и выберите в поле ввода режим Агент.
2. Опишите задачу обычными словами: «Создай навык, который…» или «Улучши мой навык…». Назовите, что навык делает, когда его применять и какой нужен результат.
3. Ответьте на уточняющие вопросы, если агент их задаст: он спрашивает только о недостающем, один-два вопроса за раз.
4. Посмотрите предложение агента: название, описание, суть инструкции и итог пробного прогона с навыком и без него. Ответьте, создавать ли навык так или что поправить.
5. Нажмите Выполнить в карточке согласования, чтобы создать навык.
6. Нажмите Выполнить во второй карточке, чтобы подключить навык к ассистенту этого чата.

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

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

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

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

Описание — главное поле навыка: агент видит описания подключённых навыков и открывает инструкцию того навыка, чьё описание подходит к задаче. Начните описание с того, что делает навык, а затем назовите задачи и формулировки запросов, при которых он нужен, например: «Оформляет ответ по регламенту: основание, вывод и срок. Нужен, когда просят ответ для руководства». Из описания агент видит первые 1 024 символа, поэтому главное пишите в первых предложениях.

Под полями Описание и Инструкция платформа показывает счётчики длины. Описание длиннее 1 024 символов сохраняется, а счётчик предупреждает, что агент увидит только начало. Инструкция вмещает до 50 000 символов: текст сверх предела остаётся в поле, счётчик становится красным и подсказывает, сколько символов убрать, а кнопка Создать навык — у сохранённого навыка Сохранить изменения — недоступна до правки.

Как сделать навык папкой

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

Поле Файлы навыка в форме навыка принимает папку целиком. Выберите её на диске — платформа возьмёт текстовые файлы .md, .txt, .json, .csv, .yaml и .yml и покажет список. Файл SKILL.md из корня папки платформа считает телом навыка и переносит его текст в поле Инструкция. Вложенные папки сохраняются: файл checks/I-1.md так и останется checks/I-1.md.

Если SKILL.md начинается с заголовка между строками --- с полями name и description, форма подставляет их в пустые поля Название и Описание, а сам заголовок в инструкцию не попадает. Так готовый навык в распространённом формате папки со SKILL.md переносится в пространство выбором папки.

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

Ограничения: до 200 файлов и до 2 МБ текста на навык, один файл — до 500 КБ. Файлы других форматов — картинки, архивы, таблицы Excel, скрипты — в навык не попадают: платформа их пропускает и пишет, сколько файлов пропущено.

В инструкции ссылайтесь на файлы по именам — «прочитай format.md», «пункты лежат в папке checks/». Агент найдёт их сам рядом с навыком.

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

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

1. Откройте раздел Ассистенты и нажмите Настройки на карточке нужного ассистента.
2. Перейдите в раздел Навыки.
3. Найдите нужный навык в разделе Доступные. Если навыков много, используйте поиск по названию или описанию.
4. Нажмите Подключить. Навык сразу перейдёт в раздел Подключённые и станет доступен агенту.

В разделе Доступные карточка-ссылка Создать навык открывает Настройки → Рабочее пространство → Навыки в новой вкладке; она доступна с правом skills:author. Название созданного в пространстве навыка открывает в новой вкладке его настройки. Для навыков платформы и при отсутствии права skills:author этот переход не показывается.

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

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

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

Агент выбирает навык по описанию, поэтому чаще всего навык не подключён или описание не подходит под формулировку задачи. Проверьте:

• навык находится в разделе Подключённые настроек ассистента;
• в поле ввода чата выбран режим Агент;
• описание говорит, что делает навык и в каких задачах он нужен, теми же словами, какими вы формулируете запрос;
• главное в описании стоит в первых предложениях: из длинного описания агент видит только начало.

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

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

Навык пространства состоит из текста, и исполняемых файлов в нём не бывает. Фрагмент кода в инструкции или в файле .md сохраняется как обычный текст, а файлы скриптов форма пропускает при выборе папки. Выполнение кода остаётся за навыками платформы и за узлами сценария.

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

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

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

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

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

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

Что дальше

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