मॉडल
- क्षमता एक टाइप वाला इंटरफ़ेस है, कभी कोई प्रोडक्ट नहीं।
mailके ऑपरेशन हैंmail.inbox.read,mail.inbox.searchऔरmail.message.send। - कर्मचारी पैकेज अपनी भूमिका के लिए ज़रूरी क्षमताओं को
requires.interfacesमें सूचीबद्ध करता है। - प्लगइन
interfaceBindingsमें अपने ऑपरेशन को अपनी कमांड से जोड़कर एक क्षमता देता है। - कनेक्शन वह प्लगइन है जिसे मालिक ने उस क्षमता के लिए कनेक्ट किया है। जो वॉच ट्रिगर किसी क्षमता का नाम लेता है, वह उसी पर चलता है।
बताएँ कि भूमिका को क्या चाहिए
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} प्लगइन के नहीं, क्षमताओं के नाम लें। जिस कर्मचारी पैकेज को ledger चाहिए, वह हर कंपनी के लिए काम करता है, चाहे वह कोई भी अकाउंटिंग सिस्टम इस्तेमाल करे। requires.plugins तभी इस्तेमाल करें जब कोई भूमिका सच में किसी एक खास प्लगइन पर निर्भर हो।
क्षमता दें
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} जो प्लगइन कोई भी mail.* ऑपरेशन जोड़ता है, वह mail देता है। हर बाइंडिंग कर्मचारियों के लिए एक टाइप वाला टूल भी बन जाती है, जैसे mail_message_send। टेम्पलेट सिंटैक्स plugin.json संदर्भ पर है।
जब कोई वर्कफ़्लो किसी क्षमता पर नज़र रखता है, तो Nebo वह इंस्टॉल किया हुआ प्लगइन चुनता है जो उसे देता है, पहले उसे जिस पर इस कर्मचारी का अकाउंट हो, फिर वर्णानुक्रम से। कोई न हो तो वर्कफ़्लो रखा जाता है, सीमित चिह्नित किया जाता है, और मालिक को बताया जाता है कि क्या कनेक्ट करना है।
कैटलॉग
Nebo क्षमताओं और उनके ऑपरेशन का एक कैटलॉग देता है, जिसमें ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring और incidents शामिल हैं। कैटलॉग साझा शब्दावली है, कोई बाड़ नहीं। जहाँ भी कोई शब्द ठीक बैठे, उसका इस्तेमाल करें ताकि अलग-अलग पब्लिशर के कर्मचारी और प्लगइन आपस में मेल खाएँ; नया शब्द चलन का सवाल है, कोई त्रुटि नहीं।
हर ऑपरेशन पर तीन में से एक निशान होता है।
| निशान | अर्थ |
|---|---|
| बिना मंज़ूरी | पढ़ना, या कोई सुरक्षात्मक कदम जो पलटा जा सकता है और इंतज़ार करने पर अपना मूल्य खो देता है, जैसे रोकना, रद्द करना या पिछली स्थिति पर लौटना। बिना पूछे चलता है। |
| मंज़ूरी से बंधा | पैसा भेजता है, कंपनी के बाहर किसी से संपर्क करता है, या पलटा नहीं जा सकता। बंधा हुआ टूल चलने से पहले Nebo पूछता है। |
| अहम | पैसे का लेन-देन, अनुबंध बनाना, कंपनी के अपने रिकॉर्ड, या बिना निगरानी के काम करने का स्थायी अधिकार। हमेशा मंज़ूरी से बंधा; मालिक हर एक को हर कर्मचारी और हर ऑपरेशन के लिए अलग से देता है, और कर्मचारी स्तर की कोई सेटिंग इसे ढीला नहीं करती। |
नियुक्ति के समय सहमति
जब कोई मालिक किसी कर्मचारी को नियुक्त करता है, तो Nebo पैकेज से उसकी ज़रूरतें पढ़ता है: requires.interfaces की क्षमताएँ, requires.plugins के प्लगइन, और हर वह क्षमता या प्लगइन जिसका नाम कोई वॉच ट्रिगर लेता है। मालिक एक वाक्य देखता है जो इन ज़रूरतों को बताता है। नियुक्ति इन्हें उस कर्मचारी को स्थायी अनुमतियों के रूप में देती है। मंज़ूरी से बंधे ऑपरेशन मंज़ूरी के आइटम बने रहते हैं।
किसी प्लगइन, MCP सर्वर, ऐप या स्किल को इंस्टॉल करना ही उसे इस्तेमाल करने की अनुमति है; इन्हें एक-एक करके चालू नहीं किया जाता। Nebo की अपनी बिल्ट-इन क्षमताएँ chat, file, shell, web, contacts, desktop, media और system के रूप में समूहित हैं।
सीमाएँ और क़ानून
| कहाँ घोषित | असर |
|---|---|
agent.json में ceiling | इस कर्मचारी के लिए सूचीबद्ध ऑपरेशन हमेशा मालिक से पूछते हैं। एकमात्र मान "approval" है। |
कंपनी परत में किसी क़ानून का ceiling | सूचीबद्ध ऑपरेशन हर कर्मचारी के लिए अवरुद्ध हैं। |
reserved_to: owner वाला कंपनी का क़ानून | सूचीबद्ध ऑपरेशन के लिए मालिक की अपनी मंज़ूरी चाहिए, और वह मंज़ूरी कभी किसी कर्मचारी को नहीं दी जा सकती। |
अनुमति मोड
हर कर्मचारी का एक अनुमति मोड होता है। यह उन कॉल का फ़ैसला करता है जिन्हें कोई नियम तय नहीं करता, और मालिक किसी एक रन के लिए इसे बदल सकता है।
| मोड | व्यवहार |
|---|---|
automatic | डिफ़ॉल्ट। कर्मचारी अपनी नौकरी के दायरे में काम करता है और सिर्फ़ मंज़ूरी से बंधे ऑपरेशन और मालिक के पूछने वाले नियमों के लिए पूछता है। |
ask | कुछ बदलने वाली हर कॉल पूछती है, जब तक कोई अनुमति नियम उसे कवर न करे। |
plan | सिर्फ़ पढ़ना और योजना बनाना। कुछ बदलने वाली कॉल नहीं चलती। |
full_access | कुछ भी नहीं पूछता। अस्वीकार के नियम और सख़्त सीमाएँ फिर भी लागू रहती हैं। |
Nebo हर कार्रवाई को एक ही क्रम में जाँचता है: पहले सख़्त सीमाएँ, फिर सीमाएँ (ceilings) और क़ानून, फिर मालिक के नियम, फिर मोड। सख़्त सीमाएँ, जैसे क्रेडेंशियल को लीक होने से बचाना, कभी नहीं हटतीं, full_access में भी नहीं।