O modelo
- Uma capacidade é uma interface tipada, nunca um produto.
mailtem as operaçõesmail.inbox.read,mail.inbox.searchemail.message.send. - Um pacote de funcionário lista em
requires.interfacesas capacidades de que a função precisa. - Um plugin oferece uma capacidade vinculando as operações dela aos próprios comandos em
interfaceBindings. - Uma conexão é o plugin que o proprietário conectou para essa capacidade. Um gatilho de monitoramento que nomeia uma capacidade roda sobre ela.
Declare do que uma função precisa
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Nomeie capacidades, não plugins. Um pacote de funcionário que exige ledger funciona para qualquer empresa, seja qual for o sistema de contabilidade que ela usa. Use requires.plugins somente quando uma função realmente depender de um plugin específico.
Ofereça uma capacidade
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Um plugin que vincula qualquer operação mail.* oferece mail. Cada vínculo também vira uma ferramenta tipada para os funcionários, como mail_message_send. A sintaxe do template está na referência do plugin.json.
Quando um fluxo de trabalho monitora uma capacidade, o Nebo escolhe o plugin instalado que a oferece, dando preferência a um em que este funcionário tenha conta e, depois, à ordem alfabética. Se não houver nenhum, o fluxo de trabalho é mantido, marcado como degradado, e o proprietário é avisado sobre o que conectar.
O catálogo
O Nebo inclui um catálogo de capacidades e suas operações, incluindo ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring e incidents. O catálogo é um vocabulário compartilhado, não uma cerca. Use os termos dele sempre que algum se encaixar, para que funcionários e plugins de publicadores diferentes se encontrem; um termo novo é questão de convenção, não um erro.
Cada operação leva uma de três marcações.
| Marcação | Significado |
|---|---|
| Sem aprovação | Uma leitura, ou um ato de proteção reversível que perde o valor se esperar, como pausar, cancelar ou reverter. Roda sem perguntar. |
| Com aprovação | Movimenta dinheiro, contata alguém de fora da empresa ou não pode ser desfeita. O Nebo pergunta antes de a ferramenta vinculada rodar. |
| Crítica | Movimentação de dinheiro, formação de contratos, os próprios registros da empresa ou autoridade permanente para agir sem supervisão. Sempre sujeita a aprovação; o proprietário concede cada uma por funcionário e por operação, e nenhuma configuração geral do funcionário a afrouxa. |
Consentimento na contratação
Quando um proprietário contrata um funcionário, o Nebo lê as necessidades dele no pacote: as capacidades em requires.interfaces, os plugins em requires.plugins e cada capacidade ou plugin que um gatilho de monitoramento nomeia. O proprietário vê uma frase que resume essas necessidades. A contratação as concede a esse funcionário como permissões permanentes. As operações com aprovação continuam sendo itens de aprovação.
Instalar um plugin, um servidor MCP, um app ou uma skill já é, por si só, a autorização para usá-lo; eles não são ativados um a um. As habilidades integradas do próprio Nebo são agrupadas como chat, file, shell, web, contacts, desktop, media e system.
Limites e leis
| Declarado em | Efeito |
|---|---|
ceiling no agent.json | As operações listadas sempre pedem autorização ao proprietário para este funcionário. O único valor é "approval". |
O ceiling de uma lei na camada da empresa | As operações listadas ficam bloqueadas para todos os funcionários. |
Uma lei da empresa com reserved_to: owner | As operações listadas precisam da aprovação do próprio proprietário, e essa aprovação nunca pode ser concedida a um funcionário. |
Modos de permissão
Cada funcionário tem um modo de permissão. Ele decide as chamadas que nenhuma regra resolve, e o proprietário pode substituí-lo em uma única execução.
| Modo | Comportamento |
|---|---|
automatic | O padrão. O funcionário age dentro da sua função e só pede autorização para operações com aprovação e para as regras de consulta do proprietário. |
ask | Toda chamada que altera algo pede autorização, a menos que uma regra de permissão a cubra. |
plan | Só leitura e planejamento. Uma chamada que altera algo não roda. |
full_access | Nada pede autorização. As regras de negação e os limites rígidos continuam valendo. |
O Nebo verifica cada ação sempre na mesma ordem: primeiro os limites rígidos, depois os limites e as leis, depois as regras do proprietário e, por fim, o modo. Os limites rígidos, como proteger credenciais contra vazamento, nunca são suspensos, nem mesmo em full_access.