NeboAI
NeboAI
शुरू करें

स्किल

स्किल किसी कर्मचारी को एक तरह का काम अच्छे से करना सिखाती है। आप इसे SKILL.md फ़ाइल वाले फ़ोल्डर के रूप में लिखते हैं: एक छोटा विवरण, जिससे कर्मचारी स्किल चुनता है, और निर्देश, जिनका वह स्किल लोड होने के बाद पालन करता है। स्किल के लिए किसी कोड की ज़रूरत नहीं होती, और बॉट पर हर कर्मचारी उनका इस्तेमाल कर सकता है।

स्किल क्या है

स्किल एक फ़ोल्डर है जिसका नाम स्किल के name से मेल खाता है। फ़ोल्डर में एक SKILL.md फ़ाइल होती है और, चाहें तो, वे अन्य फ़ाइलें जिनका निर्देशों में ज़िक्र है: संदर्भ दस्तावेज़, टेम्पलेट या स्क्रिप्ट।

SKILL.md के दो हिस्से होते हैं। --- लाइनों के बीच YAML फ़्रंटमैटर में नाम और विवरण होता है। उसके बाद Markdown बॉडी में निर्देश होते हैं।

कर्मचारी स्किल का इस्तेमाल कैसे करते हैं

कर्मचारी तीन चरणों में स्किल के साथ काम करता है।

  1. चुनें। हर टर्न में कर्मचारी को उपलब्ध स्किल की सूची दिखती है: हर स्किल का नाम, उसका विवरण, और उसके अधिकतम तीन ट्रिगर। कर्मचारी विवरण पढ़कर ही फ़ैसला करता है, इसलिए उसमें लिखें कि स्किल क्या करती है और उसे कब इस्तेमाल करें।
  2. लोड करें। कर्मचारी स्किल के नाम के साथ use_skill टूल कॉल करता है। टूल निर्देश, स्किल के फ़ोल्डर का पाथ और उसकी फ़ाइलों के नाम लौटाता है। कर्मचारी के लिए स्किल पढ़ने का यही एक तरीका है।
  3. काम करें। कर्मचारी निर्देशों का पालन करता है। वह सहायक फ़ाइलें 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 फ़ील्ड से घोषित करें।

आगे