Malli
- Kyky on tyypitetty rajapinta, ei koskaan tuote. Kyvyllä
mailon toiminnotmail.inbox.read,mail.inbox.searchjamail.message.send. - Työntekijäpaketti luettelee roolinsa tarvitsemat kyvyt kentässä
requires.interfaces. - Laajennus tarjoaa kyvyn sitomalla sen toiminnot omiin komentoihinsa kentässä
interfaceBindings. - Yhteys on laajennus, jonka omistaja yhdisti kyseistä kykyä varten. Kyvyn nimeävä seurantakäynnistin toimii sen varassa.
Ilmoita, mitä rooli tarvitsee
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Nimeä kykyjä, älä laajennuksia. Työntekijäpaketti, joka vaatii kyvyn ledger, toimii jokaisessa yrityksessä riippumatta siitä, mitä kirjanpitojärjestelmää se käyttää. Käytä kenttää requires.plugins vain, kun rooli todella riippuu yhdestä tietystä laajennuksesta.
Tarjoa kyky
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Laajennus, joka sitoo minkä tahansa mail.*-toiminnon, tarjoaa kyvyn mail. Jokaisesta sidonnasta tulee myös tyypitetty työkalu työntekijöille, kuten mail_message_send. Mallisyntaksi on kuvattu plugin.json-viitteessä.
Kun työnkulku seuraa kykyä, Nebo valitsee asennetun laajennuksen, joka tarjoaa sen, ja suosii ensin sellaista, jossa tällä työntekijällä on tili, ja sitten aakkosjärjestystä. Jos sellaista ei ole, työnkulku säilytetään, merkitään heikentyneeksi, ja omistajalle kerrotaan, mitä yhdistää.
Luettelo
Nebon mukana tulee luettelo kyvyistä ja niiden toiminnoista, mukaan lukien ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring ja incidents. Luettelo on yhteistä sanastoa, ei aita. Käytä sen termejä aina, kun jokin sopii, jotta eri julkaisijoiden työntekijät ja laajennukset kohtaavat; uusi termi on käytäntöön liittyvä kysymys, ei virhe.
Jokaisella toiminnolla on yksi kolmesta merkinnästä.
| Merkintä | Merkitys |
|---|---|
| Ei hyväksyntää | Luku tai suojaava toimi, joka on peruttavissa ja menettää arvonsa, jos se odottaa, kuten keskeytys, peruutus tai palautus. Suoritetaan kysymättä. |
| Hyväksyntää vaativa | Siirtää rahaa, ottaa yhteyttä johonkuhun yrityksen ulkopuolella tai on peruuttamaton. Nebo kysyy ennen kuin sidottu työkalu suoritetaan. |
| Kriittinen | Rahan liikkuminen, sopimuksen syntyminen, yrityksen omat tietueet tai pysyvä valtuus toimia valvomatta. Vaatii aina hyväksynnän; omistaja myöntää jokaisen työntekijä- ja toimintokohtaisesti, eikä mikään työntekijän laajuinen asetus löysennä sitä. |
Suostumus palkattaessa
Kun omistaja palkkaa työntekijän, Nebo lukee sen tarpeet paketista: kyvyt kentässä requires.interfaces, laajennukset kentässä requires.plugins ja jokaisen kyvyn tai laajennuksen, jonka seurantakäynnistin nimeää. Omistaja näkee yhden lauseen, joka kertoo nämä tarpeet. Palkkaaminen myöntää ne kyseiselle työntekijälle pysyvinä lupina. Hyväksyntää vaativat toiminnot pysyvät hyväksyntäkohteina.
Laajennuksen, MCP-palvelimen, sovelluksen tai taidon asentaminen on itsessään lupa käyttää sitä; niitä ei kytketä päälle yksi kerrallaan. Nebon omat sisäänrakennetut kyvyt on ryhmitelty näin: chat, file, shell, web, contacts, desktop, media ja system.
Katot ja lait
| Ilmoitettu kohdassa | Vaikutus |
|---|---|
ceiling tiedostossa agent.json | Luetellut toiminnot kysyvät aina omistajalta tämän työntekijän osalta. Ainoa arvo on "approval". |
Lain ceiling yritystasolla | Luetellut toiminnot on estetty jokaiselta työntekijältä. |
Yrityksen laki, jossa on reserved_to: owner | Luetellut toiminnot vaativat omistajan oman hyväksynnän, eikä tätä hyväksyntää voi koskaan myöntää työntekijälle. |
Lupatilat
Jokaisella työntekijällä on lupatila. Se ratkaisee kutsut, joita mikään sääntö ei ratkaise, ja omistaja voi ohittaa sen yksittäisen ajon osalta.
| Tila | Toiminta |
|---|---|
automatic | Oletus. Työntekijä toimii tehtävänsä puitteissa ja kysyy vain hyväksyntää vaativista toiminnoista ja omistajan kysymissäännöistä. |
ask | Jokainen kutsu, joka muuttaa jotain, kysyy, ellei sallintasääntö kata sitä. |
plan | Vain luku ja suunnittelu. Kutsu, joka muuttaa jotain, ei suoriudu. |
full_access | Mikään ei kysy. Kieltosäännöt ja ehdottomat rajat pätevät silti. |
Nebo tarkistaa jokaisen toiminnon samassa järjestyksessä: ensin ehdottomat rajat, sitten katot ja lait, sitten omistajan säännöt ja sitten tila. Ehdottomia rajoja, kuten tunnistetietojen vuotamisen estämistä, ei koskaan poisteta, ei edes tilassa full_access.