NeboAI
NeboAI
Aloita

Kyvyt ja hyväksynnät

Kyky nimeää järjestelmätyypin, kuten sähköpostin tai kirjanpidon, ja sen toiminnot. Työntekijäpaketit ilmoittavat tarvitsemansa kyvyt; laajennukset ilmoittavat tarjoamansa; omistaja yhdistää nämä kaksi palkattaessa. Hyväksynnät liitetään toimintoihin, joten samat säännöt pätevät riippumatta siitä, mikä järjestelmä kyvyn täyttää.

Malli

  • Kyky on tyypitetty rajapinta, ei koskaan tuote. Kyvyllä mail on toiminnot mail.inbox.read, mail.inbox.search ja mail.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ää vaativaSiirtää rahaa, ottaa yhteyttä johonkuhun yrityksen ulkopuolella tai on peruuttamaton. Nebo kysyy ennen kuin sidottu työkalu suoritetaan.
KriittinenRahan 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 kohdassaVaikutus
ceiling tiedostossa agent.jsonLuetellut toiminnot kysyvät aina omistajalta tämän työntekijän osalta. Ainoa arvo on "approval".
Lain ceiling yritystasollaLuetellut toiminnot on estetty jokaiselta työntekijältä.
Yrityksen laki, jossa on reserved_to: ownerLuetellut 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.

TilaToiminta
automaticOletus. Työntekijä toimii tehtävänsä puitteissa ja kysyy vain hyväksyntää vaativista toiminnoista ja omistajan kysymissäännöistä.
askJokainen kutsu, joka muuttaa jotain, kysyy, ellei sallintasääntö kata sitä.
planVain luku ja suunnittelu. Kutsu, joka muuttaa jotain, ei suoriudu.
full_accessMikää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.