NeboAI
NeboAI
Comenzar

Capacidades y aprobaciones

Una capacidad nombra un tipo de sistema, como el correo o un libro contable, 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 ambos al contratar. Las aprobaciones van ligadas a las operaciones, así que las mismas reglas aplican sin importar qué sistema cubra la capacidad.

El modelo

  • Una capacidad es una interfaz tipificada, nunca un producto. mail tiene las operaciones mail.inbox.read, mail.inbox.search y mail.message.send.
  • Un paquete de empleado enumera en requires.interfaces las capacidades que necesita su puesto.
  • Un plugin ofrece una capacidad vinculando sus operaciones a sus propios comandos en interfaceBindings.
  • Una conexión es el plugin que el propietario conectó para esa capacidad. Un disparador 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 para cualquier empresa, sin importar qué sistema contable use. Usa requires.plugins solo cuando un puesto de verdad depende de un plugin específico.

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 también se convierte en una herramienta tipificada 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 una cuenta, y luego 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é debe 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 y incidents. El catálogo es un vocabulario compartido, no una barrera. Usa sus términos siempre que encaje uno, para que los empleados y los plugins de distintos publicadores coincidan; un término nuevo es una cuestión de convención, no un error.

Cada operación lleva una de 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 a alguien fuera de la empresa o no se puede deshacer. Nebo pregunta antes de que se ejecute la herramienta vinculada.
CríticaMovimiento de dinero, celebración de contratos, los registros propios de la empresa o autoridad permanente para actuar sin supervisión. Siempre requiere aprobación; el propietario concede cada una por empleado y por operación, y ninguna configuración 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 nombra un disparador de vigilancia. El propietario ve una sola frase que expresa esas necesidades. Al contratarlo, se le conceden a ese empleado como permisos permanentes. Las operaciones con aprobación siguen siendo elementos por aprobar.

Instalar un plugin, un servidor MCP, una app o una skill ya es en sí la autorización para usarlo; no se activan uno por uno. Las capacidades integradas propias de Nebo se agrupan como chat, file, shell, web, contacts, desktop, media y system.

Límites y leyes

Se declara enEfecto
ceiling en agent.jsonLas operaciones indicadas siempre le piden aprobación 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 le puede conceder a un empleado.

Modos de permiso

Cada empleado tiene un modo de permiso. Este decide las llamadas que ninguna regla resuelve, y el propietario puede cambiarlo para una sola ejecución.

ModoComportamiento
automaticEl modo 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, a menos que una regla de permiso la cubra.
planSolo leer y planear. Una llamada que cambia algo no se ejecuta.
full_accessNo se pregunta nada. Las reglas de denegación y los límites estrictos siguen aplicándose.

Nebo revisa cada acción en el mismo orden: primero los límites estrictos, luego los límites y las leyes, luego las reglas del propietario y, por último, el modo. Los límites estrictos, como proteger las credenciales para que no se filtren, nunca se levantan, ni siquiera en full_access.