Перейти к содержимому

Навыки

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

У навыка три уровня, и загружается он ровно настолько, насколько нужно:

  1. Название и описание — бот видит их всегда, чтобы понимать, когда навык подходит.
  2. Содержимое — весь порядок действий, в Markdown. Загружается, когда бот решает, что навык к месту.
  3. Материалы — дополнительные документы при навыке (прайс-лист, руководство по 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.