NeboAI
NeboAI
Começar

Capacidades e aprovações

Uma capacidade designa um tipo de sistema, como o email ou um livro de contas, e as operações sobre ele. Os pacotes de funcionário declaram as capacidades de que precisam; os plugins declaram as que fornecem; o proprietário liga uns aos outros na contratação. As aprovações estão associadas às operações, por isso as mesmas regras aplicam-se seja qual for o sistema que preenche a capacidade.

O modelo

  • Uma capacidade é uma interface tipificada, 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 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.

MarcaSignificado
LivreUma 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çãoMovimenta dinheiro, contacta alguém fora da empresa ou não pode ser anulada. O Nebo pergunta antes de a ferramenta associada correr.
CríticaMovimentaçã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 emEfeito
ceiling em agent.jsonAs 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 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. Este decide as chamadas que nenhuma regra resolve, e o proprietário pode substituí-lo numa única execução.

ModoComportamento
automaticA 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.
askTodas as chamadas que alteram alguma coisa perguntam, a menos que uma regra de permissão as cubra.
planSó leitura e planeamento. Uma chamada que altere alguma coisa não corre.
full_accessNada 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.