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ção | Conta de programador | Faz |
|---|---|---|
create | não é necessária | Cria o artefacto e o seu código de instalação. |
update | não é necessária | Altera campos, conteúdo, versão ou visibilidade. |
get, list, delete | não é necessária | Lê ou remove os seus artefactos. |
install | não é necessária | Instala num dos seus bots: id, botId e cascade para incluir as dependências. |
bundle-token | configurada automaticamente | Um token para carregar um zip de ficheiros de texto. |
binary-token | configurada automaticamente | Um token para carregar binários, plugin.json, agent.json e interfaces de apps. |
list-binaries, delete-binary | configurada automaticamente | Gere os binários carregados. |
submit | configurada automaticamente | Submete uma versão para revisão. |
| Campo | Significado |
|---|---|
name | Nome apresentado. O slug é gerado a partir dele. |
description | Uma linha, de 10 a 500 carateres para submeter. |
manifestContent | O ficheiro principal do artefacto: SKILL.md, AGENT.md ou PLUGIN.md. |
version | Versão semântica. Predefinição 0.1.0. |
visibility | private (predefinição), loop (partilhado com os seus Canais) ou public. |
category | Categoria na loja. |
longDescription | O texto «O que faz» da loja (só update). |
sourceUrl, manifestUrl | Ligações opcionais. |
dependencies | Só 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 pacote | Limite |
|---|---|
| Tamanho do zip | 50 MB |
| Cada ficheiro | 10 MB |
| Todos os ficheiros | 50 MB |
| Tipos de ficheiro | Texto, 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. |
| Caminhos | Sem .. 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 artefacto | Significado |
|---|---|
draft | Não submetido, ou rejeitado. |
pending_review, review | A aguardar revisão. |
active | Aprovado. Listado na loja quando a visibilidade é public. |
revoked | Retirado. |
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.