NeboAI
NeboAI
Começar

Capacidades e aprovações

Uma capacidade nomeia um tipo de sistema, como e-mail ou um livro contábil, e as operações sobre ele. Os pacotes de funcionário declaram as capacidades de que precisam; os plugins declaram as que oferecem; o proprietário conecta os dois na contratação. As aprovações ficam ligadas às operações, então as mesmas regras valem seja qual for o sistema que preenche a capacidade.

O modelo

  • Uma capacidade é uma interface tipada, nunca um produto. mail tem as operações mail.inbox.read, mail.inbox.search e mail.message.send.
  • Um pacote de funcionário lista em requires.interfaces as 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çãoSignificado
Sem aprovaçãoUma 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çãoMovimenta dinheiro, contata alguém de fora da empresa ou não pode ser desfeita. O Nebo pergunta antes de a ferramenta vinculada rodar.
CríticaMovimentaçã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 emEfeito
ceiling no agent.jsonAs 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 empresaAs operações listadas ficam bloqueadas para todos os funcionários.
Uma lei da empresa com reserved_to: ownerAs 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.

ModoComportamento
automaticO 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.
askToda chamada que altera algo pede autorização, a menos que uma regra de permissão a cubra.
planSó leitura e planejamento. Uma chamada que altera algo não roda.
full_accessNada 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.