Modelul
- O capabilitate este o interfață tipizată, niciodată un produs.
mailare operațiunilemail.inbox.read,mail.inbox.searchșimail.message.send. - Un pachet de angajat enumeră în
requires.interfacescapabilitățile de care are nevoie rolul lui. - Un plugin oferă o capabilitate legându-i operațiunile de propriile comenzi în
interfaceBindings. - O conexiune este pluginul pe care proprietarul l-a conectat pentru acea capabilitate. Un declanșator de monitorizare care numește o capabilitate rulează pe el.
Declară de ce are nevoie un rol
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Numește capabilități, nu pluginuri. Un pachet de angajat care are nevoie de ledger funcționează pentru orice companie, indiferent ce sistem de contabilitate folosește. Folosește requires.plugins doar când un rol depinde cu adevărat de un anumit plugin.
Oferă o capabilitate
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Un plugin care leagă orice operațiune mail.* oferă mail. Fiecare legătură devine și un instrument tipizat pentru angajați, de exemplu mail_message_send. Sintaxa șabloanelor e în referința plugin.json.
Când un flux de lucru monitorizează o capabilitate, Nebo alege pluginul instalat care o oferă, preferându-l pe cel la care acest angajat are cont, apoi în ordine alfabetică. Dacă nu există niciunul, fluxul de lucru e păstrat, marcat ca degradat, iar proprietarului i se spune ce să conecteze.
Catalogul
Nebo vine cu un catalog de capabilități și operațiunile lor, printre care ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring și incidents. Catalogul este un vocabular comun, nu un gard. Folosește-i termenii oriunde se potrivesc, ca angajații și pluginurile de la editori diferiți să se întâlnească; un termen nou e o chestiune de convenție, nu o eroare.
Fiecare operațiune are unul dintre trei marcaje.
| Marcaj | Semnificație |
|---|---|
| Fără aprobare | O citire sau o acțiune de protecție reversibilă, care își pierde valoarea dacă așteaptă, cum ar fi punerea pe pauză, anularea sau revenirea la o versiune anterioară. Rulează fără să întrebe. |
| Cu aprobare | Mută bani, contactează pe cineva din afara companiei sau nu poate fi anulată. Nebo întreabă înainte să ruleze instrumentul legat. |
| Critică | Mișcări de bani, încheierea de contracte, evidențele proprii ale companiei sau autoritatea permanentă de a acționa nesupravegheat. Necesită întotdeauna aprobare; proprietarul le acordă una câte una, pe angajat și pe operațiune, și nicio setare la nivelul angajatului nu le relaxează. |
Consimțământul la angajare
Când un proprietar angajează un angajat, Nebo îi citește nevoile din pachet: capabilitățile din requires.interfaces, pluginurile din requires.plugins și fiecare capabilitate sau plugin numit de un declanșator de monitorizare. Proprietarul vede o singură propoziție care enunță aceste nevoi. Angajarea i le acordă acelui angajat ca permisiuni permanente. Operațiunile cu aprobare rămân elemente de aprobat.
Instalarea unui plugin, a unui server MCP, a unei aplicații sau a unei abilități este ea însăși permisiunea de a le folosi; acestea nu se activează una câte una. Abilitățile integrate ale lui Nebo sunt grupate ca chat, file, shell, web, contacts, desktop, media și system.
Plafoane și legi
| Declarat în | Efect |
|---|---|
ceiling în agent.json | Pentru acest angajat, operațiunile listate îl întreabă întotdeauna pe proprietar. Singura valoare este "approval". |
ceiling al unei legi din stratul companiei | Operațiunile listate sunt blocate pentru toți angajații. |
O lege a companiei cu reserved_to: owner | Operațiunile listate au nevoie de aprobarea proprietarului însuși, iar această aprobare nu poate fi niciodată acordată unui angajat. |
Moduri de permisiuni
Fiecare angajat are un mod de permisiuni. Acesta decide apelurile pe care nicio regulă nu le lămurește, iar proprietarul îl poate suprascrie pentru o singură rulare.
| Mod | Comportament |
|---|---|
automatic | Varianta implicită. Angajatul acționează în cadrul postului său și întreabă doar pentru operațiunile cu aprobare și pentru regulile de întrebare ale proprietarului. |
ask | Fiecare apel care schimbă ceva întreabă, cu excepția cazului în care e acoperit de o regulă de permitere. |
plan | Doar citire și planificare. Un apel care schimbă ceva nu rulează. |
full_access | Nimic nu întreabă. Regulile de refuz și limitele stricte rămân valabile. |
Nebo verifică fiecare acțiune în aceeași ordine: mai întâi limitele stricte, apoi plafoanele și legile, apoi regulile proprietarului, apoi modul. Limitele stricte, cum ar fi protejarea datelor de autentificare împotriva scurgerilor, nu sunt ridicate niciodată, nici măcar în full_access.