Modellen
- En funksjon er et typet grensesnitt, aldri et produkt.
mailhar operasjonenemail.inbox.read,mail.inbox.searchogmail.message.send. - En ansattpakke lister opp funksjonene rollen trenger, i
requires.interfaces. - Et tillegg tilbyr en funksjon ved å binde operasjonene til sine egne kommandoer i
interfaceBindings. - En tilkobling er tillegget eieren har koblet til for den funksjonen. En overvåkingsutløser som nevner en funksjon, kjører på den.
Erklær hva en rolle trenger
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Nevn funksjoner, ikke tillegg. En ansattpakke som krever ledger, fungerer for alle bedrifter, uansett hvilket regnskapssystem de bruker. Bruk requires.plugins bare når en rolle virkelig er avhengig av ett bestemt tillegg.
Tilby en funksjon
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Et tillegg som binder en hvilken som helst mail.*-operasjon, tilbyr mail. Hver binding blir også et typet verktøy for ansatte, som mail_message_send. Malsyntaksen finner du i plugin.json-referansen.
Når en arbeidsflyt overvåker en funksjon, velger Nebo det installerte tillegget som tilbyr den, og foretrekker ett som denne ansatte har en konto på, deretter alfabetisk rekkefølge. Finnes ingen, beholdes arbeidsflyten, merkes som redusert, og eieren får vite hva som må kobles til.
Katalogen
Nebo leveres med en katalog over funksjoner og operasjonene deres, inkludert ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring og incidents. Katalogen er et felles vokabular, ikke et gjerde. Bruk begrepene der de passer, slik at ansatte og tillegg fra ulike utgivere møtes; et nytt begrep er et spørsmål om konvensjon, ikke en feil.
Hver operasjon har én av tre merkinger.
| Merking | Betydning |
|---|---|
| Åpen | En lesing, eller en beskyttende handling som kan reverseres og mister verdien hvis den venter, som pause, avbryt eller rull tilbake. Kjører uten å spørre. |
| Sperret | Flytter penger, kontakter noen utenfor bedriften eller kan ikke angres. Nebo spør før det bundne verktøyet kjører. |
| Kritisk | Pengeoverføringer, inngåelse av kontrakter, bedriftens egne registre, eller stående fullmakt til å handle uten tilsyn. Alltid sperret; eieren gir hver enkelt per ansatt og per operasjon, og ingen innstilling for hele den ansatte løsner på den. |
Samtykke ved ansettelse
Når en eier ansetter en ansatt, leser Nebo behovene fra pakken: funksjonene i requires.interfaces, tilleggene i requires.plugins, og hver funksjon eller hvert tillegg en overvåkingsutløser nevner. Eieren ser én setning som oppgir disse behovene. Ansettelsen gir dem til den ansatte som faste tillatelser. Sperrede operasjoner forblir godkjenningselementer.
Å installere et tillegg, en MCP-server, en app eller en ferdighet er i seg selv tillatelsen til å bruke det; de slås ikke på én etter én. Nebos egne innebygde evner er gruppert som chat, file, shell, web, contacts, desktop, media og system.
Tak og lover
| Erklært i | Virkning |
|---|---|
ceiling i agent.json | De oppførte operasjonene spør alltid eieren for denne ansatte. Den eneste verdien er "approval". |
En lovs ceiling i bedriftslaget | De oppførte operasjonene er blokkert for alle ansatte. |
En bedriftslov med reserved_to: owner | De oppførte operasjonene krever eierens egen godkjenning, og den godkjenningen kan aldri gis til en ansatt. |
Tillatelsesmoduser
Hver ansatt har en tillatelsesmodus. Den avgjør kallene som ingen regel avgjør, og eieren kan overstyre den for én enkelt kjøring.
| Modus | Oppførsel |
|---|---|
automatic | Standard. Den ansatte handler innenfor jobben sin og spør bare om sperrede operasjoner og eierens spør-regler. |
ask | Hvert kall som endrer noe, spør, med mindre en tillatelsesregel dekker det. |
plan | Bare lese og planlegge. Et kall som endrer noe, kjører ikke. |
full_access | Ingenting spør. Avslagsregler og harde grenser gjelder fortsatt. |
Nebo sjekker hver handling i samme rekkefølge: harde grenser først, deretter tak og lover, deretter eierens regler, deretter modusen. Harde grenser, som å beskytte påloggingsopplysninger mot lekkasje, oppheves aldri, ikke engang i full_access.