NeboAI
NeboAI
Začít

Dovednosti

Dovednost učí zaměstnance, jak dobře dělat jeden druh práce. Napíšete ji jako složku se souborem SKILL.md: krátký popis, podle kterého si zaměstnanec dovednost vybere, a pokyny, kterými se po jejím načtení řídí. Dovednosti nepotřebují žádný kód a může je používat každý zaměstnanec na botovi.

Co je dovednost

Dovednost je složka, jejíž název odpovídá hodnotě name dovednosti. Složka obsahuje soubor SKILL.md a volitelně další soubory, na které pokyny odkazují: referenční dokumenty, šablony nebo skripty.

SKILL.md má dvě části. Úvodní blok YAML mezi řádky --- nese název a popis. Tělo v Markdownu za ním nese pokyny.

Jak zaměstnanci dovednosti používají

Zaměstnanec pracuje s dovedností ve třech krocích.

  1. Výběr. V každém tahu zaměstnanec vidí seznam dovedností, které má k dispozici: název každé dovednosti, její popis a až tři její spouštěče. Podle popisu se zaměstnanec rozhoduje, takže v něm uveďte, co dovednost dělá a kdy ji použít.
  2. Načtení. Zaměstnanec zavolá nástroj use_skill s názvem dovednosti. Nástroj vrátí pokyny, cestu ke složce dovednosti a názvy jejích souborů. Jiným způsobem zaměstnanec dovednost nečte.
  3. Práce. Zaměstnanec postupuje podle pokynů. Podpůrné soubory čte pomocí read_skill_file a přibalené skripty spouští pomocí execute.

Spouštěče nikdy dovednost samy nenačtou. Rozhodnutí vždy dělá zaměstnanec. Když se seznam prodlouží, může v něm zaměstnanec hledat pomocí find_skills.

Napište svou první dovednost

Vytvořte složku pojmenovanou podle dovednosti a vložte do ní jeden soubor.

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".

Vložte složku do uživatelského adresáře dovedností na botovi (viz Kde jsou dovednosti uložené). Nebo si nové složky všimne přibližně do sekundy a každý zaměstnanec na tomto botovi může dovednost používat.

Dovednost vám může napsat i zaměstnanec. Požádejte ho, ať nějakou uloží, a on zavolá save_skill, který zapíše složku do stejného uživatelského adresáře dovedností.

Pravidla, která zavaděč vynucuje

Dovednost, která poruší některé z těchto pravidel, se nenačte. Nebo zapíše do protokolu varování a dovednost přeskočí.

PravidloPodrobnosti
Soubor začíná ---Úvodní blok musí být v souboru úplně první. Soubor musí být v kódování UTF-8.
name je povinnéPouze malá písmena, číslice a pomlčky; bez pomlčky na začátku nebo na konci; bez dvojité pomlčky; nejvýše 64 bajtů.
description je povinnéNejvýše 1 024 bajtů.
Pole mají správný typPole s nesprávným typem YAML znehodnotí celý soubor. Verze uvádějte v uvozovkách, například "1.0.0".
platform odpovídáPokud je uvedeno, dovednost se načte jen v uvedených operačních systémech.

Klíče úvodního bloku, které Nebo nezná, se ignorují. Velikost těla není omezená, ale kratší pokyny nechávají víc prostoru pro samotnou práci. Rozsáhlé materiály přesuňte do souborů, které si zaměstnanec přečte, až je bude potřebovat.

Přidání souborů

Každý soubor ve složce kromě SKILL.md a skrytých souborů začínajících tečkou je zaměstnanci k dispozici. Názvy složek volíte sami; Nebo nepřikládá references/ ani assets/ žádný zvláštní význam. Soubory ve složkách scripts/ a bin/ lze spouštět.

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

Na soubory odkazujte cestou uvnitř složky, například references/policy.md. Zaměstnanec je čte pomocí read_skill_file, který odmítne každou cestu vedoucí mimo složku. Skripty se spouštějí nástrojem execute v izolovaném prostředí. Referenční příručka k SKILL.md popisuje běhová prostředí, proměnné prostředí, tajné údaje a přístup k síti.

Kde jsou dovednosti uložené

Bot sbírá dovednosti z několika míst. Když dva zdroje poskytují dovednost se stejným názvem, má přednost zdroj, který je v tomto seznamu uveden později.

ZdrojUmístěníKdo ji může používat
VestavěnéZkompilováno přímo do NeboKaždý zaměstnanec
Obchod<data>/nebo/skills/<slug>/<version>/Každý zaměstnanec
PluginSložka skills/ nainstalovaného pluginuKaždý zaměstnanec
Uživatel<data>/user/skills/<name>/Každý zaměstnanec
Balíček zaměstnanceskills/ uvnitř nainstalovaného balíčku zaměstnancePouze daný zaměstnanec
Naučené<data>/learned/skills/<employee>/<name>/Pouze daný zaměstnanec

<data> je ~/Library/Application Support/Nebo v macOS, %APPDATA%\Nebo ve Windows a ~/.local/share/nebo v Linuxu. Proměnná prostředí NEBO_HOME tuto hodnotu přepíše. Když má zaměstnanec vlastní dovednost a sdílenou dovednost se stejným názvem, má přednost jeho vlastní.

Nebo tyto složky sleduje a změněnou dovednost po jedné sekundě znovu načte. Chcete-li dovednost vypnout, aniž byste ji smazali, přejmenujte její soubor na SKILL.md.disabled.

Dovednosti popisují práci, ne nástroje. Napište dovednost kolem určité odpovědnosti, například odsouhlasování účtenek, a nechte zaměstnance použít jakékoli připojení, které vlastník poskytl. Pokud dovednost opravdu potřebuje plugin, deklarujte ho v poli plugins.

Dále