O modelo
- Uma capacidade é uma interface tipificada, 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 sua função precisa. - Um plugin fornece uma capacidade associando as respetivas operações aos seus próprios comandos em
interfaceBindings. - Uma ligação é o plugin que o proprietário ligou para essa capacidade. Um gatilho de vigilância que indica uma capacidade corre sobre ela.
Declarar aquilo de que uma função precisa
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Indique capacidades, não plugins. Um pacote de funcionário que exige ledger funciona em qualquer empresa, seja qual for o sistema de contabilidade que use. Use requires.plugins apenas quando uma função depende mesmo de um plugin específico.
Fornecer 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 associa qualquer operação mail.* fornece mail. Cada associação torna-se também uma ferramenta tipificada para os funcionários, como mail_message_send. A sintaxe dos modelos está na referência do plugin.json.
Quando um fluxo de trabalho vigia uma capacidade, o Nebo escolhe o plugin instalado que a fornece, dando preferência a um em que este funcionário tenha conta e, depois, por ordem alfabética. Se não houver nenhum, o fluxo de trabalho é mantido, marcado como degradado, e o proprietário é informado do que deve ligar.
O catálogo
O Nebo inclui um catálogo de capacidades e das 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 partilhado, não uma vedação. Use os seus termos sempre que um se adeque, para que funcionários e plugins de editores diferentes se encontrem; um termo novo é uma questão de convenção, não um erro.
Cada operação tem uma de três marcas.
| Marca | Significado |
|---|---|
| Livre | Uma leitura, ou um ato de proteção que é reversível e perde valor se esperar, como pausar, cancelar ou reverter. Corre sem perguntar. |
| Sujeita a aprovação | Movimenta dinheiro, contacta alguém fora da empresa ou não pode ser anulada. O Nebo pergunta antes de a ferramenta associada correr. |
| Crítica | Movimentação de dinheiro, celebração de contratos, os registos da própria 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 definição geral do funcionário a flexibiliza. |
Consentimento na contratação
Quando um proprietário contrata um funcionário, o Nebo lê as suas necessidades a partir do pacote: as capacidades em requires.interfaces, os plugins em requires.plugins e cada capacidade ou plugin indicado num gatilho de vigilância. O proprietário vê uma frase que indica essas necessidades. A contratação concede-as a esse funcionário como permissões permanentes. As operações sujeitas a aprovação continuam a ser pedidos de aprovação.
Instalar um plugin, um servidor MCP, uma app ou uma skill é, em si mesmo, a autorização para o usar; não são ativados um a um. As capacidades integradas do próprio Nebo estão agrupadas como chat, file, shell, web, contacts, desktop, media e system.
Limites e leis
| Declarado em | Efeito |
|---|---|
ceiling em agent.json | As operações listadas pedem sempre 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. Este decide as chamadas que nenhuma regra resolve, e o proprietário pode substituí-lo numa única execução.
| Modo | Comportamento |
|---|---|
automatic | A predefinição. O funcionário age dentro da sua função e só pergunta nas operações sujeitas a aprovação e nas regras de pergunta do proprietário. |
ask | Todas as chamadas que alteram alguma coisa perguntam, a menos que uma regra de permissão as cubra. |
plan | Só leitura e planeamento. Uma chamada que altere alguma coisa não corre. |
full_access | Nada pergunta. As regras de negação e os limites rígidos continuam a aplicar-se. |
O Nebo verifica cada ação sempre pela mesma ordem: primeiro os limites rígidos, depois os limites de aprovação e as leis, depois as regras do proprietário e, por fim, o modo. Os limites rígidos, como impedir a fuga de credenciais, nunca são levantados, nem mesmo em full_access.