NeboAI
NeboAI
开始使用

发布

你通过 NeboAI MCP 服务器发布到 NeboAI 市场。连接一个 MCP 客户端,创建作品,上传它的文件,然后提交一个版本供审核。技能、员工、插件和应用都使用同样的工具。

连接

把 https://neboai.com/mcp 添加到任何支持远程服务器的 MCP 客户端。客户端会发现授权服务器、自行注册,并通过 OAuth 和 PKCE 让你登录。任何 NeboAI 账户都可以连接。访问令牌有效期为一小时,可在 30 天内刷新。

开发者账户

任何拥有 NeboAI 账户的人都可以发布。提交版本和上传文件会使用你的开发者账户,它会在你第一次提交或申请上传令牌时免费为你设置好。没有任何费用,也没有审批步骤。

如果要以团队而不是个人身份发布,请为本次会话选择团队的账户。你必须是该团队的成员。

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

developer 也可以提前设置你的账户(action: "create",可选),并列出和选择命名空间(resource: "namespace")。所选的命名空间会成为你发布的每个限定名称的一部分。

工具

skill、agent 和 plugin 工具共用一组动作。应用使用 agent 工具发布。

动作开发者账户作用
create不需要创建作品及其安装码。
update不需要修改字段、内容、版本或可见范围。
get, list, delete不需要读取或移除你的作品。
install不需要安装到你的某个机器人上:id、botId,以及用于包含依赖的 cascade。
bundle-token自动设置用于上传文本文件 zip 包的令牌。
binary-token自动设置用于上传二进制文件、plugin.json、agent.json 和应用界面的令牌。
list-binaries, delete-binary自动设置管理已上传的二进制文件。
submit自动设置提交一个版本供审核。
字段含义
name显示名称。slug 由它生成。
description一行文字,提交时需 10 到 500 个字符。
manifestContent作品的主文件:SKILL.md、AGENT.md 或 PLUGIN.md。
version语义化版本号。默认为 0.1.0。
visibilityprivate(默认)、loop(与你的频道共享)或 public。
category市场类别。
longDescription市场中的“它能做什么”文字(仅限 update)。
sourceUrl, manifestUrl可选的链接。
dependencies仅限员工。参见“依赖”。

marketplace 工具用于搜索市场和列出类别。pricing 工具用于为作品定价;付费作品需要先完成收款设置。

发布技能

以 SKILL.md 作为内容来创建技能。

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>")

用前置元数据中的 name 为技能命名。它的限定名称是 @<namespace>/skills/<slug>,其中 slug 由显示名称生成,而机器人会根据前置元数据中的 name 来解析限定名称,因此两者必须一致。

如果技能还有其他文件,请把文件夹打成 zip 上传。zip 中唯一的顶层文件夹会被自动去掉,构建和版本控制相关的文件夹会被跳过。

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
打包规则限制
zip 大小50 MB
每个文件10 MB
所有文件50 MB
文件类型文本、代码、数据、图片、PDF 和字体,例如 .md、.py、.js、.ts、.json、.yaml、.csv、.html。scripts/、bin/ 或 dist/ 下的任何文件都接受。
路径不允许 ..,也不允许绝对路径。

将技能设为公开并提交一个版本。

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

发布员工

以 AGENT.md 作为内容、连同它的市场依赖来创建员工。

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" } ] })

使用二进制令牌上传 agent.json。员工不需要二进制文件;config 就足够了。如果要包含员工自己的 skills/ 文件夹,请改为以包的形式上传:把 AGENT.md、agent.json 和 skills/ 放在一个 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

把依赖保留在 agent.json 中。上传的 agent.json 会替换已存储的配置,包括用 create 或 update 设置的依赖;而带有 dependencies 的 update 也会替换已存储的 agent.json。如果两者都用,请在 agent.json 中放入同样的 dependencies 对象。

依赖

dependencies 包含 skills、agents 和 connectors 三个列表。每个条目都是 {qualifiedName, id, name};NeboAI 会先检查限定名称,再检查 id。插件列在 skills 下。agent.json 中所列技能需要的插件会自动添加。当所有者从市场或通过安装代码安装你的员工时,机器人会同时安装它依赖的技能、插件和员工。

发布插件或应用

插件为每个平台上传一个二进制文件,连同插件的 plugin.json 和技能;参见交付插件。纯页面应用不需要二进制文件:用 bundle-token 上传一个包,其中包含 AGENT.md(带 artifact_type: app)、agent.json、manifest.json、ui/ 以及任何 skills/。带有 sidecar 的应用使用 agent 工具进行同样的二进制上传:sidecar 二进制文件作为 file 并指定其 platform,页面作为 ui,即 ui/ 文件夹的 .tar.gz 压缩包。参见应用。

审核

submit 需要主文件的内容和一段 10 到 500 个字符的描述。每次提交都会被扫描。扫描结果干净的可以自动通过;任何被标记的都会进入人工审核。审核通过会为所有二进制文件签名,并使该版本生效。被拒绝的版本会退回草稿状态。

作品状态含义
draft未提交,或已被拒绝。
pending_review, review等待审核。
active已通过。当可见范围为 public 时在市场上架。
revoked已撤下。

安装码

每个作品在创建时都会得到它的安装码:SKIL-、AGNT-、PLUG-、APPS-、CONN- 或 COLL-,后面跟八个字符。在 Nebo 聊天中把这个代码作为消息发送,就会安装该作品;参见核心概念。