连接
把 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。 |
visibility | private(默认)、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 聊天中把这个代码作为消息发送,就会安装该作品;参见核心概念。