NeboAI
NeboAI
Kom i gang

Ferdigheter

En ferdighet lærer en ansatt å gjøre én type arbeid godt. Du skriver den som en mappe med en SKILL.md-fil: en kort beskrivelse den ansatte bruker til å velge ferdigheten, og instruksjoner den følger når ferdigheten er lastet. Ferdigheter krever ingen kode, og alle ansatte på en bot kan bruke dem.

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.

  1. 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.
  2. Last. Den ansatte kaller verktøyet use_skill med 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å.
  3. Arbeid. Den ansatte følger instruksjonene. Den leser støttefiler med read_skill_file og kjører medfølgende skript med execute.

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.

RegelDetalj
Filen begynner med ---Frontmatter må være det første i filen. Filen må være UTF-8.
name er obligatoriskBare små bokstaver, sifre og bindestreker; ingen bindestrek først eller sist; ingen dobbel bindestrek; maks 64 byte.
description er obligatoriskMaks 1 024 byte.
Feltene har riktig typeEt felt med feil YAML-type gjør hele filen ugyldig. Sett versjoner i anførselstegn, for eksempel "1.0.0".
platform samsvarerHvis 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.

KildePlasseringHvem kan bruke den
InnebygdKompilert inn i NeboAlle ansatte
Markedsplass<data>/nebo/skills/<slug>/<version>/Alle ansatte
TilleggMappen skills/ i et installert tilleggAlle ansatte
Bruker<data>/user/skills/<name>/Alle ansatte
Ansattpakkeskills/ inne i en installert ansattpakkeBare 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