Model
- Schopnosť je typové rozhranie, nikdy nie produkt.
mailmá operáciemail.inbox.read,mail.inbox.searchamail.message.send. - Balík zamestnanca uvádza schopnosti, ktoré jeho rola potrebuje, v
requires.interfaces. - Doplnok poskytuje schopnosť tak, že v
interfaceBindingsprepojí 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čka | Vý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áleniu | Hý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.json | Uvedené operácie sa pri tomto zamestnancovi vždy pýtajú vlastníka. Jediná hodnota je "approval". |
ceiling zákona vo firemnej vrstve | Uvedené operácie sú zablokované pre každého zamestnanca. |
Firemný zákon s reserved_to: owner | Uvedené 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žim | Správanie |
|---|---|
automatic | Predvolené. 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. |
ask | Každé volanie, ktoré niečo mení, sa pýta, pokiaľ ho nepokrýva pravidlo povolenia. |
plan | Len čítanie a plánovanie. Volanie, ktoré niečo mení, sa nespustí. |
full_access | Nič 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.