Skip to main content
Навыки объединяют повторно используемые инструкции и вспомогательные файлы, которые учат Craft выполнять определённый вид работы. Откройте Craft → Навыки, чтобы просматривать, загружать, предоставлять доступ и управлять навыками.
Любой пользователь может загрузить навык и управлять навыками, которыми он владеет или которые может редактировать. Менеджер группы также может управлять навыками, доступными группам, которыми он управляет. Администраторы могут просматривать и контролировать все пользовательские навыки, включая приватные личные.

Библиотека навыков

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

Встроенные навыки

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

Подготовка пользовательского навыка

Загружайте SKILL.md напрямую, если навыку не нужны вспомогательные файлы. Для навыка со скриптами, примерами или другими вспомогательными файлами создайте папку с SKILL.md на верхнем уровне. Перетащите папку в Yahont или загрузите её в виде ZIP-архива.
Для отдельного SKILL.md Yahont создаёт slug из поля name во frontmatter. Для папки slug становится именем папки. Для ZIP-архива slug — имя файла без .zip. Имена папок и ZIP-архивов должны начинаться со строчной буквы, содержать только строчные буквы, цифры и дефисы и быть не длиннее 64 символов. Slug должны быть уникальными. Если существующий навык уже использует slug, обновите этот навык или измените исходное имя до загрузки.
Для загрузки ZIP-архива поместите SKILL.md в корень архива или прямо внутрь одной внешней папки. Если используется внешняя папка, держите все файлы навыка внутри неё. Загружайте только один навык за раз. SKILL.md должен начинаться с frontmatter YAML с непустыми именем и описанием. В описании должно быть указано, когда Craft следует выбирать этот навык.

Требования к набору

Операторы с самостоятельным размещением могут изменить ограничения размера с помощью SKILL_BUNDLE_PER_FILE_MAX_BYTES и SKILL_BUNDLE_TOTAL_MAX_BYTES. Загрузка отклоняется, если в наборе есть небезопасные пути, символические ссылки, файлы с окончанием .template, отсутствует или некорректен frontmatter, недопустим источник slug, дублируется slug навыка или slug зарезервирован встроенным навыком или приложением.

Проверка навыка перед публикацией

Относитесь к набору навыка как к коду и политике, а не только как к тексту промпта. Craft может выполнять скрипты и команды, включённые в архив.
Никогда не публикуйте набор, содержащий пароли, API-ключи, токены OAuth, приватные сертификаты или рабочие учётные данные. Файлы навыка копируются в песочницы пользователей, у которых есть доступ к навыку. Для авторизованного доступа к внешним сервисам используйте приложения.

Публикация навыка

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

Создайте личный навык

Откройте Craft → Навыки и нажмите Создать навык. Выберите Создать с нуля, чтобы написать навык в Yahont, или Загрузить навык, чтобы импортировать SKILL.md, ZIP-архив или папку навыка. Заполните редактор и нажмите Создать.
2

Проверьте навык

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

Выберите, кто может им пользоваться

Выберите Изменить доступ и предоставьте доступ «Просмотр» конкретным пользователям, группам или организации. Используйте доступ «Редактор» только для тех, кто отвечает за поддержку.
4

Проверьте с целевой аудиторией

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

Выбор прав общего доступа

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

Поддержка навыка

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

Владение

У каждого пользовательского навыка один владелец. Владелец может передать его другому активному обычному пользователю. Если право владения освободилось из-за неактивности владельца, администратор может открыть навык и передать его. Не передавайте право владения ботам, сервисным аккаунтам, аккаунтам с ограниченными правами и неактивным пользователям.

Устранение неполадок

Убедитесь, что в загрузке один навык. SKILL.md должен лежать на верхнем уровне папки. В ZIP-архиве поместите его в корень архива или прямо внутрь одной внешней папки. Проверьте, что он в кодировке UTF-8 и начинается с корректного YAML с непустыми полями name и description. Для отдельного SKILL.md убедитесь, что name содержит хотя бы одну букву или цифру. Иначе проверьте имя папки или ZIP-архива. Проверьте ограничения набора и удалите символические ссылки и небезопасные пути.
Откройте его предпросмотр, чтобы прочитать причину недоступности. Настройте генерацию изображений для навыка изображений или попросите оператора развёртывания проверить среду выполнения браузера для навыка «Браузер». Встроенные навыки нельзя заменить или включить из редактора навыков.
Убедитесь, что навык включён, а у пользователя или его группы есть доступ «Просмотр» или «Редактор». Если доступ предоставлен во время активной сессии, начните новый шаг или сессию и снова проверьте список выбора.
Перепишите описание, указав охватываемые задачи и результаты конкретнее. Проверьте снова и попросите пользователей выбирать навык явно, когда нужно строго следовать рабочему процессу.
После того как аккаунт станет неактивным, администратор может открыть навык, выбрать Изменить доступ и передать освободившееся право владения активному обычному пользователю.

Навыки для пользователей

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

Управление приложениями

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