NeboAI
NeboAI
Aan de slag

Mogelijkheden en goedkeuringen

Een capability benoemt een soort systeem, zoals mail of een grootboek, en de bewerkingen erop. Medewerkerspakketten declareren de capabilities die ze nodig hebben; plug-ins declareren de capabilities die ze leveren; de eigenaar verbindt die twee bij het aannemen. Goedkeuringen zijn gekoppeld aan bewerkingen, dus dezelfde regels gelden welk systeem de capability ook invult.

Het model

  • Een capability is een getypeerde interface, nooit een product. mail heeft de bewerkingen mail.inbox.read, mail.inbox.search en mail.message.send.
  • Een medewerkerspakket somt in requires.interfaces de capabilities op die zijn functie nodig heeft.
  • Een plug-in levert een capability door de bewerkingen ervan in interfaceBindings aan 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.

MarkeringBetekenis
Zonder goedkeuringEen 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 goedkeuringVerplaatst geld, neemt contact op met iemand buiten het bedrijf of kan niet ongedaan worden gemaakt. Nebo vraagt het voordat de gekoppelde tool draait.
KritiekGeld 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 inEffect
ceiling in agent.jsonDe vermelde bewerkingen vragen voor deze medewerker altijd de eigenaar. De enige waarde is "approval".
De ceiling van een wet in de bedrijfslaagDe vermelde bewerkingen zijn geblokkeerd voor elke medewerker.
Een bedrijfswet met reserved_to: ownerDe 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.

ModusGedrag
automaticDe standaard. De medewerker handelt binnen zijn taak en vraagt alleen bij bewerkingen met goedkeuring en de vraagregels van de eigenaar.
askElke aanroep die iets verandert, vraagt om goedkeuring, tenzij een toestaanregel hem dekt.
planAlleen lezen en plannen. Een aanroep die iets verandert, draait niet.
full_accessEr 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.