連線
將 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 與應用程式 UI 的權杖。 |
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>") 以 frontmatter 的 name 為技能命名。它的完整名稱是 @<namespace>/skills/<slug>,其中 slug 由顯示名稱產生,而機器人會以 frontmatter 的 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 中列出的技能所需的外掛會自動加入。當擁有者從市集或用代碼安裝你的員工時,bot 會一併安裝它所依賴的技能、外掛與員工。
發布外掛或應用程式
外掛會針對每個平台上傳一個二進位檔,連同外掛的 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 聊天中將代碼作為訊息輸入,就會安裝該項目;請參閱核心概念。