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 與應用程式 UI 的權杖。
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>")

以 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 聊天中將代碼作為訊息輸入,就會安裝該項目;請參閱核心概念。