Model
- Schopnost je typové rozhraní, nikdy produkt.
mailmá operacemail.inbox.read,mail.inbox.searchamail.message.send. - Balíček zaměstnance uvádí schopnosti, které jeho role potřebuje, v
requires.interfaces. - Plugin poskytuje schopnost tak, že v
interfaceBindingsnaváž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ím | Hý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.json | Uvedené 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: owner | Uvedené 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žim | Chování |
|---|---|
automatic | Vý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. |
ask | Každé volání, které něco mění, se zeptá, pokud ho nepokrývá povolující pravidlo. |
plan | Jen čtení a plánování. Volání, které něco mění, se nespustí. |
full_access | Nic 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.