NeboAI
NeboAI
Kom i gang

Funktioner og godkendelser

En funktion navngiver en slags system, f.eks. mail eller et regnskab, og operationerne på det. Medarbejderpakker erklærer de funktioner, de har brug for; plugins erklærer dem, de leverer; ejeren forbinder de to ved ansættelsen. Godkendelser er knyttet til operationer, så de samme regler gælder, uanset hvilket system der udfylder funktionen.

Modellen

  • En funktion er et typet interface, aldrig et produkt. mail har operationerne mail.inbox.read, mail.inbox.search og mail.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ærkeBetydning
Kræver ikke godkendelseEn 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 godkendelseFlytter penge, kontakter nogen uden for virksomheden eller kan ikke fortrydes. Nebo spørger, før det bundne værktøj kører.
KritiskFlytning 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 iVirkning
ceiling i agent.jsonDe angivne operationer spørger altid ejeren for denne medarbejder. Den eneste værdi er "approval".
En lovs ceiling i virksomhedslagetDe angivne operationer er blokeret for alle medarbejdere.
En virksomhedslov med reserved_to: ownerDe 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.

TilstandAdfærd
automaticStandarden. Medarbejderen handler inden for sit job og spørger kun ved operationer, der kræver godkendelse, og ved ejerens spørgeregler.
askHvert kald, der ændrer noget, spørger, medmindre en tilladelsesregel dækker det.
planKun læse og planlægge. Et kald, der ændrer noget, kører ikke.
full_accessIntet 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.