Hva en ferdighet er
En ferdighet er en mappe der navnet samsvarer med ferdighetens name. Mappen inneholder en SKILL.md-fil og eventuelt andre filer instruksjonene viser til: referansedokumenter, maler eller skript.
SKILL.md har to deler. YAML-frontmatter mellom ----linjer inneholder navnet og en beskrivelse. Markdown-innholdet etter det inneholder instruksjonene.
Slik bruker ansatte ferdigheter
En ansatt jobber med en ferdighet i tre trinn.
- Velg. Hver tur ser den ansatte en liste over ferdighetene den har tilgang til: hver ferdighets navn, beskrivelse og opptil tre av utløserne. Beskrivelsen er det den ansatte leser for å bestemme seg, så skriv den slik at den sier hva ferdigheten gjør og når den skal brukes.
- Last. Den ansatte kaller verktøyet
use_skillmed navnet på ferdigheten. Verktøyet returnerer instruksjonene, stien til ferdighetens mappe og navnene på filene. Dette er den eneste måten en ansatt leser en ferdighet på. - Arbeid. Den ansatte følger instruksjonene. Den leser støttefiler med
read_skill_fileog kjører medfølgende skript medexecute.
Utløsere laster aldri en ferdighet på egen hånd. Det er alltid den ansatte som velger. Når listen blir lang, kan den ansatte søke i den med find_skills.
Skriv din første ferdighet
Opprett en mappe oppkalt etter ferdigheten, med én fil i.
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".
Legg mappen i brukermappen for ferdigheter på en bot (se Hvor ferdigheter ligger). Nebo oppdager den nye mappen i løpet av omtrent ett sekund, og alle ansatte på den boten kan bruke ferdigheten.
En ansatt kan også skrive en ferdighet for deg. Be den lagre en, så kaller den save_skill, som skriver mappen inn i den samme brukermappen for ferdigheter.
Regler lasteren håndhever
En ferdighet som bryter en av disse reglene, lastes ikke. Nebo logger en advarsel og hopper over den.
| Regel | Detalj |
|---|---|
Filen begynner med --- | Frontmatter må være det første i filen. Filen må være UTF-8. |
name er obligatorisk | Bare små bokstaver, sifre og bindestreker; ingen bindestrek først eller sist; ingen dobbel bindestrek; maks 64 byte. |
description er obligatorisk | Maks 1 024 byte. |
| Feltene har riktig type | Et felt med feil YAML-type gjør hele filen ugyldig. Sett versjoner i anførselstegn, for eksempel "1.0.0". |
platform samsvarer | Hvis det finnes, lastes ferdigheten bare på de oppførte operativsystemene. |
Frontmatter-nøkler Nebo ikke kjenner igjen, ignoreres. Innholdet har ingen størrelsesgrense, men kortere instruksjoner gir mer plass til arbeidet. Flytt langt materiale over i filer den ansatte leser når den trenger dem.
Legg til filer
Alle filer i mappen unntatt SKILL.md og punktumfiler er tilgjengelige for den ansatte. Mappenavnene velger du selv; Nebo gir ingen spesiell betydning til references/ eller assets/. Filer under scripts/ eller bin/ kan kjøres.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Vis til filer med stien deres inne i mappen, for eksempel references/policy.md. Den ansatte leser dem med read_skill_file, som avviser enhver sti som går ut av mappen. Skript kjøres med verktøyet execute i en sandkasse. SKILL.md-referansen dekker kjøretidsmiljøer, miljøvariabler, hemmeligheter og nettverkstilgang.
Hvor ferdigheter ligger
En bot samler ferdigheter fra flere steder. Når to kilder har en ferdighet med samme navn, vinner den kilden som står senere i denne listen.
| Kilde | Plassering | Hvem kan bruke den |
|---|---|---|
| Innebygd | Kompilert inn i Nebo | Alle ansatte |
| Markedsplass | <data>/nebo/skills/<slug>/<version>/ | Alle ansatte |
| Tillegg | Mappen skills/ i et installert tillegg | Alle ansatte |
| Bruker | <data>/user/skills/<name>/ | Alle ansatte |
| Ansattpakke | skills/ inne i en installert ansattpakke | Bare den ansatte |
| Lært | <data>/learned/skills/<employee>/<name>/ | Bare den ansatte |
<data> er ~/Library/Application Support/Nebo på macOS, %APPDATA%\Nebo på Windows og ~/.local/share/nebo på Linux. Miljøvariabelen NEBO_HOME overstyrer den. Når en ansatt har en egen ferdighet og en delt ferdighet med samme navn, vinner dens egen ferdighet.
Nebo overvåker disse mappene og laster en endret ferdighet på nytt etter ett sekund. For å slå av en ferdighet uten å slette den gir du filen nytt navn til SKILL.md.disabled.
Ferdigheter beskriver arbeid, ikke verktøy. Skriv en ferdighet rundt et ansvarsområde, for eksempel avstemming av kvitteringer, og la den ansatte bruke den tilkoblingen eieren har gitt. Når en ferdighet virkelig trenger et tillegg, oppgir du det med feltet plugins.
Neste
- SKILL.md-referanse: hvert felt, verktøy og hver variabel.
- Eksempler: komplette ferdigheter du kan kopiere.
- Publisering: legg en ferdighet ut på markedsplassen.