NeboAI
NeboAI
Почати

Навички

Навичка вчить співробітника добре виконувати один вид роботи. Ви пишете її як папку з файлом SKILL.md: короткий опис, за яким співробітник вибирає навичку, та інструкції, яких він дотримується після її завантаження. Навички не потребують коду, і їх може використовувати кожен співробітник на боті.

Що таке навичка

Навичка — це папка, назва якої збігається з name навички. У папці є файл SKILL.md і, за бажанням, будь-які інші файли, на які посилаються інструкції: довідкові документи, шаблони або скрипти.

SKILL.md має дві частини. YAML-заголовок між рядками --- містить назву й опис. Тіло Markdown після нього містить інструкції.

Як співробітники використовують навички

Співробітник працює з навичкою у три кроки.

  1. Вибір. Щоходу співробітник бачить список доступних йому навичок: назву кожної навички, її опис і до трьох її тригерів. Саме опис співробітник читає, щоб вирішити, тож пишіть у ньому, що робить навичка і коли її використовувати.
  2. Завантаження. Співробітник викликає інструмент use_skill із назвою навички. Інструмент повертає інструкції, шлях до папки навички й назви її файлів. Це єдиний спосіб, у який співробітник читає навичку.
  3. Робота. Співробітник виконує інструкції. Допоміжні файли він читає за допомогою read_skill_file, а вбудовані скрипти запускає за допомогою execute.

Тригери ніколи не завантажують навичку самі. Вибір завжди робить співробітник. Коли список стає довгим, співробітник може шукати в ньому за допомогою find_skills.

Напишіть свою першу навичку

Створіть папку з назвою навички й одним файлом у ній.

meeting-notes/
└── SKILL.md
---
name: meeting-notes
description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript.
---

# Meeting notes

1. List the decisions that were made.
2. List action items as "owner — task — due date".
3. List open questions that need a follow-up.

Keep each list short. If the transcript names no owner for an item, write "unassigned".

Покладіть папку в каталог користувацьких навичок бота (див. Де зберігаються навички). Nebo помічає нову папку приблизно за секунду, і навичку може використовувати кожен співробітник на цьому боті.

Співробітник також може написати навичку для вас. Попросіть його зберегти її, і він викличе save_skill, який записує папку в той самий каталог користувацьких навичок.

Правила, які застосовує завантажувач

Навичка, яка порушує одне з цих правил, не завантажується. Nebo записує попередження в журнал і пропускає її.

ПравилоПодробиці
Файл починається з ---Заголовок має бути першим у файлі. Файл має бути в UTF-8.
name обов'язковийЛише малі літери, цифри й дефіси; без дефіса на початку чи в кінці; без подвійного дефіса; щонайбільше 64 байти.
description обов'язковийЩонайбільше 1 024 байти.
Поля мають правильний типПоле з неправильним типом YAML ламає весь файл. Беріть версії в лапки, наприклад "1.0.0".
platform збігаєтьсяЯкщо поле є, навичка завантажується лише на перелічених операційних системах.

Ключі заголовка, яких Nebo не розпізнає, ігноруються. Розмір тіла не обмежено, але коротші інструкції залишають більше місця для роботи. Довгі матеріали перенесіть у файли, які співробітник читає, коли вони йому потрібні.

Додайте файли

Будь-який файл у папці, крім SKILL.md і файлів, що починаються з крапки, доступний співробітнику. Назви папок обираєте ви; Nebo не надає особливого значення references/ чи assets/. Файли в scripts/ або bin/ можна запускати.

invoice-check/
├── SKILL.md              # required
├── references/
│   └── policy.md         # read with read_skill_file
└── scripts/
    └── totals.py         # run with execute

Посилайтеся на файли за шляхом усередині папки, наприклад references/policy.md. Співробітник читає їх за допомогою read_skill_file, який відхиляє будь-який шлях, що виходить за межі папки. Скрипти запускаються інструментом execute у пісочниці. Довідник SKILL.md описує середовища виконання, змінні середовища, секрети й доступ до мережі.

Де зберігаються навички

Бот збирає навички з кількох місць. Коли два джерела надають навичку з однаковою назвою, перемагає те, що стоїть у цьому списку пізніше.

ДжерелоРозташуванняХто може використовувати
ВбудованаВбудовано в Nebo під час збиранняКожен співробітник
Маркетплейс<data>/nebo/skills/<slug>/<version>/Кожен співробітник
ПлагінПапка skills/ установленого плагінаКожен співробітник
Користувач<data>/user/skills/<name>/Кожен співробітник
Пакет співробітникаskills/ усередині встановленого пакета співробітникаЛише цей співробітник
Вивчена<data>/learned/skills/<employee>/<name>/Лише цей співробітник

<data> — це ~/Library/Application Support/Nebo на macOS, %APPDATA%\Nebo на Windows і ~/.local/share/nebo на Linux. Змінна середовища NEBO_HOME його перевизначає. Коли співробітник має власну навичку і спільну навичку з тією самою назвою, перемагає його власна.

Nebo стежить за цими папками й перезавантажує змінену навичку через секунду. Щоб вимкнути навичку, не видаляючи її, перейменуйте її файл на SKILL.md.disabled.

Навички описують роботу, а не інструменти. Пишіть навичку навколо обов'язку, наприклад звірки чеків, і дозвольте співробітнику використовувати будь-яке підключення, яке надав власник. Коли навичці справді потрібен плагін, оголосіть його в полі plugins.

Далі