NeboAI
NeboAI
Começar

Publicação

Publica na loja da NeboAI através do servidor MCP da NeboAI. Ligue um cliente MCP, crie o artefacto, carregue os seus ficheiros e submeta uma versão para revisão. As mesmas ferramentas servem para skills, funcionários, plugins e apps.

Ligar

Adicione https://neboai.com/mcp a qualquer cliente MCP que suporte servidores remotos. O cliente descobre o servidor de autorização, regista-se e inicia a sua sessão com OAuth e PKCE. Qualquer conta NeboAI se pode ligar. Os tokens de acesso duram uma hora e renovam-se durante 30 dias.

Conta de programador

Qualquer pessoa com uma conta NeboAI pode publicar. Submeter uma versão e carregar ficheiros usa a sua conta de programador, que é configurada para si, gratuitamente, da primeira vez que submete ou pede um token de carregamento. Não há taxa nem passo de aprovação.

Para publicar em nome de uma equipa e não em seu nome, selecione a conta da equipa para a sessão. Tem de ser membro da equipa.

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

developer também pode configurar a sua conta antecipadamente (action: "create", opcional) e lista e seleciona espaços de nomes (resource: "namespace"). O espaço de nomes selecionado passa a fazer parte de todos os nomes qualificados que publicar.

Ferramentas

As ferramentas skill, agent e plugin partilham um mesmo conjunto de ações. As apps são publicadas com a ferramenta agent.

AçãoConta de programadorFaz
createnão é necessáriaCria o artefacto e o seu código de instalação.
updatenão é necessáriaAltera campos, conteúdo, versão ou visibilidade.
get, list, deletenão é necessáriaLê ou remove os seus artefactos.
installnão é necessáriaInstala num dos seus bots: id, botId e cascade para incluir as dependências.
bundle-tokenconfigurada automaticamenteUm token para carregar um zip de ficheiros de texto.
binary-tokenconfigurada automaticamenteUm token para carregar binários, plugin.json, agent.json e interfaces de apps.
list-binaries, delete-binaryconfigurada automaticamenteGere os binários carregados.
submitconfigurada automaticamenteSubmete uma versão para revisão.
CampoSignificado
nameNome apresentado. O slug é gerado a partir dele.
descriptionUma linha, de 10 a 500 carateres para submeter.
manifestContentO ficheiro principal do artefacto: SKILL.md, AGENT.md ou PLUGIN.md.
versionVersão semântica. Predefinição 0.1.0.
visibilityprivate (predefinição), loop (partilhado com os seus Canais) ou public.
categoryCategoria na loja.
longDescriptionO texto «O que faz» da loja (só update).
sourceUrl, manifestUrlLigações opcionais.
dependenciesSó funcionários. Ver Dependências.

A ferramenta marketplace pesquisa a loja e lista as categorias. A ferramenta pricing define o preço de um artefacto; os artefactos pagos exigem concluir a configuração dos pagamentos.

Publicar uma skill

Crie a skill com o seu SKILL.md 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 seu nome qualificado é @<namespace>/skills/<slug>, com o slug gerado a partir do nome apresentado, e os bots resolvem os nomes qualificados com base no name do frontmatter, por isso os dois têm de coincidir.

Se a skill tiver outros ficheiros, carregue a pasta como zip. Uma única pasta de topo no zip é removida automaticamente, e as pastas de compilação e de controlo de versões 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 ficheiro10 MB
Todos os ficheiros50 MB
Tipos de ficheiroTexto, código, dados, imagens, PDF e tipos de letra, como .md, .py, .js, .ts, .json, .yaml, .csv, .html. Tudo o que estiver em scripts/, bin/ ou dist/ é aceite.
CaminhosSem .. e sem caminhos absolutos.

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

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

Publicar um funcionário

Crie o funcionário com o seu AGENT.md como conteúdo e as suas 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" } ] })

Carregue o agent.json com um token de binário. Os funcionários não precisam de binário; config chega. Para incluir a pasta skills/ do próprio funcionário, carregue antes o pacote como bundle: AGENT.md, agent.json e skills/ num só 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 carregado substitui a configuração guardada, incluindo as dependências definidas com create ou update, e um update com dependencies substitui o agent.json guardado. Quando usar ambos, coloque o mesmo objeto dependencies dentro do agent.json.

Dependências

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

Publicar um plugin ou uma app

Os plugins carregam um binário por plataforma, com o plugin.json e as skills do plugin; ver Lançar um plugin. Uma app só com página não precisa de binário: carregue um único bundle com bundle-token que contenha AGENT.md (com artifact_type: app), agent.json, manifest.json, ui/ e eventuais skills/. Uma app com sidecar usa o mesmo carregamento de binários com a ferramenta agent: o binário do sidecar como file com a respetiva platform, e a página como ui, um .tar.gz da pasta ui/. Ver Apps.

Revisão

submit precisa do conteúdo do ficheiro principal e de uma descrição de 10 a 500 carateres. Cada submissão é analisada. Uma análise sem problemas pode ser aprovada automaticamente; tudo o que for sinalizado segue para revisão manual. A aprovação assina os binários que existam e torna a versão ativa. Uma versão rejeitada volta a rascunho.

Estado do artefactoSignificado
draftNão submetido, ou rejeitado.
pending_review, reviewA aguardar revisão.
activeAprovado. Listado na loja quando a visibilidade é public.
revokedRetirado.

Códigos de instalação

Cada artefacto recebe o seu código de instalação quando é criado: SKIL-, AGNT-, PLUG-, APPS-, CONN- ou COLL-, seguido de oito carateres. Escrever o código como mensagem num chat do Nebo instala o artefacto; ver Conceitos fundamentais.