Навыки
Навык — записанный порядок действий: как справляться с одним видом задач. Навыки принадлежат пространству, и любому боту можно дать любой из них.
Как бот пользуется навыком
Заголовок раздела «Как бот пользуется навыком»У навыка три уровня, и загружается он ровно настолько, насколько нужно:
- Название и описание — бот видит их всегда, чтобы понимать, когда навык подходит.
- Содержимое — весь порядок действий, в Markdown. Загружается, когда бот решает, что навык к месту.
- Материалы — дополнительные документы при навыке (прайс-лист, руководство по API). Читаются, только если порядок действий на них ссылается.
Поэтому у бота может быть много навыков, и он не платит за них в каждом сообщении.
Как написать навык
Заголовок раздела «Как написать навык»- Название: строчные латинские буквы, цифры и одиночные дефисы, до 64 символов —
например,
monthly-close. Названия в пространстве не повторяются. - Описание: для чего навык и когда его применять, до 1024 символов. Именно его бот читает, чтобы решить, поэтому пишите конкретно.
- Содержимое: сами шаги.
Быстрее всего попросить бота: «сделай из того, что мы сейчас сделали, навык». Он напишет навык и подключит его к себе.
Справочные материалы
Заголовок раздела «Справочные материалы»Материал — отдельный документ при навыке: прайс-лист, таблица тарифов, описание API. Бот читает его, только когда содержимое навыка на него ссылается, поэтому длинные справочные данные не занимают место в каждом сообщении.
- Добавить: попросите бота в чате — «добавь к навыку
monthly-closeматериал с прайс-листом». Он запишет материал сам. Через API —POST /skills/{skillId}/references/с полямиname,contentи необязательнымdescription. - Сослаться: в содержимом навыка укажите путь
references/<name>.md— например, «цены бери изreferences/prices.md». Без ссылки бот о материале не узнает.
Материалы навыка видны в его карточке в разделе «Плагины».
Кто может писать навыки
Заголовок раздела «Кто может писать навыки»У каждого бота есть настройка создания навыков:
| Настройка | Бот может |
|---|---|
| workspace | Создавать, править и удалять любые навыки и подключать их к другим ботам (по умолчанию) |
| own | Создавать навыки и править только написанные им самим; подключать только к себе |
| off | Пользоваться своими навыками, но не создавать и не менять их |
Через API
Заголовок раздела «Через API»См. Навыки в справочнике API.