NeboAI
NeboAI
Começar

Publicação

Você publica na loja da NeboAI pelo servidor MCP da NeboAI. Conecte um cliente MCP, crie o item, envie os arquivos dele e mande uma versão para revisão. As mesmas ferramentas servem para skills, funcionários, plugins e apps.

Conectar

Adicione https://neboai.com/mcp a qualquer cliente MCP que aceite servidores remotos. O cliente descobre o servidor de autorização, se registra e faz seu login com OAuth e PKCE. Qualquer conta NeboAI pode se conectar. Os tokens de acesso duram uma hora e são renovados por 30 dias.

Conta de desenvolvedor

Qualquer pessoa com uma conta NeboAI pode publicar. Enviar uma versão e enviar arquivos usam sua conta de desenvolvedor, que é configurada para você, de graça, na primeira vez que você envia algo ou pede um token de envio. Não há taxa nem etapa de aprovação.

Para publicar em nome de uma equipe em vez de você mesmo, selecione a conta da equipe na sessão. Você precisa ser membro da equipe.

developer(resource: "account", action: "list")
developer(resource: "account", action: "select", slug: "example-team")

developer também pode configurar sua conta com antecedência (action: "create", opcional) e lista e seleciona namespaces (resource: "namespace"). O namespace selecionado passa a fazer parte de todo nome qualificado que você publicar.

Ferramentas

As ferramentas skill, agent e plugin compartilham o mesmo conjunto de ações. Os apps são publicados com a ferramenta agent.

AçãoConta de desenvolvedorFaz
createnão é necessáriaCria o item e o código de instalação dele.
updatenão é necessáriaAltera campos, conteúdo, versão ou visibilidade.
get, list, deletenão é necessáriaLê ou remove seus itens.
installnão é necessáriaInstala em um dos seus bots: id, botId e cascade para incluir as dependências.
bundle-tokenconfigurada automaticamenteUm token para enviar um zip de arquivos de texto.
binary-tokenconfigurada automaticamenteUm token para enviar binários, plugin.json, agent.json e interfaces de apps.
list-binaries, delete-binaryconfigurada automaticamenteGerencia os binários enviados.
submitconfigurada automaticamenteEnvia uma versão para revisão.
CampoSignificado
nameNome de exibição. O slug é gerado a partir dele.
descriptionUma linha, de 10 a 500 caracteres para enviar.
manifestContentO arquivo principal do item: SKILL.md, AGENT.md ou PLUGIN.md.
versionVersão semântica. Padrão 0.1.0.
visibilityprivate (padrão), loop (compartilhado com seus Canais) ou public.
categoryCategoria na loja.
longDescriptionO texto “O que faz” da loja (somente update).
sourceUrl, manifestUrlLinks opcionais.
dependenciesSó para funcionários. Veja Dependências.

A ferramenta marketplace faz buscas na loja e lista as categorias. A ferramenta pricing define o preço de um item; itens pagos exigem concluir o cadastro para recebimentos.

Publique uma skill

Crie a skill com o SKILL.md dela como conteúdo.

skill(action: "create", name: "invoice-totals",
      description: "Add up invoice line items, apply tax, and report the totals.",
      category: "finance", version: "1.0.0", manifestContent: "<contents of SKILL.md>")

Dê nome à skill com o name do frontmatter. O nome qualificado dela é @<namespace>/skills/<slug>, com o slug gerado a partir do nome de exibição, e os bots resolvem os nomes qualificados com base no name do frontmatter, então os dois precisam coincidir.

Se a skill tiver outros arquivos, envie a pasta como um zip. Se o zip tiver uma única pasta no nível superior, ela é removida automaticamente, e as pastas de build e de controle de versão são ignoradas.

skill(action: "bundle-token", id: "<skill id>")

cd invoice-totals && zip -r ../invoice-totals.zip . && cd ..
curl -X POST "https://neboai.com/api/v1/skills/<skill id>/bundle" \
  -H "Authorization: Bearer <token>" \
  -F file=@invoice-totals.zip
Regra do pacoteLimite
Tamanho do zip50 MB
Cada arquivo10 MB
Todos os arquivos50 MB
Tipos de arquivoTexto, código, dados, imagens, PDF e fontes, como .md, .py, .js, .ts, .json, .yaml, .csv, .html. Tudo o que estiver em scripts/, bin/ ou dist/ é aceito.
CaminhosSem .. e sem caminhos absolutos.

Torne a skill pública e envie uma versão.

skill(action: "update", id: "<skill id>", visibility: "public")
skill(action: "submit", id: "<skill id>", version: "1.0.0")

Publique um funcionário

Crie o funcionário com o AGENT.md dele como conteúdo e as dependências da loja.

agent(action: "create", name: "Support Coordinator",
      description: "Answers every customer message the day it arrives and escalates what it cannot settle.",
      version: "1.0.0", manifestContent: "<contents of AGENT.md>",
      dependencies: { skills: [ { qualifiedName: "@example-studio/skills/reply-drafting", id: "<skill id>", name: "reply-drafting" } ] })

Envie o agent.json com um token de binário. Funcionários não precisam de binário; config basta. Para incluir a pasta skills/ própria do funcionário, envie o pacote como bundle: AGENT.md, agent.json e skills/ em um único zip.

agent(action: "binary-token", id: "<agent id>")

curl -X POST "https://neboai.com/api/v1/developer/apps/<agent id>/binaries" \
  -H "Authorization: Bearer <token>" \
  -F config=@support-coordinator/agent.json

Mantenha as dependências no agent.json. Um agent.json enviado substitui a configuração armazenada, incluindo as dependências definidas com create ou update, e um update com dependencies substitui o agent.json armazenado. Quando usar os dois, coloque o mesmo objeto dependencies dentro do agent.json.

Dependências

dependencies tem as listas skills, agents e connectors. Cada entrada é {qualifiedName, id, name}; a NeboAI verifica primeiro o nome qualificado e depois o id. Um plugin fica listado em skills. Os plugins exigidos pelas skills citadas em agent.json são adicionados automaticamente. Quando um dono instala seu funcionário pela loja ou com o código dele, o bot instala junto as dependências de skills, plugins e funcionários.

Publique um plugin ou um app

Os plugins enviam um binário por plataforma com o plugin.json e as skills do plugin; veja Como distribuir um plugin. Um app só de página não precisa de binário: envie um bundle com bundle-token contendo AGENT.md (com artifact_type: app), agent.json, manifest.json, ui/ e qualquer skills/. Um app com sidecar usa o mesmo envio de binário com a ferramenta agent: o binário do sidecar como file com a platform dele, e a página como ui, um .tar.gz da pasta ui/. Veja Apps.

Revisão

O submit precisa do conteúdo do arquivo principal e de uma descrição de 10 a 500 caracteres. Cada envio é verificado. Uma verificação limpa pode ser aprovada automaticamente; tudo o que for sinalizado vai para revisão manual. A aprovação assina os binários e ativa a versão. Uma versão recusada volta a ser rascunho.

Status do itemSignificado
draftNão enviado, ou recusado.
pending_review, reviewAguardando revisão.
activeAprovado. Listado na loja quando a visibilidade é public.
revokedRetirado.

Códigos de instalação

Todo item recebe o código de instalação quando é criado: SKIL-, AGNT-, PLUG-, APPS-, CONN- ou COLL- seguido de oito caracteres. Digitar o código como mensagem em um chat do Nebo instala o item; veja Conceitos principais.