NeboAI
NeboAI
Kom i gang

Funksjoner og godkjenninger

En funksjon navngir en type system, som e-post eller en hovedbok, og operasjonene på det. Ansattpakker erklærer funksjonene de trenger; tillegg erklærer dem de tilbyr; eieren kobler de to sammen ved ansettelse. Godkjenninger er knyttet til operasjoner, så de samme reglene gjelder uansett hvilket system som fyller funksjonen.

Modellen

  • En funksjon er et typet grensesnitt, aldri et produkt. mail har operasjonene mail.inbox.read, mail.inbox.search og mail.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.

MerkingBetydning
ÅpenEn 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.
SperretFlytter penger, kontakter noen utenfor bedriften eller kan ikke angres. Nebo spør før det bundne verktøyet kjører.
KritiskPengeoverfø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 iVirkning
ceiling i agent.jsonDe oppførte operasjonene spør alltid eieren for denne ansatte. Den eneste verdien er "approval".
En lovs ceiling i bedriftslagetDe oppførte operasjonene er blokkert for alle ansatte.
En bedriftslov med reserved_to: ownerDe 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.

ModusOppførsel
automaticStandard. Den ansatte handler innenfor jobben sin og spør bare om sperrede operasjoner og eierens spør-regler.
askHvert kall som endrer noe, spør, med mindre en tillatelsesregel dekker det.
planBare lese og planlegge. Et kall som endrer noe, kjører ikke.
full_accessIngenting 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.