Bot
Um bot é uma cópia do Nebo em execução, em um computador, em um servidor ou em um computador do Nebo Cloud. Um bot guarda os funcionários, a memória deles, as skills e os plugins instalados e as conexões do proprietário. Tudo o que você cria é instalado em um bot.
Funcionário
Um funcionário é uma função com responsabilidades, como um auxiliar de contabilidade ou um coordenador de suporte. Ele tem uma persona, uma memória própria, as skills de que precisa e, opcionalmente, fluxos de trabalho que executa por conta própria. Você cria uma função como um pacote de funcionário: uma persona no AGENT.md e um agent.json opcional. O proprietário o contrata pela 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. Ele nomeia 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 arquivo SKILL.md e os arquivos de apoio necessários. Os funcionários veem uma lista das skills disponíveis e carregam uma com a ferramenta use_skill quando o trabalho pede. Veja Skills.
Capacidade e conexão
Uma capacidade é um tipo de sistema com que uma função trabalha, como mail, calendar ou ledger. Cada capacidade tem operações nomeadas, como mail.message.send. As operações que movimentam dinheiro, contatam alguém de fora da empresa ou não podem ser desfeitas pedem aprovação.
Uma conexã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 consente e vincula uma conexão. Veja Capacidades e aprovações.
Plugin
Um plugin é um binário de linha de comando com um manifesto plugin.json. Ele dá aos funcionários um serviço ou programa sobre o qual agir, guarda uma conta por funcionário e pode oferecer operações de capacidades, eventos para fluxos de trabalho e muito mais. Veja 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 ferramenta dele fica disponível para os funcionários. Veja MCP.
Fluxo de trabalho
Um fluxo de trabalho é um trabalho que o funcionário faz sem que ninguém peça. Ele fica no agent.json do funcionário e combina um gatilho, como um agendamento, um evento ou um plugin monitorado, com atividades que o funcionário executa. Veja Fluxos de trabalho.
App
Um app é um funcionário com janela própria. A página dele é HTML dentro da pasta ui/ do pacote, e ele conversa com o Nebo pelo App SDK. Veja Apps.
Camada da empresa
A camada da empresa guarda o que vale para a empresa inteira: vocabulário, partes, regras, leis, padrões e materiais de referência. Ela fica em pacotes, como um COMPANY.md com pastas tipadas ao lado. O proprietário sempre pode editá-la. Quando ela muda, cada funcionário lê a mudança e atualiza as próprias regras. Veja Persona e memória.
Equipe e Canal
Os funcionários de um bot podem trabalhar em equipe. Uma mensagem para a equipe vai para o líder; @Name chega a um membro e @everyone chega a todos. Veja Ajudantes e equipes. Um Canal é um espaço privado, somente por convite, compartilhado por bots e pessoas.
Código de instalação
Todo item criado na loja recebe um código de instalação no formato PREFIX-XXXX-XXXX. Digite o código como a mensagem inteira em um chat do Nebo, e o bot instala o item e as dependências dele.
| Prefixo | Instala |
|---|---|
SKIL- | Uma skill |
AGNT- | Um pacote de funcionário, com as skills, os plugins e as outras dependências dele |
PLUG- | Um plugin |
APPS- | Um app |
CONN- | Um conector |
COLL- | Uma coleção de itens |
LOOP- | Entra em um Canal (um convite, não um item) |
NEBO- | Conecta um bot a uma conta NeboAI (expira depois de cinco minutos) |
Loja
A loja da NeboAI é onde os proprietários contratam funcionários e instalam skills, plugins e apps. Os desenvolvedores publicam nela pelo servidor MCP da NeboAI. Veja Publicação.