Le modèle
- Une capacité est une interface typée, jamais un produit.
maila les opérationsmail.inbox.read,mail.inbox.searchetmail.message.send. - Un package d'employé liste dans
requires.interfacesles capacités dont son poste a besoin. - Un plugin fournit une capacité en liant ses opérations à ses propres commandes dans
interfaceBindings. - Une connexion est le plugin que le propriétaire a connecté pour cette capacité. Un déclencheur de surveillance qui nomme une capacité s'exécute sur cette connexion.
Déclarer ce dont un poste a besoin
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Nommez des capacités, pas des plugins. Un package d'employé qui requiert ledger fonctionne pour toutes les entreprises, quel que soit leur logiciel de comptabilité. N'utilisez requires.plugins que si un poste dépend vraiment d'un plugin précis.
Fournir une capacité
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Un plugin qui lie une opération mail.* fournit mail. Chaque liaison devient aussi un outil typé pour les employés, comme mail_message_send. La syntaxe des modèles est décrite dans la référence plugin.json.
Lorsqu'un workflow surveille une capacité, Nebo choisit le plugin installé qui la fournit, en privilégiant celui sur lequel cet employé a un compte, puis par ordre alphabétique. S'il n'y en a aucun, le workflow est conservé, marqué comme dégradé, et le propriétaire est informé de ce qu'il doit connecter.
Le catalogue
Nebo est livré avec un catalogue de capacités et de leurs opérations, dont ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring et incidents. Le catalogue est un vocabulaire commun, pas une barrière. Utilisez ses termes dès qu'ils conviennent, pour que les employés et les plugins de différents éditeurs se retrouvent ; un nouveau terme relève de la convention, pas de l'erreur.
Chaque opération porte l'une de ces trois marques.
| Marque | Signification |
|---|---|
| Libre | Une lecture, ou une action protectrice réversible qui perd son intérêt si elle attend, comme mettre en pause, annuler ou revenir en arrière. S'exécute sans demander. |
| Soumise à approbation | Déplace de l'argent, contacte quelqu'un en dehors de l'entreprise ou ne peut pas être annulée. Nebo demande avant l'exécution de l'outil lié. |
| Critique | Mouvement d'argent, conclusion d'un contrat, documents propres à l'entreprise ou pouvoir permanent d'agir sans surveillance. Toujours soumise à approbation ; le propriétaire accorde chacune par employé et par opération, et aucun réglage à l'échelle de l'employé ne l'assouplit. |
Le consentement à l'embauche
Lorsqu'un propriétaire embauche un employé, Nebo lit ses besoins dans le package : les capacités de requires.interfaces, les plugins de requires.plugins, et chaque capacité ou plugin nommé par un déclencheur de surveillance. Le propriétaire voit une seule phrase qui énonce ces besoins. L'embauche les accorde à cet employé sous forme d'autorisations permanentes. Les opérations soumises à approbation restent des éléments à approuver.
Installer un plugin, un serveur MCP, une application ou un skill vaut autorisation de l'utiliser ; ils ne s'activent pas un par un. Les capacités intégrées de Nebo sont regroupées en chat, file, shell, web, contacts, desktop, media et system.
Plafonds et lois
| Déclaré dans | Effet |
|---|---|
ceiling dans agent.json | Les opérations listées demandent toujours l'accord du propriétaire pour cet employé. La seule valeur possible est "approval". |
Le ceiling d'une loi dans la couche entreprise | Les opérations listées sont bloquées pour tous les employés. |
Une loi de l'entreprise avec reserved_to: owner | Les opérations listées nécessitent l'approbation du propriétaire lui-même, et cette approbation ne peut jamais être accordée à un employé. |
Modes d'autorisation
Chaque employé a un mode d'autorisation. Il tranche les appels qu'aucune règle ne règle, et le propriétaire peut le remplacer pour une seule exécution.
| Mode | Comportement |
|---|---|
automatic | Par défaut. L'employé agit dans le cadre de son poste et ne demande l'accord que pour les opérations soumises à approbation et les règles de demande du propriétaire. |
ask | Chaque appel qui modifie quelque chose demande l'accord, sauf si une règle d'autorisation le couvre. |
plan | Lecture et planification uniquement. Un appel qui modifie quelque chose ne s'exécute pas. |
full_access | Rien ne demande d'accord. Les règles de refus et les limites strictes s'appliquent toujours. |
Nebo vérifie chaque action dans le même ordre : d'abord les limites strictes, puis les plafonds et les lois, puis les règles du propriétaire, puis le mode. Les limites strictes, comme la protection des identifiants contre les fuites, ne sont jamais levées, pas même en full_access.