NeboAI
NeboAI
Kom igång

Förmågor och godkännanden

En funktion namnger en typ av system, till exempel e-post eller en huvudbok, och åtgärderna på det. Medarbetarpaket deklarerar de funktioner de behöver; plugins deklarerar de funktioner de tillhandahåller; ägaren kopplar ihop de två vid anställningen. Godkännanden är knutna till åtgärder, så samma regler gäller oavsett vilket system som fyller funktionen.

Modellen

  • En funktion är ett typat gränssnitt, aldrig en produkt. mail har åtgärderna mail.inbox.read, mail.inbox.search och mail.message.send.
  • Ett medarbetarpaket listar de funktioner som dess roll behöver i requires.interfaces.
  • Ett plugin tillhandahåller en funktion genom att koppla dess åtgärder till sina egna kommandon i interfaceBindings.
  • En anslutning är det plugin som ägaren har anslutit för funktionen. En bevakningsutlösare som namnger en funktion körs på den.

Deklarera vad en roll behöver

{
  "requires": { "interfaces": ["mail", "ledger"] },
  "ceiling": { "ledger.bill.create": "approval" }
}

Namnge funktioner, inte plugins. Ett medarbetarpaket som kräver ledger fungerar för varje företag, oavsett vilket bokföringssystem det använder. Använd bara requires.plugins när en roll verkligen är beroende av ett visst plugin.

Tillhandahåll en funktion

"interfaceBindings": {
  "mail.inbox.read": "messages list --folder inbox",
  "mail.inbox.search": "messages search --query {query}",
  "mail.message.send": "messages send"
}

Ett plugin som kopplar någon mail.*-åtgärd tillhandahåller mail. Varje koppling blir också ett typat verktyg för medarbetare, till exempel mail_message_send. Mallsyntaxen finns i plugin.json-referensen.

När ett arbetsflöde bevakar en funktion väljer Nebo det installerade plugin som tillhandahåller den, i första hand ett som den här medarbetaren har ett konto på, därefter i alfabetisk ordning. Om inget finns behålls arbetsflödet, markeras som nedsatt, och ägaren får veta vad som behöver anslutas.

Katalogen

Nebo levereras med en katalog över funktioner och deras åtgärder, bland annat ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring och incidents. Katalogen är ett gemensamt ordförråd, inte ett staket. Använd dess termer där de passar så att medarbetare och plugins från olika utgivare möts; en ny term är en fråga om konvention, inte ett fel.

Varje åtgärd har en av tre markeringar.

MarkeringBetydelse
Kräver inte godkännandeEn läsning, eller en skyddande åtgärd som går att ångra och förlorar sitt värde om den väntar, till exempel pausa, avbryta eller rulla tillbaka. Körs utan att fråga.
Kräver godkännandeFlyttar pengar, kontaktar någon utanför företaget eller kan inte ångras. Nebo frågar innan det kopplade verktyget körs.
KritiskPenningöverföringar, ingående av avtal, företagets egna register eller stående befogenhet att agera utan tillsyn. Kräver alltid godkännande; ägaren beviljar var och en per medarbetare och per åtgärd, och ingen inställning för hela medarbetaren lättar på det.

Samtycke vid anställning

När en ägare anställer en medarbetare läser Nebo dess behov från paketet: funktionerna i requires.interfaces, pluginen i requires.plugins och varje funktion eller plugin som en bevakningsutlösare namnger. Ägaren ser en mening som anger behoven. Anställningen ger dem till medarbetaren som stående behörigheter. Åtgärder som kräver godkännande förblir godkännandeärenden.

Att installera ett plugin, en MCP-server, en app eller en färdighet är i sig tillståndet att använda den; de slås inte på en i taget. Nebos egna inbyggda förmågor är grupperade som chat, file, shell, web, contacts, desktop, media och system.

Tak och lagar

Deklareras iEffekt
ceiling i agent.jsonDe listade åtgärderna frågar alltid ägaren för den här medarbetaren. Det enda värdet är "approval".
En lags ceiling i företagslagretDe listade åtgärderna är spärrade för alla medarbetare.
En företagslag med reserved_to: ownerDe listade åtgärderna kräver ägarens eget godkännande, och det godkännandet kan aldrig ges till en medarbetare.

Behörighetslägen

Varje medarbetare har ett behörighetsläge. Det avgör de anrop som ingen regel avgör, och ägaren kan åsidosätta det för en enskild körning.

LägeBeteende
automaticStandardvalet. Medarbetaren agerar inom sitt jobb och frågar bara för åtgärder som kräver godkännande och för ägarens frågeregler.
askVarje anrop som ändrar något frågar, om inte en tillåtanderegel täcker det.
planBara läsa och planera. Ett anrop som ändrar något körs inte.
full_accessInget frågar. Nekanderegler och hårda gränser gäller fortfarande.

Nebo kontrollerar varje åtgärd i samma ordning: först hårda gränser, sedan tak och lagar, sedan ägarens regler och sist läget. Hårda gränser, som skyddet mot att inloggningsuppgifter läcker, hävs aldrig, inte ens i full_access.