NeboAI
NeboAI
Começar

Conceitos básicos

Comece pela empresa e pelas responsabilidades que ela precisa ver resolvidas. Os funcionários são responsáveis por elas. As capacidades descrevem os sistemas de que uma função precisa, e as conexões os fornecem. As skills ensinam o trabalho, os fluxos de trabalho decidem quando ele acontece e a camada da empresa fornece as regras. Esta página define cada termo uma vez; o restante da documentação parte daqui.

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.

PrefixoInstala
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.