NeboAI
NeboAI
Začať

Schopnosti a schválenia

Schopnosť pomenúva druh systému, napríklad poštu alebo účtovnú knihu, a operácie s ním. Balíky zamestnancov deklarujú schopnosti, ktoré potrebujú; doplnky deklarujú tie, ktoré poskytujú; vlastník ich pri prijatí prepojí. Schválenia sú viazané na operácie, takže rovnaké pravidlá platia bez ohľadu na to, ktorý systém schopnosť napĺňa.

Model

  • Schopnosť je typové rozhranie, nikdy nie produkt. mail má operácie mail.inbox.read, mail.inbox.search a mail.message.send.
  • Balík zamestnanca uvádza schopnosti, ktoré jeho rola potrebuje, v requires.interfaces.
  • Doplnok poskytuje schopnosť tak, že v interfaceBindings prepojí jej operácie so svojimi vlastnými príkazmi.
  • Pripojenie je doplnok, ktorý vlastník pre danú schopnosť pripojil. Sledovací spúšťač, ktorý pomenúva schopnosť, beží na ňom.

Deklarujte, čo rola potrebuje

{
  "requires": { "interfaces": ["mail", "ledger"] },
  "ceiling": { "ledger.bill.create": "approval" }
}

Pomenúvajte schopnosti, nie doplnky. Balík zamestnanca, ktorý vyžaduje ledger, funguje pre každú firmu bez ohľadu na to, aký účtovný systém používa. requires.plugins použite len vtedy, keď rola naozaj závisí od jedného konkrétneho doplnku.

Poskytnutie schopnosti

"interfaceBindings": {
  "mail.inbox.read": "messages list --folder inbox",
  "mail.inbox.search": "messages search --query {query}",
  "mail.message.send": "messages send"
}

Doplnok, ktorý prepojí akúkoľvek operáciu mail.*, poskytuje mail. Každé prepojenie sa zároveň stane typovým nástrojom pre zamestnancov, napríklad mail_message_send. Syntax šablón nájdete v referencii plugin.json.

Keď pracovný postup sleduje schopnosť, Nebo vyberie nainštalovaný doplnok, ktorý ju poskytuje, prednostne taký, v ktorom má tento zamestnanec účet, a potom podľa abecedy. Ak žiadny nie je, pracovný postup sa zachová, označí ako obmedzený a vlastník sa dozvie, čo má pripojiť.

Katalóg

Nebo sa dodáva s katalógom schopností a ich operácií vrátane ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring a incidents. Katalóg je spoločný slovník, nie plot. Používajte jeho výrazy všade, kde sa nejaký hodí, aby sa zamestnanci a doplnky od rôznych vydavateľov stretli; nový výraz je otázkou konvencie, nie chybou.

Každá operácia nesie jednu z troch značiek.

ZnačkaVýznam
Nepodlieha schváleniuČítanie alebo ochranný úkon, ktorý je vratný a stráca hodnotu, ak čaká, napríklad pozastavenie, zrušenie alebo vrátenie zmien. Beží bez pýtania.
Podlieha schváleniuHýbe peniazmi, kontaktuje niekoho mimo firmy alebo sa nedá vrátiť späť. Nebo sa opýta skôr, ako sa prepojený nástroj spustí.
KritickéPohyb peňazí, uzatvorenie zmluvy, vlastné záznamy firmy alebo trvalé oprávnenie konať bez dozoru. Vždy podlieha schváleniu; vlastník každú udeľuje pre konkrétneho zamestnanca a konkrétnu operáciu a žiadne nastavenie pre celého zamestnanca ju neuvoľní.

Súhlas pri prijatí

Keď vlastník prijme zamestnanca, Nebo prečíta jeho potreby z balíka: schopnosti v requires.interfaces, doplnky v requires.plugins a každú schopnosť alebo doplnok, ktoré pomenúva sledovací spúšťač. Vlastník uvidí jednu vetu, ktorá tieto potreby uvádza. Prijatím ich tomuto zamestnancovi udelí ako trvalé oprávnenia. Operácie podliehajúce schváleniu zostávajú položkami na schválenie.

Inštalácia doplnku, servera MCP, aplikácie alebo zručnosti je sama osebe udelením práva na ich používanie; nezapínajú sa jednotlivo. Vlastné vstavané schopnosti Nebo sú zoskupené ako chat, file, shell, web, contacts, desktop, media a system.

Stropy a zákony

Deklarované vÚčinok
ceiling v agent.jsonUvedené operácie sa pri tomto zamestnancovi vždy pýtajú vlastníka. Jediná hodnota je "approval".
ceiling zákona vo firemnej vrstveUvedené operácie sú zablokované pre každého zamestnanca.
Firemný zákon s reserved_to: ownerUvedené operácie vyžadujú vlastné schválenie vlastníka a toto schválenie sa nikdy nedá udeliť zamestnancovi.

Režimy oprávnení

Každý zamestnanec má režim oprávnení. Rozhoduje o volaniach, ktoré nerieši žiadne pravidlo, a vlastník ho môže pre jedno spustenie prepísať.

RežimSprávanie
automaticPredvolené. Zamestnanec koná v rámci svojej práce a pýta sa len pri operáciách podliehajúcich schváleniu a podľa pravidiel vlastníka na pýtanie sa.
askKaždé volanie, ktoré niečo mení, sa pýta, pokiaľ ho nepokrýva pravidlo povolenia.
planLen čítanie a plánovanie. Volanie, ktoré niečo mení, sa nespustí.
full_accessNič sa nepýta. Pravidlá zákazu a pevné limity stále platia.

Nebo kontroluje každú akciu v rovnakom poradí: najprv pevné limity, potom stropy a zákony, potom pravidlá vlastníka a nakoniec režim. Pevné limity, napríklad ochrana pred únikom prihlasovacích údajov, sa nikdy nezrušia, ani v full_access.