Het model
- Een capability is een getypeerde interface, nooit een product.
mailheeft de bewerkingenmail.inbox.read,mail.inbox.searchenmail.message.send. - Een medewerkerspakket somt in
requires.interfacesde capabilities op die zijn functie nodig heeft. - Een plug-in levert een capability door de bewerkingen ervan in
interfaceBindingsaan zijn eigen opdrachten te koppelen. - Een verbinding is de plug-in die de eigenaar voor die capability heeft verbonden. Een watch-trigger die een capability noemt, draait daarop.
Declareer wat een functie nodig heeft
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Noem capabilities, geen plug-ins. Een medewerkerspakket dat ledger vereist, werkt voor elk bedrijf, welk boekhoudsysteem het ook gebruikt. Gebruik requires.plugins alleen als een functie echt van één specifieke plug-in afhangt.
Een capability leveren
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Een plug-in die een mail.*-bewerking koppelt, levert mail. Elke koppeling wordt ook een getypeerde tool voor medewerkers, zoals mail_message_send. De sjabloonsyntaxis staat in de plugin.json-referentie.
Als een workflow een capability in de gaten houdt, kiest Nebo de geïnstalleerde plug-in die hem levert, met voorkeur voor een plug-in waarop deze medewerker een account heeft, en daarna op alfabetische volgorde. Is er geen, dan blijft de workflow bewaard, wordt hij als beperkt gemarkeerd en krijgt de eigenaar te horen wat hij moet verbinden.
De catalogus
Nebo levert een catalogus van capabilities en hun bewerkingen, waaronder ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring en incidents. De catalogus is een gedeelde woordenschat, geen hek. Gebruik de termen ervan waar er een past, zodat medewerkers en plug-ins van verschillende uitgevers op elkaar aansluiten; een nieuwe term is een kwestie van afspraak, geen fout.
Elke bewerking draagt een van drie markeringen.
| Markering | Betekenis |
|---|---|
| Zonder goedkeuring | Een leesactie, of een beschermende handeling die omkeerbaar is en zijn waarde verliest als hij moet wachten, zoals pauzeren, annuleren of terugdraaien. Draait zonder te vragen. |
| Met goedkeuring | Verplaatst geld, neemt contact op met iemand buiten het bedrijf of kan niet ongedaan worden gemaakt. Nebo vraagt het voordat de gekoppelde tool draait. |
| Kritiek | Geld verplaatsen, contracten sluiten, de eigen administratie van het bedrijf, of blijvende bevoegdheid om zonder toezicht te handelen. Altijd met goedkeuring; de eigenaar verleent elke bevoegdheid per medewerker en per bewerking, en geen enkele instelling voor de hele medewerker versoepelt dat. |
Toestemming bij het aannemen
Als een eigenaar een medewerker aanneemt, leest Nebo de behoeften uit het pakket: de capabilities in requires.interfaces, de plug-ins in requires.plugins en elke capability of plug-in die een watch-trigger noemt. De eigenaar ziet één zin waarin die behoeften staan. Door aan te nemen worden ze als vaste machtigingen aan die medewerker toegekend. Bewerkingen met goedkeuring blijven goedkeuringsitems.
Een plug-in, MCP-server, app of skill installeren is op zichzelf al de toestemming om hem te gebruiken; die worden niet een voor een aangezet. De eigen ingebouwde mogelijkheden van Nebo zijn gegroepeerd als chat, file, shell, web, contacts, desktop, media en system.
Plafonds en wetten
| Gedeclareerd in | Effect |
|---|---|
ceiling in agent.json | De vermelde bewerkingen vragen voor deze medewerker altijd de eigenaar. De enige waarde is "approval". |
De ceiling van een wet in de bedrijfslaag | De vermelde bewerkingen zijn geblokkeerd voor elke medewerker. |
Een bedrijfswet met reserved_to: owner | De vermelde bewerkingen hebben de eigen goedkeuring van de eigenaar nodig, en die goedkeuring kan nooit aan een medewerker worden toegekend. |
Machtigingsmodi
Elke medewerker heeft een machtigingsmodus. Die beslist over de aanroepen waarvoor geen regel geldt, en de eigenaar kan hem voor één run overschrijven.
| Modus | Gedrag |
|---|---|
automatic | De standaard. De medewerker handelt binnen zijn taak en vraagt alleen bij bewerkingen met goedkeuring en de vraagregels van de eigenaar. |
ask | Elke aanroep die iets verandert, vraagt om goedkeuring, tenzij een toestaanregel hem dekt. |
plan | Alleen lezen en plannen. Een aanroep die iets verandert, draait niet. |
full_access | Er wordt niets gevraagd. Weigerregels en harde grenzen gelden nog steeds. |
Nebo controleert elke actie in dezelfde volgorde: eerst harde grenzen, dan plafonds en wetten, dan de regels van de eigenaar, dan de modus. Harde grenzen, zoals het beschermen van inloggegevens tegen lekken, worden nooit opgeheven, zelfs niet in full_access.