NeboAI
NeboAI
Kom igång

Färdigheter

En färdighet lär en medarbetare att göra en sorts arbete bra. Du skriver den som en mapp med en SKILL.md-fil: en kort beskrivning som medarbetaren använder för att välja färdigheten, och instruktioner som den följer när färdigheten är laddad. Färdigheter kräver ingen kod, och alla medarbetare på en bot kan använda dem.

Vad en färdighet är

En färdighet är en mapp vars namn matchar färdighetens name. Mappen innehåller en SKILL.md-fil och, om du vill, andra filer som instruktionerna hänvisar till: referensdokument, mallar eller skript.

SKILL.md har två delar. YAML-frontmatter mellan ----rader innehåller namnet och en beskrivning. Markdown-innehållet efter den innehåller instruktionerna.

Så använder medarbetare färdigheter

En medarbetare arbetar med en färdighet i tre steg.

  1. Välj. Vid varje tur ser medarbetaren en lista över de färdigheter som är tillgängliga för den: varje färdighets namn, dess beskrivning och upp till tre av dess utlösare. Beskrivningen är det medarbetaren läser för att bestämma sig, så skriv den så att den säger vad färdigheten gör och när den ska användas.
  2. Ladda. Medarbetaren anropar verktyget use_skill med färdighetens namn. Verktyget returnerar instruktionerna, sökvägen till färdighetens mapp och namnen på dess filer. Det är det enda sättet en medarbetare läser en färdighet på.
  3. Arbeta. Medarbetaren följer instruktionerna. Den läser stödfiler med read_skill_file och kör medföljande skript med execute.

Utlösare laddar aldrig en färdighet på egen hand. Det är alltid medarbetaren som väljer. När listan blir lång kan medarbetaren söka i den med find_skills.

Skriv din första färdighet

Skapa en mapp med färdighetens namn och en fil i den.

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

Lägg mappen i en bots användarkatalog för färdigheter (se Var färdigheter finns). Nebo märker den nya mappen inom ungefär en sekund, och alla medarbetare på den boten kan använda färdigheten.

En medarbetare kan också skriva en färdighet åt dig. Be den spara en, så anropar den save_skill, som skriver mappen till samma användarkatalog för färdigheter.

Regler som laddaren tillämpar

En färdighet som bryter mot någon av de här reglerna laddas inte. Nebo loggar en varning och hoppar över den.

RegelDetalj
Filen börjar med ---Frontmatter måste stå först i filen. Filen måste vara UTF-8.
name är obligatorisktEndast gemener, siffror och bindestreck; inget inledande eller avslutande bindestreck; inget dubbelt bindestreck; högst 64 byte.
description är obligatorisktHögst 1 024 byte.
Fälten har rätt typEtt fält med fel YAML-typ gör hela filen ogiltig. Sätt citattecken kring versioner, till exempel "1.0.0".
platform matcharOm fältet finns laddas färdigheten bara på de listade operativsystemen.

Frontmatter-nycklar som Nebo inte känner igen ignoreras. Innehållet har ingen storleksgräns, men kortare instruktioner lämnar mer utrymme för arbetet. Flytta långt material till filer som medarbetaren läser när den behöver dem.

Lägg till filer

Alla filer i mappen utom SKILL.md och punktfiler är tillgängliga för medarbetaren. Mappnamnen väljer du själv; Nebo ger ingen särskild betydelse åt references/ eller assets/. Filer under scripts/ eller bin/ kan köras.

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

Hänvisa till filer med deras sökväg i mappen, till exempel references/policy.md. Medarbetaren läser dem med read_skill_file, som avvisar alla sökvägar som lämnar mappen. Skript körs med verktyget execute i en sandlåda. SKILL.md-referensen beskriver körmiljöer, miljövariabler, hemligheter och nätverksåtkomst.

Var färdigheter finns

En bot samlar färdigheter från flera ställen. När två källor tillhandahåller en färdighet med samma namn vinner den källa som står senare i listan.

KällaPlatsVem som kan använda den
InbyggdInkompilerad i NeboAlla medarbetare
Marknadsplats<data>/nebo/skills/<slug>/<version>/Alla medarbetare
PluginMappen skills/ i ett installerat pluginAlla medarbetare
Användare<data>/user/skills/<name>/Alla medarbetare
Medarbetarpaketskills/ i ett installerat medarbetarpaketBara den medarbetaren
Inlärd<data>/learned/skills/<employee>/<name>/Bara den medarbetaren

<data> är ~/Library/Application Support/Nebo på macOS, %APPDATA%\Nebo på Windows och ~/.local/share/nebo på Linux. Miljövariabeln NEBO_HOME åsidosätter den. När en medarbetare har en egen färdighet och en delad färdighet med samma namn vinner den egna färdigheten.

Nebo bevakar de här mapparna och laddar om en ändrad färdighet efter en sekund. För att stänga av en färdighet utan att radera den byter du namn på dess fil till SKILL.md.disabled.

Färdigheter beskriver arbete, inte verktyg. Skriv en färdighet kring ett ansvarsområde, till exempel att stämma av kvitton, och låt medarbetaren använda den anslutning som ägaren har gett den. När en färdighet verkligen behöver ett plugin anger du det med fältet plugins.

Nästa steg