पैकेज
support-coordinator/
├── AGENT.md # required: who the employee is and how it works
├── agent.json # optional: capabilities, inputs, workflows, memory
└── skills/ # optional: skills only this employee uses
└── reply-drafting/
└── SKILL.md | फ़ाइल | ज़रूरी | उद्देश्य |
|---|---|---|
AGENT.md | हाँ | व्यक्तित्व: कर्मचारी कौन है, कैसे काम करता है, और उसके नियम। व्यक्तित्व और मेमोरी देखें। |
agent.json | नहीं | इसे जिन क्षमताओं की ज़रूरत है, मालिक के लिए सवाल, वर्कफ़्लो, मेमोरी सेटिंग्स और मंज़ूरी की सीमाएँ। agent.json संदर्भ देखें। |
skills/ | नहीं | स्टैंडर्ड SKILL.md फ़ॉर्मेट में स्किल। इन्हें सिर्फ़ यही कर्मचारी देखता है। |
manifest.json | सिर्फ़ ऐप्स | "type": "app" के साथ पहचान। जब मार्केटप्लेस किसी कर्मचारी को पैकेज करता है, तो वह अपना मैनिफ़ेस्ट खुद लिखता है। |
ui/ | सिर्फ़ ऐप्स | ऐप का पेज। ऐप्स देखें। |
पैकेज लिखें
व्यक्तित्व से शुरू करें। फ़्रंटमैटर कर्मचारी का नाम बताता है और एक पंक्ति का विवरण देता है; मुख्य भाग सरल गद्य में निर्देश होता है।
--- name: Support Coordinator description: Answers every customer message the day it arrives and escalates what it cannot settle. --- # Support Coordinator You answer customer email for the company. Reply within the configured window, in the company's voice, and keep every thread moving until the customer has an answer. ## How you work - Read the whole thread before you reply. - Use the reply-drafting skill for every customer reply. - When a message is about money, draft a proposal for the owner instead of promising anything. ## Rules - Never promise a refund, a discount or a date you cannot confirm.
जब भूमिका को किसी सिस्टम, मालिक से किसी सेटिंग, या बिना कहे किए जाने वाले काम की ज़रूरत हो, तो agent.json जोड़ें। इस उदाहरण में mail क्षमता ज़रूरी है, नियुक्ति के समय एक सवाल पूछा जाता है, और हर नए संदेश के आते ही उसका जवाब दिया जाता है।
{
"requires": { "interfaces": ["mail"] },
"inputs": [
{
"key": "reply_window_hours",
"label": "Reply within (hours)",
"type": "number",
"id": "support.reply_window_hours",
"scope": "company",
"default": 24
}
],
"workflows": {
"new-mail": {
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"description": "Handle each customer message as it arrives.",
"activities": [
{
"id": "reply",
"intent": "Read the message in _watch_payload, draft a reply within reply_window_hours, and escalate anything about money to the owner."
}
]
}
}
} वॉच किसी प्रोडक्ट का नहीं, बल्कि mail क्षमता का नाम लेता है। रन के समय यह उस प्लगइन से जुड़ जाता है जिसे मालिक ने मेल के लिए कनेक्ट किया है। ट्रिगर और एक्टिविटी के लिए वर्कफ़्लो देखें।
इसे बॉट पर लोड करें
फ़ोल्डर को <data>/user/agents/<name>/ में रखें। Nebo AGENT.md, agent.json और manifest.json पर नज़र रखता है और किसी बदलाव के लगभग एक सेकंड बाद कर्मचारी को फिर से लोड करता है। फ़ोल्डर हटाने से कर्मचारी निष्क्रिय हो जाता है, पर उसका रिकॉर्ड बना रहता है।
Nebo कर्मचारियों को तीन स्रोतों से लोड करता है, और बाद वाले स्रोत को प्राथमिकता मिलती है: Nebo में पहले से बने कर्मचारी, <data>/nebo/agents/ में सील किए गए मार्केटप्लेस पैकेज, और <data>/user/agents/ में फ़ोल्डर। कोई कर्मचारी अपने create_employee और update_employee टूल से आपके लिए पैकेज बना या बदल भी सकता है, जो वही फ़ोल्डर लिखते हैं।
नियुक्ति के समय क्या होता है
जब कोई मालिक मार्केटप्लेस से या AGNT- कोड से आपके कर्मचारी को नियुक्त करता है, तो Nebo:
- किसी मॉडल से पूछे बिना पैकेज की ज़रूरतें पढ़ता है:
requires.interfacesकी हर क्षमता,requires.pluginsका हर प्लगइन, और हर वह क्षमता या प्लगइन जिसका नाम कोई वॉच ट्रिगर लेता है। - उन ज़रूरतों के लिए मालिक को सहमति का एक वाक्य दिखाता है और, नियुक्ति होने पर, उन्हें इस कर्मचारी को स्थायी अनुमतियों के रूप में देता है। जिन ऑपरेशन को मंज़ूरी चाहिए, वे वैसे ही रहते हैं। क्षमताएँ और मंज़ूरियाँ देखें।
- डिपेंडेंसी इंस्टॉल करता है:
requires.pluginsके प्लगइन,skillsऔर एक्टिविटी में नामित मार्केटप्लेस स्किल, और पैकेज पब्लिश होते समय घोषित डिपेंडेंसी। - मालिक से
inputsके सवाल पूछता है, और जिस क्षमता का अभी कोई कनेक्शन नहीं है, उसके बारे में इनबॉक्स के ज़रिए मालिक को बताता है।
जिस वर्कफ़्लो की क्षमता का कोई कनेक्शन नहीं है, उसे रखा जाता है और कारण के साथ सीमित (degraded) के रूप में चिह्नित किया जाता है। मालिक के कोई सिस्टम कनेक्ट करते ही वह काम करने लगता है।
Nebo क्या जाँचता है
Nebo agent.json को लचीले ढंग से पढ़ता है। अनजान कुंजियाँ अनदेखी की जाती हैं। जो वर्कफ़्लो स्कीमा से मेल नहीं खाता, उसे छोड़ दिया जाता है, और मालिक को इनबॉक्स में सूचना मिलती है कि वह नहीं चलेगा; कर्मचारी का बाकी हिस्सा फिर भी लोड होता है। ये समस्याएँ पूरी फ़ाइल को अस्वीकार कर देती हैं:
- खाली
sourcesसूची वालाeventट्रिगर। - एक वर्कफ़्लो में एक ही
idवाली दो एक्टिविटी। companyयाseatके अलावा किसीscopeवाला इनपुट, या डिफ़ॉल्ट वाला पैसे का सवाल।"approval"के अलावा कोईceilingमान।- फ़ोन कॉल ट्री जिसमें ठीक एक अभिवादन और कम से कम एक नामित इंटेंट न हो।
कुछ जाँचें वर्कफ़्लो लोड होने के बजाय शुरू होने पर चलती हैं, जैसे हर एक्टिविटी टाइप के लिए ज़रूरी पैरामीटर। एक्टिविटी देखें।
ज़िम्मेदारियाँ लिखें, टूल नहीं। एक कर्मचारी पैकेज ledger या mail जैसी क्षमताओं का नाम लेता है, किसी खास प्रोडक्ट, कंपनी या उद्योग का कभी नहीं। हर क्षमता को कौन-सा सिस्टम पूरा करेगा, यह मालिक तय करता है, इसलिए एक ही पैकेज हर उस कंपनी के काम आता है जो उसे नियुक्त करती है।
आगे
- agent.json संदर्भ
- व्यक्तित्व और मेमोरी
- पब्लिश करना: कर्मचारी को मार्केटप्लेस पर रखें।