Modellen
- En funktion er et typet interface, aldrig et produkt.
mailhar operationernemail.inbox.read,mail.inbox.searchogmail.message.send. - En medarbejderpakke angiver de funktioner, dens rolle har brug for, i
requires.interfaces. - Et plugin leverer en funktion ved at binde dens operationer til sine egne kommandoer i
interfaceBindings. - En forbindelse er det plugin, ejeren har forbundet til den funktion. En overvågningsudløser, der navngiver en funktion, kører på den.
Erklær, hvad en rolle har brug for
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Navngiv funktioner, ikke plugins. En medarbejderpakke, der kræver ledger, virker for alle virksomheder, uanset hvilket regnskabssystem de bruger. Brug kun requires.plugins, når en rolle virkelig afhænger af ét bestemt plugin.
Lever en funktion
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Et plugin, der binder en hvilken som helst mail.*-operation, leverer mail. Hver binding bliver også et typet værktøj for medarbejdere, f.eks. mail_message_send. Skabelonsyntaksen findes i plugin.json-referencen.
Når et workflow overvåger en funktion, vælger Nebo det installerede plugin, der leverer den, og foretrækker et, som denne medarbejder har en konto på, og derefter alfabetisk rækkefølge. Hvis der ikke er noget, bevares workflowet, markeres som nedsat, og ejeren får at vide, hvad der skal forbindes.
Kataloget
Nebo leveres med et katalog over funktioner og deres operationer, herunder ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring og incidents. Kataloget er et fælles ordforråd, ikke et hegn. Brug dets termer, hvor de passer, så medarbejdere og plugins fra forskellige udgivere mødes; en ny term er et spørgsmål om konvention, ikke en fejl.
Hver operation har ét af tre mærker.
| Mærke | Betydning |
|---|---|
| Kræver ikke godkendelse | En læsning, eller en beskyttende handling, der kan fortrydes og mister sin værdi, hvis den venter, f.eks. pause, annullering eller tilbagerulning. Kører uden at spørge. |
| Kræver godkendelse | Flytter penge, kontakter nogen uden for virksomheden eller kan ikke fortrydes. Nebo spørger, før det bundne værktøj kører. |
| Kritisk | Flytning af penge, indgåelse af kontrakter, virksomhedens egne optegnelser eller stående bemyndigelse til at handle uden opsyn. Kræver altid godkendelse; ejeren giver hver enkelt pr. medarbejder og pr. operation, og ingen indstilling for hele medarbejderen løsner det. |
Samtykke ved ansættelse
Når en ejer ansætter en medarbejder, læser Nebo dens behov fra pakken: funktionerne i requires.interfaces, plugins i requires.plugins og hver funktion eller hvert plugin, som en overvågningsudløser navngiver. Ejeren ser én sætning, der angiver de behov. Ansættelsen giver dem til den medarbejder som stående tilladelser. Operationer, der kræver godkendelse, forbliver godkendelsespunkter.
At installere et plugin, en MCP-server, en app eller en færdighed er i sig selv tilladelsen til at bruge den; de slås ikke til én ad gangen. Nebos egne indbyggede evner er grupperet som chat, file, shell, web, contacts, desktop, media og system.
Lofter og love
| Erklæret i | Virkning |
|---|---|
ceiling i agent.json | De angivne operationer spørger altid ejeren for denne medarbejder. Den eneste værdi er "approval". |
En lovs ceiling i virksomhedslaget | De angivne operationer er blokeret for alle medarbejdere. |
En virksomhedslov med reserved_to: owner | De angivne operationer kræver ejerens egen godkendelse, og den godkendelse kan aldrig gives til en medarbejder. |
Tilladelsestilstande
Hver medarbejder har en tilladelsestilstand. Den afgør de kald, som ingen regel afgør, og ejeren kan tilsidesætte den for en enkelt kørsel.
| Tilstand | Adfærd |
|---|---|
automatic | Standarden. Medarbejderen handler inden for sit job og spørger kun ved operationer, der kræver godkendelse, og ved ejerens spørgeregler. |
ask | Hvert kald, der ændrer noget, spørger, medmindre en tilladelsesregel dækker det. |
plan | Kun læse og planlægge. Et kald, der ændrer noget, kører ikke. |
full_access | Intet spørger. Afvisningsregler og faste grænser gælder stadig. |
Nebo tjekker hver handling i den samme rækkefølge: faste grænser først, derefter lofter og love, derefter ejerens regler og til sidst tilstanden. Faste grænser, f.eks. beskyttelse mod at loginoplysninger lækker, ophæves aldrig, heller ikke i full_access.