NeboAI
NeboAI
Magsimula

Mga Skill

Tinuturuan ng skill ang isang empleyado kung paano gawin nang mahusay ang isang uri ng trabaho. Isinusulat mo ito bilang folder na may SKILL.md file: isang maikling description na ginagamit ng empleyado para piliin ang skill, at mga instruction na sinusunod nito kapag na-load na ang skill. Walang code na kailangan ang mga skill, at magagamit ito ng bawat empleyado sa isang bot.

Ano ang skill

Ang skill ay isang folder na tugma ang pangalan sa name ng skill. Laman ng folder ang isang SKILL.md file at, kung gusto, anumang ibang file na tinutukoy ng mga instruction: mga reference na dokumento, template, o script.

May dalawang bahagi ang SKILL.md. Ang YAML frontmatter sa pagitan ng mga linyang --- ang nagdadala ng pangalan at description. Ang Markdown body pagkatapos nito ang nagdadala ng mga instruction.

Paano ginagamit ng mga empleyado ang mga skill

Tatlong hakbang ang pagtatrabaho ng empleyado gamit ang isang skill.

  1. Pumili. Sa bawat turn, nakikita ng empleyado ang listahan ng mga skill na available dito: ang pangalan ng bawat skill, ang description nito, at hanggang tatlo sa mga trigger nito. Ang description ang binabasa ng empleyado para magpasya, kaya isulat ito para sabihin kung ano ang ginagawa ng skill at kailan ito gagamitin.
  2. I-load. Tinatawag ng empleyado ang tool na use_skill gamit ang pangalan ng skill. Ibinabalik ng tool ang mga instruction, ang path ng folder ng skill, at ang mga pangalan ng mga file nito. Ito lang ang paraan para mabasa ng empleyado ang isang skill.
  3. Magtrabaho. Sinusunod ng empleyado ang mga instruction. Binabasa nito ang mga sumusuportang file gamit ang read_skill_file at pinapatakbo ang mga kasamang script gamit ang execute.

Hindi kailanman nilo-load ng mga trigger ang skill nang mag-isa. Laging ang empleyado ang pumipili. Kapag humaba ang listahan, puwede itong hanapin ng empleyado gamit ang find_skills.

Isulat ang una mong skill

Gumawa ng folder na pinangalanan ayon sa skill, na may isang file sa loob.

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

Ilagay ang folder sa user skills directory ng isang bot (tingnan ang Kung saan nakalagay ang mga skill). Napapansin ng Nebo ang bagong folder sa loob ng mga isang segundo, at magagamit ng bawat empleyado sa bot na iyon ang skill.

Puwede ka ring sulatan ng empleyado ng skill. Sabihan itong mag-save ng isa, at tatawagin nito ang save_skill, na isinusulat ang folder sa parehong user skills directory.

Mga patakarang ipinapatupad ng loader

Hindi nilo-load ang skill na lumalabag sa isa sa mga patakarang ito. Nagla-log ng babala ang Nebo at nilalaktawan ito.

PatakaranDetalye
Nagsisimula ang file sa ---Ang frontmatter ang dapat na unang laman ng file. Dapat UTF-8 ang file.
Kailangan ang nameMaliliit na titik, numero at gitling lang; walang gitling sa simula o dulo; walang magkasunod na gitling; hanggang 64 bytes.
Kailangan ang descriptionHanggang 1,024 bytes.
Tama ang uri ng mga fieldAng field na mali ang YAML type ay nagpapapalya sa buong file. Lagyan ng quote ang mga version, gaya ng "1.0.0".
Tumutugma ang platformKapag naroon, nilo-load lang ang skill sa mga nakalistang operating system.

Binabalewala ang mga frontmatter key na hindi kilala ng Nebo. Walang limit sa laki ang body, pero mas maraming puwang para sa trabaho kapag mas maikli ang mga instruction. Ilipat ang mahahabang materyal sa mga file na binabasa ng empleyado kapag kailangan nito.

Magdagdag ng mga file

Available sa empleyado ang anumang file sa folder maliban sa SKILL.md at mga dotfile. Ikaw ang bahala sa mga pangalan ng folder; walang espesyal na kahulugan para sa Nebo ang references/ o assets/. Mapapatakbo ang mga file sa ilalim ng scripts/ o bin/.

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

Tukuyin ang mga file ayon sa path nila sa loob ng folder, gaya ng references/policy.md. Binabasa ito ng empleyado gamit ang read_skill_file, na tinatanggihan ang anumang path na lumalabas sa folder. Tumatakbo ang mga script gamit ang tool na execute sa isang sandbox. Tinatalakay ng SKILL.md reference ang mga runtime, environment variable, secret at network access.

Kung saan nakalagay ang mga skill

Nangongolekta ang isang bot ng mga skill mula sa ilang lugar. Kapag dalawang pinagmulan ang nagbibigay ng skill na may parehong pangalan, nananaig ang mas huli sa listahang ito.

PinagmulanLokasyonSino ang makakagamit
Built inNaka-compile sa loob ng NeboBawat empleyado
Marketplace<data>/nebo/skills/<slug>/<version>/Bawat empleyado
PluginAng folder na skills/ ng naka-install na pluginBawat empleyado
User<data>/user/skills/<name>/Bawat empleyado
Package ng empleyadoskills/ sa loob ng naka-install na package ng empleyadoAng empleyadong iyon lang
Natutunan<data>/learned/skills/<employee>/<name>/Ang empleyadong iyon lang

Ang <data> ay ~/Library/Application Support/Nebo sa macOS, %APPDATA%\Nebo sa Windows, at ~/.local/share/nebo sa Linux. Nangingibabaw dito ang environment variable na NEBO_HOME. Kapag may sariling skill ang isang empleyado at may shared na skill na may parehong pangalan, nananaig ang sarili nitong skill.

Binabantayan ng Nebo ang mga folder na ito at nire-reload ang binagong skill pagkalipas ng isang segundo. Para i-off ang skill nang hindi ito binubura, palitan ang pangalan ng file nito ng SKILL.md.disabled.

Inilalarawan ng mga skill ang trabaho, hindi ang mga tool. Isulat ang skill tungkol sa isang responsibilidad, gaya ng pag-reconcile ng mga resibo, at hayaang gamitin ng empleyado ang kahit anong koneksyong ibinigay ng may-ari. Kapag talagang kailangan ng skill ang isang plugin, ideklara ito gamit ang field na plugins.

Susunod