स्किल क्या है
स्किल एक फ़ोल्डर है जिसका नाम स्किल के name से मेल खाता है। फ़ोल्डर में एक SKILL.md फ़ाइल होती है और, चाहें तो, वे अन्य फ़ाइलें जिनका निर्देशों में ज़िक्र है: संदर्भ दस्तावेज़, टेम्पलेट या स्क्रिप्ट।
SKILL.md के दो हिस्से होते हैं। --- लाइनों के बीच YAML फ़्रंटमैटर में नाम और विवरण होता है। उसके बाद Markdown बॉडी में निर्देश होते हैं।
कर्मचारी स्किल का इस्तेमाल कैसे करते हैं
कर्मचारी तीन चरणों में स्किल के साथ काम करता है।
- चुनें। हर टर्न में कर्मचारी को उपलब्ध स्किल की सूची दिखती है: हर स्किल का नाम, उसका विवरण, और उसके अधिकतम तीन ट्रिगर। कर्मचारी विवरण पढ़कर ही फ़ैसला करता है, इसलिए उसमें लिखें कि स्किल क्या करती है और उसे कब इस्तेमाल करें।
- लोड करें। कर्मचारी स्किल के नाम के साथ
use_skillटूल कॉल करता है। टूल निर्देश, स्किल के फ़ोल्डर का पाथ और उसकी फ़ाइलों के नाम लौटाता है। कर्मचारी के लिए स्किल पढ़ने का यही एक तरीका है। - काम करें। कर्मचारी निर्देशों का पालन करता है। वह सहायक फ़ाइलें
read_skill_fileसे पढ़ता है और बंडल की गई स्क्रिप्टexecuteसे चलाता है।
ट्रिगर कभी अपने आप स्किल लोड नहीं करते। चुनाव हमेशा कर्मचारी करता है। जब सूची लंबी हो जाए, तो कर्मचारी find_skills से उसमें खोज सकता है।
अपनी पहली स्किल लिखें
स्किल के नाम का एक फ़ोल्डर बनाएँ, जिसमें एक फ़ाइल हो।
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".
फ़ोल्डर को किसी बॉट की यूज़र स्किल डायरेक्टरी में रखें (स्किल कहाँ रहती हैं देखें)। Nebo लगभग एक सेकंड में नया फ़ोल्डर पहचान लेता है, और उस बॉट पर हर कर्मचारी स्किल इस्तेमाल कर सकता है।
कोई कर्मचारी भी आपके लिए स्किल लिख सकता है। उससे एक सहेजने को कहें, और वह save_skill कॉल करता है, जो फ़ोल्डर को उसी यूज़र स्किल डायरेक्टरी में लिख देता है।
लोडर द्वारा लागू किए जाने वाले नियम
इनमें से कोई नियम तोड़ने वाली स्किल लोड नहीं होती। Nebo एक चेतावनी लॉग करता है और उसे छोड़ देता है।
| नियम | विवरण |
|---|---|
फ़ाइल --- से शुरू होती है | फ़्रंटमैटर फ़ाइल में सबसे पहले होना चाहिए। फ़ाइल UTF-8 में होनी चाहिए। |
name ज़रूरी है | केवल छोटे अक्षर, अंक और हाइफ़न; शुरुआत या अंत में हाइफ़न नहीं; दोहरा हाइफ़न नहीं; अधिकतम 64 बाइट। |
description ज़रूरी है | अधिकतम 1,024 बाइट। |
| फ़ील्ड का प्रकार सही है | गलत YAML प्रकार वाला एक फ़ील्ड पूरी फ़ाइल को विफल कर देता है। वर्ज़न को उद्धरण चिह्नों में लिखें, जैसे "1.0.0"। |
platform मेल खाता है | मौजूद होने पर स्किल केवल सूचीबद्ध ऑपरेटिंग सिस्टम पर लोड होती है। |
जिन फ़्रंटमैटर कुंजियों को Nebo नहीं पहचानता, उन्हें अनदेखा किया जाता है। बॉडी की कोई साइज़ सीमा नहीं है, लेकिन छोटे निर्देश काम के लिए ज़्यादा जगह छोड़ते हैं। लंबी सामग्री को उन फ़ाइलों में रखें जिन्हें कर्मचारी ज़रूरत पड़ने पर पढ़ता है।
फ़ाइलें जोड़ें
फ़ोल्डर में SKILL.md और डॉटफ़ाइलों के अलावा हर फ़ाइल कर्मचारी के लिए उपलब्ध है। फ़ोल्डर के नाम आप चुनें; Nebo references/ या assets/ को कोई खास अर्थ नहीं देता। scripts/ या bin/ के अंदर की फ़ाइलें चलाई जा सकती हैं।
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute फ़ाइलों का ज़िक्र फ़ोल्डर के अंदर उनके पाथ से करें, जैसे references/policy.md। कर्मचारी उन्हें read_skill_file से पढ़ता है, जो फ़ोल्डर से बाहर जाने वाले किसी भी पाथ को अस्वीकार कर देता है। स्क्रिप्ट execute टूल से सैंडबॉक्स में चलती हैं। SKILL.md संदर्भ में रनटाइम, एनवायरनमेंट वेरिएबल, सीक्रेट और नेटवर्क एक्सेस के बारे में बताया गया है।
स्किल कहाँ रहती हैं
एक बॉट कई जगहों से स्किल इकट्ठा करता है। जब दो स्रोत एक ही नाम की स्किल देते हैं, तो इस सूची में बाद में आने वाला स्रोत मान्य होता है।
| स्रोत | स्थान | कौन इस्तेमाल कर सकता है |
|---|---|---|
| बिल्ट-इन | Nebo में कंपाइल की हुई | हर कर्मचारी |
| मार्केटप्लेस | <data>/nebo/skills/<slug>/<version>/ | हर कर्मचारी |
| प्लगइन | इंस्टॉल किए गए प्लगइन का skills/ फ़ोल्डर | हर कर्मचारी |
| यूज़र | <data>/user/skills/<name>/ | हर कर्मचारी |
| कर्मचारी पैकेज | इंस्टॉल किए गए कर्मचारी पैकेज के अंदर skills/ | केवल वही कर्मचारी |
| सीखी हुई | <data>/learned/skills/<employee>/<name>/ | केवल वही कर्मचारी |
<data> macOS पर ~/Library/Application Support/Nebo, Windows पर %APPDATA%\Nebo और Linux पर ~/.local/share/nebo है। NEBO_HOME एनवायरनमेंट वेरिएबल इसकी जगह ले लेता है। जब किसी कर्मचारी के पास अपनी एक स्किल और उसी नाम की एक साझा स्किल हो, तो उसकी अपनी स्किल मान्य होती है।
Nebo इन फ़ोल्डरों पर नज़र रखता है और बदली हुई स्किल को एक सेकंड बाद फिर से लोड करता है। किसी स्किल को हटाए बिना बंद करने के लिए उसकी फ़ाइल का नाम बदलकर SKILL.md.disabled कर दें।
स्किल काम का वर्णन करती हैं, टूल का नहीं। स्किल किसी ज़िम्मेदारी के इर्द-गिर्द लिखें, जैसे रसीदों का मिलान, और कर्मचारी को वह कनेक्शन इस्तेमाल करने दें जो मालिक ने दिया है। जब किसी स्किल को सच में किसी प्लगइन की ज़रूरत हो, तो उसे plugins फ़ील्ड से घोषित करें।
आगे
- SKILL.md संदर्भ: हर फ़ील्ड, टूल और वेरिएबल।
- उदाहरण: कॉपी करने के लिए पूरी स्किल।
- प्रकाशन: स्किल को मार्केटप्लेस पर डालें।