Bot
Um bot é uma cópia do Nebo em execução, num computador, num servidor ou num computador Nebo Cloud. Um bot contém funcionários, a respetiva memória, as skills e os plugins instalados e as ligações do proprietário. Tudo o que cria é instalado num bot.
Funcionário
Um funcionário é uma função com responsabilidades, como um técnico de contabilidade ou um coordenador de apoio. Tem uma persona, a sua própria memória, as skills de que precisa e, opcionalmente, fluxos de trabalho que executa por iniciativa própria. Uma função cria-se como um pacote de funcionário: uma persona AGENT.md e um agent.json opcional. O proprietário contrata-o a partir da loja ou com um código de instalação.
Os funcionários são genéricos. Um pacote descreve responsabilidades, nunca um produto específico. Indica as capacidades de que precisa, e o proprietário decide qual dos seus sistemas preenche cada uma.
Skill
Uma skill ensina os funcionários a fazer um tipo de trabalho. É uma pasta com um ficheiro SKILL.md e quaisquer ficheiros de apoio. Os funcionários veem uma lista das skills disponíveis e carregam uma com a ferramenta use_skill quando o trabalho o exige. Ver Skills.
Capacidade e ligação
Uma capacidade é um tipo de sistema com que uma função trabalha, como mail, calendar ou ledger. Cada capacidade tem operações com nome, como mail.message.send. As operações que movimentam dinheiro, contactam alguém fora da empresa ou não podem ser anuladas pedem aprovação.
Uma ligação é o sistema real do proprietário que preenche uma capacidade, fornecido por um plugin. Um pacote declara requires.interfaces; na contratação, o proprietário dá o seu consentimento e associa uma ligação. Ver Capacidades e aprovações.
Plugin
Um plugin é um binário de linha de comandos com um manifesto plugin.json. Dá aos funcionários um serviço ou programa sobre o qual agir, guarda uma conta por funcionário e pode fornecer operações de capacidades, eventos para fluxos de trabalho e mais. Ver Plugins.
Servidor MCP
Um servidor MCP é outra forma de dar ferramentas aos funcionários. O proprietário adiciona um servidor a um bot, e cada uma das suas ferramentas fica disponível para os funcionários. Ver MCP.
Fluxo de trabalho
Um fluxo de trabalho é trabalho que um funcionário faz sem que lho peçam. Vive no agent.json do funcionário e junta um gatilho, como um agendamento, um evento ou um plugin vigiado, a atividades que o funcionário executa. Ver Fluxos de trabalho.
App
Uma app é um funcionário com a sua própria janela. A sua página é HTML na pasta ui/ do pacote e comunica com o Nebo através do App SDK. Ver Apps.
Camada da empresa
A camada da empresa guarda o que é verdade para toda a empresa: o seu vocabulário, entidades, regras, leis, normas e material de referência. Vive em packs, como um COMPANY.md com pastas tipificadas ao lado. O proprietário pode sempre editá-la. Quando muda, cada funcionário lê a alteração e atualiza as suas próprias regras. Ver Persona e memória.
Equipa e Canal
Os funcionários de um bot podem trabalhar em equipa. Uma publicação para a equipa vai para o responsável; @Name chega a um membro e @everyone chega a todos. Ver Ajudantes e equipas. Um Canal é um espaço privado, só por convite, partilhado por bots e pessoas.
Código de instalação
Cada artefacto criado na loja recebe um código de instalação no formato PREFIX-XXXX-XXXX. Escreva o código como mensagem completa num chat do Nebo, e o bot instala o artefacto e as suas dependências.
| Prefixo | Instala |
|---|---|
SKIL- | Uma skill |
AGNT- | Um pacote de funcionário, com as suas skills, plugins e outras dependências |
PLUG- | Um plugin |
APPS- | Uma app |
CONN- | Um conector |
COLL- | Uma coleção de artefactos |
LOOP- | Entra num Canal (um convite, não um artefacto) |
NEBO- | Liga um bot a uma conta NeboAI (expira ao fim de cinco minutos) |
Loja
A loja da NeboAI é onde os proprietários contratam funcionários e instalam skills, plugins e apps. Os programadores publicam nela através do servidor MCP da NeboAI. Ver Publicação.