El modelo
- Una capacidad es una interfaz tipada, nunca un producto.
mailtiene las operacionesmail.inbox.read,mail.inbox.searchymail.message.send. - Un paquete de empleado enumera las capacidades que necesita su puesto en
requires.interfaces. - Un plugin ofrece una capacidad vinculando sus operaciones a sus propios comandos en
interfaceBindings. - Una conexión es el plugin que el propietario ha conectado para esa capacidad. Un activador de vigilancia que nombra una capacidad se ejecuta sobre ella.
Declara lo que necesita un puesto
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Nombra capacidades, no plugins. Un paquete de empleado que requiere ledger funciona en cualquier empresa, use el sistema de contabilidad que use. Usa requires.plugins solo cuando un puesto dependa de verdad de un plugin concreto.
Ofrece una capacidad
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Un plugin que vincula cualquier operación mail.* ofrece mail. Cada vinculación se convierte además en una herramienta tipada para los empleados, como mail_message_send. La sintaxis de las plantillas está en la referencia de plugin.json.
Cuando un flujo de trabajo vigila una capacidad, Nebo elige el plugin instalado que la ofrece, dando preferencia a uno en el que este empleado tenga cuenta y, después, por orden alfabético. Si no hay ninguno, el flujo de trabajo se conserva, se marca como degradado y se le dice al propietario qué tiene que conectar.
El catálogo
Nebo incluye un catálogo de capacidades y sus operaciones, entre ellas ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring e incidents. El catálogo es un vocabulario compartido, no una valla. Usa sus términos siempre que encaje alguno para que empleados y plugins de distintos editores se entiendan; un término nuevo es una cuestión de convención, no un error.
Cada operación lleva una de estas tres marcas.
| Marca | Significado |
|---|---|
| Sin aprobación | Una lectura, o una acción de protección que es reversible y pierde su valor si espera, como pausar, cancelar o revertir. Se ejecuta sin preguntar. |
| Con aprobación | Mueve dinero, contacta con alguien de fuera de la empresa o no se puede deshacer. Nebo pregunta antes de que se ejecute la herramienta vinculada. |
| Crítica | Movimientos de dinero, formalización de contratos, los propios registros de la empresa o autoridad permanente para actuar sin supervisión. Siempre sujeta a aprobación; el propietario concede cada una por empleado y por operación, y ningún ajuste general del empleado la relaja. |
Consentimiento al contratar
Cuando un propietario contrata a un empleado, Nebo lee sus necesidades en el paquete: las capacidades de requires.interfaces, los plugins de requires.plugins y cada capacidad o plugin que nombre un activador de vigilancia. El propietario ve una sola frase que expone esas necesidades. Contratarlo se las concede a ese empleado como permisos permanentes. Las operaciones con aprobación siguen siendo elementos de aprobación.
Instalar un plugin, un servidor MCP, una app o una skill ya supone el permiso para usarlo; no se activan uno por uno. Las capacidades integradas de Nebo se agrupan en chat, file, shell, web, contacts, desktop, media y system.
Límites y leyes
| Se declara en | Efecto |
|---|---|
ceiling en agent.json | Las operaciones indicadas siempre piden permiso al propietario para este empleado. El único valor es "approval". |
El ceiling de una ley en la capa de empresa | Las operaciones indicadas están bloqueadas para todos los empleados. |
Una ley de la empresa con reserved_to: owner | Las operaciones indicadas necesitan la aprobación del propio propietario, y esa aprobación nunca se puede conceder a un empleado. |
Modos de permisos
Cada empleado tiene un modo de permisos. Decide las llamadas que ninguna regla resuelve, y el propietario puede anularlo para una sola ejecución.
| Modo | Comportamiento |
|---|---|
automatic | El valor predeterminado. El empleado actúa dentro de su puesto y solo pregunta en las operaciones con aprobación y en las reglas de consulta del propietario. |
ask | Cada llamada que cambia algo pregunta, salvo que la cubra una regla de permiso. |
plan | Solo leer y planificar. Una llamada que cambia algo no se ejecuta. |
full_access | No se pregunta nada. Las reglas de denegación y los límites estrictos se siguen aplicando. |
Nebo comprueba cada acción siempre en el mismo orden: primero los límites estrictos, después los límites y las leyes, luego las reglas del propietario y, por último, el modo. Los límites estrictos, como impedir que se filtren credenciales, nunca se levantan, ni siquiera en full_access.