NeboAI
NeboAI
Începe

Abilități

O abilitate îl învață pe un angajat să facă bine un anumit tip de muncă. O scrii ca un folder cu un fișier SKILL.md: o descriere scurtă pe care angajatul o folosește ca să aleagă abilitatea și instrucțiunile pe care le urmează după ce abilitatea este încărcată. Abilitățile nu necesită cod și fiecare angajat de pe un bot le poate folosi.

Ce este o abilitate

O abilitate este un folder al cărui nume corespunde cu name al abilității. Folderul conține un fișier SKILL.md și, opțional, orice alte fișiere la care se referă instrucțiunile: documente de referință, șabloane sau scripturi.

SKILL.md are două părți. Frontmatterul YAML dintre liniile --- conține numele și o descriere. Corpul Markdown de după el conține instrucțiunile.

Cum folosesc angajații abilitățile

Un angajat lucrează cu o abilitate în trei pași.

  1. Alege. La fiecare tură, angajatul vede o listă cu abilitățile disponibile: numele fiecărei abilități, descrierea ei și până la trei dintre declanșatoarele ei. Descrierea este ceea ce citește angajatul ca să decidă, așa că scrie-o astfel încât să spună ce face abilitatea și când se folosește.
  2. Încarcă. Angajatul apelează instrumentul use_skill cu numele abilității. Instrumentul returnează instrucțiunile, calea folderului abilității și numele fișierelor ei. Acesta este singurul mod în care un angajat citește o abilitate.
  3. Lucrează. Angajatul urmează instrucțiunile. Citește fișierele auxiliare cu read_skill_file și rulează scripturile incluse cu execute.

Declanșatoarele nu încarcă niciodată singure o abilitate. Angajatul face întotdeauna alegerea. Când lista devine lungă, angajatul o poate căuta cu find_skills.

Scrie-ți prima abilitate

Creează un folder numit după abilitate, cu un singur fișier în el.

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

Pune folderul în directorul de abilități al utilizatorului de pe un bot (vezi Unde se află abilitățile). Nebo observă folderul nou în aproximativ o secundă și fiecare angajat de pe acel bot poate folosi abilitatea.

Un angajat poate scrie și el o abilitate pentru tine. Cere-i să salveze una și va apela save_skill, care scrie folderul în același director de abilități al utilizatorului.

Reguli impuse de încărcător

O abilitate care încalcă una dintre aceste reguli nu se încarcă. Nebo înregistrează un avertisment și o sare.

RegulăDetaliu
Fișierul începe cu ---Frontmatterul trebuie să fie primul lucru din fișier. Fișierul trebuie să fie UTF-8.
name este obligatoriuDoar litere mici, cifre și cratime; fără cratimă la început sau la sfârșit; fără cratimă dublă; cel mult 64 de octeți.
description este obligatoriuCel mult 1.024 de octeți.
Câmpurile au tipul corectUn câmp cu tipul YAML greșit invalidează întregul fișier. Pune versiunile între ghilimele, de exemplu "1.0.0".
platform se potriveșteDacă există, abilitatea se încarcă doar pe sistemele de operare listate.

Cheile de frontmatter pe care Nebo nu le recunoaște sunt ignorate. Corpul nu are limită de dimensiune, dar instrucțiunile mai scurte lasă mai mult loc pentru muncă. Mută materialele lungi în fișiere pe care angajatul le citește când are nevoie de ele.

Adaugă fișiere

Orice fișier din folder, în afară de SKILL.md și de fișierele care încep cu punct, este disponibil pentru angajat. Numele folderelor le alegi tu; Nebo nu dă un sens special lui references/ sau assets/. Fișierele din scripts/ sau bin/ pot fi rulate.

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

Referă-te la fișiere prin calea lor din folder, de exemplu references/policy.md. Angajatul le citește cu read_skill_file, care respinge orice cale ce iese din folder. Scripturile rulează cu instrumentul execute într-un sandbox. Referința SKILL.md acoperă mediile de rulare, variabilele de mediu, secretele și accesul la rețea.

Unde se află abilitățile

Un bot adună abilități din mai multe locuri. Când două surse oferă o abilitate cu același nume, sursa care apare mai târziu în această listă are prioritate.

SursăLocațieCine o poate folosi
IntegratăCompilată în NeboToți angajații
Magazin<data>/nebo/skills/<slug>/<version>/Toți angajații
PluginFolderul skills/ al unui plugin instalatToți angajații
Utilizator<data>/user/skills/<name>/Toți angajații
Pachet de angajatskills/ din interiorul unui pachet de angajat instalatDoar acel angajat
Învățată<data>/learned/skills/<employee>/<name>/Doar acel angajat

<data> este ~/Library/Application Support/Nebo pe macOS, %APPDATA%\Nebo pe Windows și ~/.local/share/nebo pe Linux. Variabila de mediu NEBO_HOME îl înlocuiește. Când un angajat are o abilitate proprie și o abilitate comună cu același nume, abilitatea proprie are prioritate.

Nebo urmărește aceste foldere și reîncarcă o abilitate modificată după o secundă. Ca să dezactivezi o abilitate fără să o ștergi, redenumește-i fișierul în SKILL.md.disabled.

Abilitățile descriu munca, nu instrumentele. Scrie o abilitate în jurul unei responsabilități, de exemplu reconcilierea chitanțelor, și lasă angajatul să folosească orice conexiune i-a oferit proprietarul. Când o abilitate chiar are nevoie de un plugin, declară-l cu câmpul plugins.

Mai departe