Il modello
- Una capability è un’interfaccia tipizzata, mai un prodotto.
mailha le operazionimail.inbox.read,mail.inbox.searchemail.message.send. - Un pacchetto dipendente elenca in
requires.interfacesle capability di cui il suo ruolo ha bisogno. - Un plugin fornisce una capability collegando le sue operazioni ai propri comandi in
interfaceBindings. - Una connessione è il plugin che il titolare ha collegato per quella capability. Un trigger di monitoraggio che indica una capability viene eseguito su di essa.
Dichiara di cosa ha bisogno un ruolo
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Indica capability, non plugin. Un pacchetto dipendente che richiede ledger funziona per ogni azienda, qualunque sistema contabile usi. Usa requires.plugins solo quando un ruolo dipende davvero da un plugin specifico.
Fornisci una capability
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Un plugin che collega una qualsiasi operazione mail.* fornisce mail. Ogni collegamento diventa anche uno strumento tipizzato per i dipendenti, come mail_message_send. La sintassi dei modelli è nel riferimento di plugin.json.
Quando un flusso di lavoro monitora una capability, Nebo sceglie il plugin installato che la fornisce, preferendo quello su cui questo dipendente ha un account, poi in ordine alfabetico. Se non ce n’è nessuno, il flusso di lavoro viene conservato, segnato come limitato, e il titolare viene informato di cosa collegare.
Il catalogo
Nebo include un catalogo di capability e delle loro operazioni, tra cui ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring e incidents. Il catalogo è un vocabolario condiviso, non un recinto. Usa i suoi termini ogni volta che ce n’è uno adatto, così dipendenti e plugin di editori diversi si incontrano; un termine nuovo è una questione di convenzione, non un errore.
Ogni operazione ha uno di tre contrassegni.
| Contrassegno | Significato |
|---|---|
| Libera | Una lettura, o un’azione di protezione reversibile che perde valore se aspetta, come mettere in pausa, annullare o ripristinare. Viene eseguita senza chiedere. |
| Soggetta ad approvazione | Sposta denaro, contatta qualcuno fuori dall’azienda o non può essere annullata. Nebo chiede prima che lo strumento collegato venga eseguito. |
| Critica | Movimenti di denaro, conclusione di contratti, i registri dell’azienda stessa o l’autorità permanente di agire senza supervisione. Sempre soggetta ad approvazione; il titolare la concede una per una, per dipendente e per operazione, e nessuna impostazione generale del dipendente la allenta. |
Consenso all’assunzione
Quando un titolare assume un dipendente, Nebo legge i suoi requisiti dal pacchetto: le capability in requires.interfaces, i plugin in requires.plugins e ogni capability o plugin indicato da un trigger di monitoraggio. Il titolare vede una sola frase che riassume quei requisiti. L’assunzione li concede a quel dipendente come permessi permanenti. Le operazioni soggette ad approvazione restano voci da approvare.
Installare un plugin, un server MCP, un’app o una skill equivale già a concederne l’uso; non vengono attivati uno per uno. Le funzioni integrate di Nebo sono raggruppate in chat, file, shell, web, contacts, desktop, media e system.
Limiti e leggi
| Dichiarato in | Effetto |
|---|---|
ceiling in agent.json | Per questo dipendente, le operazioni elencate chiedono sempre al titolare. L’unico valore è "approval". |
Il ceiling di una legge nel livello aziendale | Le operazioni elencate sono bloccate per ogni dipendente. |
Una legge aziendale con reserved_to: owner | Le operazioni elencate richiedono l’approvazione del titolare in persona, e quell’approvazione non può mai essere concessa a un dipendente. |
Modalità dei permessi
Ogni dipendente ha una modalità dei permessi. Decide le chiamate che nessuna regola stabilisce, e il titolare può sostituirla per una singola esecuzione.
| Modalità | Comportamento |
|---|---|
automatic | Il valore predefinito. Il dipendente agisce nell’ambito del suo lavoro e chiede solo per le operazioni soggette ad approvazione e per le regole di richiesta del titolare. |
ask | Ogni chiamata che modifica qualcosa chiede conferma, a meno che una regola di autorizzazione non la copra. |
plan | Solo lettura e pianificazione. Una chiamata che modifica qualcosa non viene eseguita. |
full_access | Non chiede nulla. Le regole di divieto e i limiti rigidi restano validi. |
Nebo controlla ogni azione sempre nello stesso ordine: prima i limiti rigidi, poi i limiti e le leggi, poi le regole del titolare, poi la modalità. I limiti rigidi, come la protezione delle credenziali dalle fughe di dati, non vengono mai tolti, nemmeno in full_access.