NeboAI
NeboAI
Začít

Schopnosti a schvalování

Schopnost pojmenovává druh systému, například poštu nebo účetní knihu, a operace s ním. Balíčky zaměstnanců deklarují schopnosti, které potřebují; pluginy deklarují ty, které poskytují; vlastník je při přijetí propojí. Schvalování je navázané na operace, takže platí stejná pravidla bez ohledu na to, který systém schopnost naplňuje.

Model

  • Schopnost je typové rozhraní, nikdy produkt. mail má operace mail.inbox.read, mail.inbox.search a mail.message.send.
  • Balíček zaměstnance uvádí schopnosti, které jeho role potřebuje, v requires.interfaces.
  • Plugin poskytuje schopnost tak, že v interfaceBindings naváže její operace na vlastní příkazy.
  • Propojení je plugin, který vlastník pro danou schopnost připojil. Sledovací spouštěč, který schopnost uvádí, běží na něm.

Deklarujte, co role potřebuje

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

Uvádějte schopnosti, ne pluginy. Balíček zaměstnance, který vyžaduje ledger, funguje v každé firmě, ať používá jakýkoli účetní systém. requires.plugins použijte jen tehdy, když role skutečně závisí na jednom konkrétním pluginu.

Poskytnutí schopnosti

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

Plugin, který naváže jakoukoli operaci mail.*, poskytuje mail. Každá vazba se navíc stane typovým nástrojem pro zaměstnance, například mail_message_send. Syntaxe šablon je v referenci plugin.json.

Když pracovní postup sleduje schopnost, Nebo vybere nainstalovaný plugin, který ji poskytuje, přednostně ten, ke kterému má tento zaměstnanec účet, a pak podle abecedy. Pokud žádný není, pracovní postup se ponechá, označí jako omezený a vlastník se dozví, co má připojit.

Katalog

Nebo se dodává s katalogem schopností a jejich operací, včetně ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring a incidents. Katalog je sdílený slovník, ne plot. Kde se některý z jeho pojmů hodí, použijte ho, aby se zaměstnanci a pluginy od různých vydavatelů potkali; nový pojem je otázka konvence, ne chyba.

Každá operace nese jedno ze tří označení.

OznačeníVýznam
Bez schváleníČtení nebo ochranný úkon, který je vratný a čekáním ztrácí smysl, například pozastavení, zrušení nebo vrácení změn. Běží bez dotazu.
Se schválenímHýbe penězi, kontaktuje někoho mimo firmu nebo nelze vrátit zpět. Nebo se zeptá před spuštěním navázaného nástroje.
KritickéPohyb peněz, uzavírání smluv, vlastní záznamy firmy nebo trvalé oprávnění jednat bez dohledu. Vždy podmíněno schválením; vlastník každé uděluje zvlášť pro každého zaměstnance a každou operaci a žádné nastavení pro celého zaměstnance to nepovolí.

Souhlas při přijetí

Když vlastník přijme zaměstnance, Nebo z balíčku přečte jeho potřeby: schopnosti v requires.interfaces, pluginy v requires.plugins a každou schopnost nebo plugin, které uvádí sledovací spouštěč. Vlastník uvidí jednu větu, která tyto potřeby uvádí. Přijetím je zaměstnanci udělí jako trvalá oprávnění. Operace se schválením zůstávají položkami ke schválení.

Instalace pluginu, serveru MCP, aplikace nebo dovednosti je sama o sobě udělením oprávnění k jejich používání; nezapínají se jednotlivě. Vlastní vestavěné schopnosti Nebo jsou seskupené jako chat, file, shell, web, contacts, desktop, media a system.

Stropy a zákony

Deklarováno vÚčinek
ceiling v agent.jsonUvedené operace se u tohoto zaměstnance vždy zeptají vlastníka. Jediná hodnota je "approval".
ceiling zákona ve firemní vrstvěUvedené operace jsou zablokované pro každého zaměstnance.
Firemní zákon s reserved_to: ownerUvedené operace vyžadují vlastní schválení vlastníka a toto schválení nelze nikdy udělit zaměstnanci.

Režimy oprávnění

Každý zaměstnanec má režim oprávnění. Rozhoduje o voláních, která žádné pravidlo neřeší, a vlastník ho může pro jeden běh přepsat.

RežimChování
automaticVýchozí. Zaměstnanec jedná v rámci své práce a ptá se jen u operací se schválením a podle pravidel vlastníka pro dotazy.
askKaždé volání, které něco mění, se zeptá, pokud ho nepokrývá povolující pravidlo.
planJen čtení a plánování. Volání, které něco mění, se nespustí.
full_accessNic se neptá. Zakazující pravidla a pevné limity stále platí.

Nebo kontroluje každou akci ve stejném pořadí: nejdřív pevné limity, pak stropy a zákony, pak pravidla vlastníka a nakonec režim. Pevné limity, například ochrana přihlašovacích údajů před únikem, se nikdy neruší, ani v full_access.