NeboAI
NeboAI
Začať

Zručnosti

Zručnosť učí zamestnanca robiť jeden druh práce dobre. Napíšete ju ako priečinok so súborom SKILL.md: krátky popis, podľa ktorého si zamestnanec zručnosť vyberie, a pokyny, ktorými sa po jej načítaní riadi. Zručnosti nepotrebujú žiadny kód a môže ich používať každý zamestnanec na botovi.

Čo je zručnosť

Zručnosť je priečinok, ktorého názov zodpovedá poľu name zručnosti. Priečinok obsahuje súbor SKILL.md a voliteľne ďalšie súbory, na ktoré sa pokyny odvolávajú: referenčné dokumenty, šablóny alebo skripty.

SKILL.md má dve časti. Úvodná časť YAML medzi riadkami --- nesie názov a popis. Telo v Markdowne za ňou nesie pokyny.

Ako zamestnanci používajú zručnosti

Zamestnanec pracuje so zručnosťou v troch krokoch.

  1. Výber. V každom ťahu zamestnanec vidí zoznam zručností, ktoré má k dispozícii: názov každej zručnosti, jej popis a až tri jej spúšťače. Podľa popisu sa zamestnanec rozhoduje, preto v ňom napíšte, čo zručnosť robí a kedy ju použiť.
  2. Načítanie. Zamestnanec zavolá nástroj use_skill s názvom zručnosti. Nástroj vráti pokyny, cestu k priečinku zručnosti a názvy jej súborov. Je to jediný spôsob, akým zamestnanec zručnosť číta.
  3. Práca. Zamestnanec postupuje podľa pokynov. Podporné súbory číta pomocou read_skill_file a pribalené skripty spúšťa pomocou execute.

Spúšťače nikdy nenačítajú zručnosť samy. Rozhodnutie vždy urobí zamestnanec. Keď sa zoznam predĺži, zamestnanec v ňom môže hľadať pomocou find_skills.

Napíšte svoju prvú zručnosť

Vytvorte priečinok pomenovaný podľa zručnosti a vložte doň jeden súbor.

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

Priečinok vložte do adresára používateľských zručností bota (pozrite Kde sú zručnosti uložené). Nebo nový priečinok zaznamená zhruba do sekundy a zručnosť potom môže používať každý zamestnanec na tomto botovi.

Zručnosť vám môže napísať aj zamestnanec. Požiadajte ho, nech ju uloží, a on zavolá save_skill, ktorý zapíše priečinok do toho istého adresára používateľských zručností.

Pravidlá, ktoré zavádzač vynucuje

Zručnosť, ktorá poruší niektoré z týchto pravidiel, sa nenačíta. Nebo zapíše do protokolu varovanie a preskočí ju.

PravidloPodrobnosti
Súbor začína ---Úvodná časť musí byť na samom začiatku súboru. Súbor musí byť v kódovaní UTF-8.
name je povinnéIba malé písmená, číslice a spojovníky; bez spojovníka na začiatku alebo na konci; bez zdvojeného spojovníka; najviac 64 bajtov.
description je povinnéNajviac 1 024 bajtov.
Polia majú správny typPole s nesprávnym typom YAML znehodnotí celý súbor. Verzie dávajte do úvodzoviek, napríklad "1.0.0".
platform sa zhodujeAk je uvedené, zručnosť sa načíta iba v uvedených operačných systémoch.

Kľúče úvodnej časti, ktoré Nebo nepozná, sa ignorujú. Veľkosť tela nie je obmedzená, no kratšie pokyny nechajú viac priestoru na prácu. Dlhší materiál presuňte do súborov, ktoré si zamestnanec prečíta, keď ich potrebuje.

Pridanie súborov

Každý súbor v priečinku okrem SKILL.md a súborov začínajúcich bodkou je zamestnancovi dostupný. Názvy priečinkov si vyberáte sami; Nebo nepripisuje references/ ani assets/ žiadny osobitný význam. Súbory v scripts/ alebo bin/ sa dajú spúšťať.

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

Na súbory odkazujte cestou v rámci priečinka, napríklad references/policy.md. Zamestnanec ich číta pomocou read_skill_file, ktorý odmietne každú cestu mimo priečinka. Skripty sa spúšťajú nástrojom execute v izolovanom prostredí. Referencia k SKILL.md opisuje prostredia behu, premenné prostredia, tajné údaje a prístup k sieti.

Kde sú zručnosti uložené

Bot zbiera zručnosti z viacerých miest. Keď dva zdroje poskytujú zručnosť s rovnakým názvom, vyhrá zdroj, ktorý je v tomto zozname neskôr.

ZdrojUmiestnenieKto ju môže používať
VstavanéZabudované priamo v NeboKaždý zamestnanec
Obchod<data>/nebo/skills/<slug>/<version>/Každý zamestnanec
DoplnokPriečinok skills/ nainštalovaného doplnkuKaždý zamestnanec
Používateľ<data>/user/skills/<name>/Každý zamestnanec
Balík zamestnancaskills/ v nainštalovanom balíku zamestnancaIba tento zamestnanec
Naučené<data>/learned/skills/<employee>/<name>/Iba tento zamestnanec

<data> je ~/Library/Application Support/Nebo v macOS, %APPDATA%\Nebo vo Windows a ~/.local/share/nebo v Linuxe. Premenná prostredia NEBO_HOME túto cestu prepíše. Keď má zamestnanec vlastnú zručnosť a zdieľanú zručnosť s rovnakým názvom, vyhrá jeho vlastná.

Nebo tieto priečinky sleduje a zmenenú zručnosť znova načíta po jednej sekunde. Ak chcete zručnosť vypnúť bez odstránenia, premenujte jej súbor na SKILL.md.disabled.

Zručnosti opisujú prácu, nie nástroje. Zručnosť postavte na zodpovednosti, napríklad na odsúhlasovaní účteniek, a nechajte zamestnanca použiť akékoľvek pripojenie, ktoré vlastník poskytol. Keď zručnosť naozaj potrebuje doplnok, deklarujte ho v poli plugins.

Ďalej