A modell
- A képesség egy típusos interfész, soha nem egy termék. A
mailműveletei:mail.inbox.read,mail.inbox.searchésmail.message.send. - A munkatárscsomag a
requires.interfacesmezőben sorolja fel a szerepköréhez szükséges képességeket. - A bővítmény úgy biztosít egy képességet, hogy az
interfaceBindingsmezőben a műveleteit a saját parancsaihoz köti. - A kapcsolat az a bővítmény, amelyet a tulajdonos az adott képességhez csatlakoztatott. Egy képességet megnevező figyelőindító ezen fut.
Deklarálja, mire van szüksége egy szerepkörnek
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Képességeket nevezzen meg, ne bővítményeket. A ledger képességet igénylő munkatárscsomag minden cégnél működik, bármilyen könyvelési rendszert használ is. A requires.plugins mezőt csak akkor használja, ha egy szerepkör tényleg egy konkrét bővítménytől függ.
Képesség biztosítása
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Az a bővítmény, amely bármely mail.* műveletet köt, a mail képességet biztosítja. Minden kötésből a munkatársak számára egy típusos eszköz is lesz, például mail_message_send. A sablonszintaxist lásd: plugin.json referencia.
Amikor egy munkafolyamat egy képességet figyel, a Nebo azt a telepített bővítményt választja, amely biztosítja, előnyben részesítve azt, amelyben ennek a munkatársnak fiókja van, ezután betűrendben. Ha nincs ilyen, a munkafolyamat megmarad, csökkentett állapotúként jelölődik, és a tulajdonos értesítést kap arról, mit kell csatlakoztatnia.
A katalógus
A Nebo képességek és műveleteik katalógusával érkezik, köztük: ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring és incidents. A katalógus közös szókincs, nem kerítés. Használja a kifejezéseit, ahol csak illenek, hogy a különböző közzétevők munkatársai és bővítményei egymásra találjanak; egy új kifejezés konvenció kérdése, nem hiba.
Minden művelet a három jelölés egyikét viseli.
| Jelölés | Jelentés |
|---|---|
| Szabad | Olvasás, vagy olyan védő művelet, amely visszafordítható, és elveszíti az értékét, ha várnia kell, például szüneteltetés, megszakítás vagy visszaállítás. Kérdés nélkül fut. |
| Jóváhagyáshoz kötött | Pénzt mozgat, a cégen kívüli személlyel lép kapcsolatba, vagy nem vonható vissza. A Nebo a kötött eszköz futása előtt rákérdez. |
| Kritikus | Pénzmozgás, szerződéskötés, a cég saját nyilvántartásai, vagy állandó felhatalmazás felügyelet nélküli cselekvésre. Mindig jóváhagyáshoz kötött; a tulajdonos munkatársanként és műveletenként egyenként adja meg, és semmilyen munkatársszintű beállítás nem lazít rajta. |
Hozzájárulás felvételkor
Amikor egy tulajdonos felvesz egy munkatársat, a Nebo a csomagból olvassa ki az igényeit: a requires.interfaces képességeit, a requires.plugins bővítményeit, és minden képességet vagy bővítményt, amelyet egy figyelőindító megnevez. A tulajdonos egyetlen mondatot lát, amely ezeket az igényeket közli. A felvétel állandó engedélyként adja meg őket az adott munkatársnak. A jóváhagyáshoz kötött műveletek jóváhagyási tételek maradnak.
Egy bővítmény, MCP-szerver, alkalmazás vagy készség telepítése maga az engedély a használatára; ezeket nem kell egyenként bekapcsolni. A Nebo saját beépített képességei ezekbe a csoportokba tartoznak: chat, file, shell, web, contacts, desktop, media és system.
Plafonok és jogszabályok
| Hol deklarálva | Hatás |
|---|---|
ceiling az agent.json fájlban | A felsorolt műveletek ennél a munkatársnál mindig megkérdezik a tulajdonost. Az egyetlen érték: "approval". |
Egy jogszabály ceiling mezője a céges rétegben | A felsorolt műveletek minden munkatárs számára tiltottak. |
Egy céges jogszabály reserved_to: owner értékkel | A felsorolt műveletekhez a tulajdonos saját jóváhagyása kell, és ez a jóváhagyás soha nem adható át egy munkatársnak. |
Engedélyezési módok
Minden munkatársnak van engedélyezési módja. Ez dönt azokról a hívásokról, amelyeket egyetlen szabály sem rendez, és a tulajdonos egyetlen futtatásra felülbírálhatja.
| Mód | Viselkedés |
|---|---|
automatic | Az alapértelmezés. A munkatárs a munkakörén belül cselekszik, és csak a jóváhagyáshoz kötött műveleteknél és a tulajdonos kérdezési szabályainál kérdez. |
ask | Minden valamit megváltoztató hívás rákérdez, hacsak egy engedélyező szabály nem fedi le. |
plan | Csak olvasás és tervezés. A valamit megváltoztató hívás nem fut le. |
full_access | Semmi sem kérdez. A tiltó szabályok és a szigorú korlátok továbbra is érvényesek. |
A Nebo minden műveletet ugyanabban a sorrendben ellenőriz: előbb a szigorú korlátokat, aztán a plafonokat és a jogszabályokat, aztán a tulajdonos szabályait, végül a módot. A szigorú korlátok, például a hitelesítő adatok kiszivárgás elleni védelme, soha nem oldódnak fel, még full_access módban sem.