NeboAI
NeboAI
Empezar

Capacidades y aprobaciones

Una capacidad nombra un tipo de sistema, como el correo o un libro de contabilidad, y las operaciones que se hacen en él. Los paquetes de empleado declaran las capacidades que necesitan; los plugins declaran las que ofrecen; el propietario conecta ambas cosas al contratar. Las aprobaciones van ligadas a las operaciones, así que las mismas reglas se aplican sea cual sea el sistema que cubra la capacidad.

El modelo

  • Una capacidad es una interfaz tipada, nunca un producto. mail tiene las operaciones mail.inbox.read, mail.inbox.search y mail.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.

MarcaSignificado
Sin aprobaciónUna 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ónMueve 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íticaMovimientos 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 enEfecto
ceiling en agent.jsonLas operaciones indicadas siempre piden permiso al propietario para este empleado. El único valor es "approval".
El ceiling de una ley en la capa de empresaLas operaciones indicadas están bloqueadas para todos los empleados.
Una ley de la empresa con reserved_to: ownerLas 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.

ModoComportamiento
automaticEl 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.
askCada llamada que cambia algo pregunta, salvo que la cubra una regla de permiso.
planSolo leer y planificar. Una llamada que cambia algo no se ejecuta.
full_accessNo 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.