NeboAI
NeboAI
Kezdés

SKILL.md referencia

Ez az oldal felsorolja egy készség minden részét, amelyet a Nebo beolvas: a fejlécmezőket, a behelyettesített változókat, az eszközöket, amelyekkel a munkatársak a készségekkel dolgoznak, és a környezetet, amelyben a szkriptek futnak.

Fájlformátum

A SKILL.md UTF-8 kódolású szöveg. Egy három kötőjelből álló sorral kezdődik, ezt követi a YAML-fejléc, majd egy záró, három kötőjelből álló sor. Minden, ami ezután jön, a törzs: Markdown-utasítások, amelyeket a munkatárs a készség betöltésekor kap meg. A Nebo a fájlt a név alapján találja meg, kis- és nagybetűtől függetlenül.

---
name: expense-review
description: Check submitted expenses against the company policy and flag anything that needs a receipt or an approval. Use when someone asks to review expenses or a reimbursement request.
version: "1.2.0"
author: Example Co
license: MIT
tags: [finance, expenses]
triggers: [reimbursement, expense report]
platform: [macos, linux, windows]
capabilities: [network]
metadata:
  allowed_domains: [api.example.com]
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
requires:
  - name: receipt-capture
    version: ">=1.0.0"
plugins:
  - name: example-ledger
    version: ">=2.0.0"
    optional: true
---

# Expense review

Follow the policy in references/policy.md ...

Fejlécmezők

Csak a name és a description kötelező. Egy hibás típusú mező az egész fájlt érvényteleníti, így a készség nem töltődik be. Az itt fel nem sorolt kulcsokat figyelmen kívül hagyja.

MezőTípusAlapértékJelentés
namestringkötelezőAzonosító. [a-z0-9-], nem kezdődhet és nem végződhet kötőjellel, nem lehet benne dupla kötőjel, legfeljebb 64 bájt. Egyezzen a mappa nevével.
descriptionstringkötelezőMit csinál a készség, és mikor kell használni. Legfeljebb 1024 bájt. Megjelenik a munkatárs készséglistájában, és a find_skills pontozza.
versionstring"1.0.0"Szemantikus verzió. Más készségek requires tartományai ellenőrzik. Tegye idézőjelbe.
triggerskarakterláncok listája[]Szavak és kifejezések, amelyek leírják, mikor alkalmazható a készség. Legfeljebb három jelenik meg a készséglistában; a find_skills mindet figyelembe veszi. Maguktól soha nem töltenek be készséget.
platformkarakterláncok listájamindmacos, linux, windows. A készség csak ott töltődik be, ahol valamelyik egyezik.
capabilitieskarakterláncok listája[]A network és a storage kibővíti a szkriptek homokozóját. Lásd: Szkripthomokozó.
metadatamap{}A secrets és az allowed_domains értékeket tartalmazza. Lásd alább.
requires{name, version} listája[]Más készségek, amelyekre ez a készség épül. A name a készség rövid neve; a version egy semver tartomány, alapértéke "*".
plugins{name, version, optional} listája[]A készség által használt bővítmények. A version alapértéke "*", az optional értéke false.
dependencieskarakterláncok listája[]Azoknak a készségeknek a rövid neve, amelyeknek jelen kell lenniük.
priorityinteger0A készségek sorrendje a kezelési listákban. Nem befolyásolja, melyik készséget választja a munkatárs.
authorstring""Megjelenítéshez tárolva.
licensestring""Megjelenítéshez tárolva.
compatibilitystring""Szabad szöveges megjegyzés, legfeljebb 500 bájt.
tagskarakterláncok listája[]Megjelenítéshez tárolva.
allowed-toolsstring""Szóközzel elválasztott karakterlánc. Tárolva; nincs kikényszerítve.

Ha a requires vagy a dependencies alatt megnevezett készség hiányzik vagy a tartományon kívül esik, illetve egy szükséges bővítmény nincs telepítve, a készség ettől még betöltődik, és korlátozottként jelölődik meg. A tulajdonos látja, mi hiányzik.

Titkos adatok

A készség szkriptjeihez szükséges hitelesítő adatokat a metadata.secrets alatt deklarálja. Az értékeket a tulajdonos adja meg, a Nebo pedig titkosítva tárolja őket az adott készséghez.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
KulcsJelentés
keyA környezeti változó neve, amelyet a szkript megkap. Kötelező.
labelA tulajdonosnak megjelenített név.
hintHonnan szerezhető be az érték.
requiredHa true, az execute nem futtatja a készség szkriptjeit, amíg az érték nincs beállítva. Alapérték: false.

Egy munkatárs a configure_skill segítségével állít be értéket. A törzsben titkos értékre ${secret.KEY} formában hivatkozhat, bár a szkripteknek inkább a környezeti változót érdemes olvasniuk.

Sablonváltozók

A Nebo ezeket a változókat a törzsben helyettesíti be, amikor egy munkatárs betölti a készséget. Más fájlokban nem helyettesíti be őket; a szkriptek ehelyett környezeti változókat olvasnak.

VáltozóÉrték
${NEBO_SKILL_DIR}A készség mappájának abszolút elérési útja.
${NEBO_DATA_DIR}A készség írható mappája: <data>/appdata/skills/<name>. Az első használatkor jön létre.
${NEBO_USER_NAME}A tulajdonos neve.
${NEBO_OS}Az operációs rendszer.
${NEBO_ARCH}A processzor architektúrája.
${plugin.SLUG_BIN}Egy deklarált bővítmény binárisának elérési útja. A slug nagybetűs, a kötőjelek helyén aláhúzással: az example-ledger ebből lesz: ${plugin.EXAMPLE_LEDGER_BIN}.
${secret.KEY}Egy deklarált titkos adat értéke.
$ARGUMENTSA use_skill eszköznek átadott args. Ha a törzsben nincs $ARGUMENTS, az argumentumok a törzs után kerülnek.

Készségeszközök

A munkatársak ezekkel az eszközökkel dolgoznak a készségekkel. A use_skill mindig elérhető; a többi akkor töltődik be, amikor egy munkatársnak szüksége van rá.

EszközParaméterekMit csinál
use_skillname, argsBetölt egy készséget. Visszaadja a behelyettesített törzset, a mappa elérési útját és az első 20 fájlnevet. Újra engedélyezi a letiltott készséget.
find_skillsqueryLegfeljebb 10 készséget ad vissza név-, indítószó- és leírásegyezés szerint rangsorolva.
read_skill_filename, pathBeolvas egy fájlt a készség mappájából. path nélkül kilistázza a fájlokat és a méretüket.
save_skillname, contentEgy teljes SKILL.md fájlt ír a felhasználói készségmappába. A piactéri készségek nem írhatók felül.
delete_skillnameTöröl egy felhasználói készséget.
install_skillcodeTelepít egy piactéri készséget a SKIL- telepítési kódjából.
configure_skillname, key, valueBeállít egy titkos adatot. key nélkül megmutatja, mire van szüksége a készségnek.
rate_skillname, rating, review1-től 5-ig értékel egy piactéri készséget.
read_skill_reviewsnameBeolvassa egy piactéri készség értékeléseit.
executeskill, script, args, timeoutSzkriptet futtat egy készség mappájából. Lásd: Szkripthomokozó.

Szkripthomokozó

Az execute eszköz egy szkriptet futtat egy készség mappájából. A futtatókörnyezetet a fájl alapján választja ki.

SzkriptFuttatókörnyezet
.pyPython, a Nebo csomagolt uv eszközén keresztül, ha van, egyébként python3.
.ts, .jsA Nebo csomagolt Bun futtatója, ha van, egyébként node.
bin/<file> vagy binaryKözvetlenül fut.
.shNem támogatott.

Minden futtatás üres környezettel és ezekkel a változókkal indul:

VáltozóÉrték
SKILL_ARGSAz args objektum JSON-ként.
Minden titkos adat key értékeA visszafejtett titkos érték.
<PLUGIN>_BINMinden deklarált bővítmény binárisának elérési útja. A bővítménymappák a PATH változóhoz is hozzáadódnak.
import json, os

args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
api_key = os.environ["EXAMPLE_API_KEY"]
print(json.dumps({"checked": len(args.get("items", []))}))

A szkript a készségmappa egy ideiglenes másolatában fut, 30 másodperces alapértelmezett időkorláttal. macOS-en és Linuxon operációsrendszer-szintű homokozóban fut:

  • Nem olvashatja a hitelesítőadat-tárolókat, a böngésző- és kulcskarikaadatokat, sem a Nebo saját beállításait és adatbázisát.
  • Csak a munkamappájába és a /tmp/nebo mappába írhat. A storage képesség hozzáadja a Nebo adatmappáját.
  • Nincs hálózati hozzáférése. A network képesség engedélyezi a csomagtárolókat és a metadata.allowed_domains alatt felsorolt tartományokat.

Fájlok és korlátok

ElemSzabály
ErőforrásokMinden fájl, kivéve a SKILL.md, manifest.json, signatures.json fájlokat és a pontfájlokat.
Futtatható fájlokA scripts/ vagy bin/ alatti fájlok, valamint egy binary nevű gyökérfájl.
Elérési utakA készségmappához viszonyítva. A .. részt tartalmazó vagy a mappából kivezető útvonalakat elutasítja.
Letiltott készségEgy mappa, amelyben SKILL.md helyett SKILL.md.disabled van.
KészséglistaMinden bejegyzés 250 karakternél le van vágva. Ha a teljes lista meghaladja a 8000 karaktert, előbb a közös készségek rövidülnek; a munkatárs saját készségei megtartják a teljes bejegyzésüket.

A piactérre közzétett fájlok korlátai a Közzététel oldalon találhatók.