NeboAI
NeboAI
Bắt đầu

Xuất bản

Bạn xuất bản lên chợ ứng dụng NeboAI qua máy chủ MCP của NeboAI. Kết nối một MCP client, tạo sản phẩm, tải lên các tệp và gửi một phiên bản để kiểm duyệt. Cùng các công cụ đó phục vụ kỹ năng, nhân viên, plugin và ứng dụng.

Kết nối

Thêm https://neboai.com/mcp vào bất kỳ MCP client nào hỗ trợ máy chủ từ xa. Client sẽ tìm máy chủ ủy quyền, tự đăng ký và đăng nhập cho bạn bằng OAuth và PKCE. Mọi tài khoản NeboAI đều kết nối được. Access token có hiệu lực một giờ và được làm mới trong 30 ngày.

Tài khoản nhà phát triển

Bất kỳ ai có tài khoản NeboAI đều có thể xuất bản. Việc gửi phiên bản và tải tệp lên dùng tài khoản nhà phát triển của bạn, tài khoản này được thiết lập miễn phí cho bạn ngay lần đầu bạn gửi hoặc yêu cầu token tải lên. Không có phí và không có bước phê duyệt.

Để xuất bản cho một nhóm thay vì cho chính bạn, hãy chọn tài khoản của nhóm cho phiên làm việc. Bạn phải là thành viên của nhóm.

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

developer cũng có thể thiết lập tài khoản của bạn trước (action: "create", tùy chọn), đồng thời liệt kê và chọn không gian tên (resource: "namespace"). Không gian tên đã chọn trở thành một phần của mọi tên đầy đủ bạn xuất bản.

Công cụ

Các công cụ skill, agent và plugin dùng chung một bộ hành động. Ứng dụng được xuất bản bằng công cụ agent.

Hành độngTài khoản nhà phát triểnChức năng
createkhông cầnTạo sản phẩm và mã cài đặt của nó.
updatekhông cầnThay đổi các trường, nội dung, phiên bản hoặc chế độ hiển thị.
get, list, deletekhông cầnĐọc hoặc gỡ bỏ các sản phẩm của bạn.
installkhông cầnCài lên một trong các bot của bạn: id, botId, và cascade để bao gồm các phụ thuộc.
bundle-tokenđược thiết lập tự độngToken để tải lên một tệp zip chứa các tệp văn bản.
binary-tokenđược thiết lập tự độngToken để tải lên tệp nhị phân, plugin.json, agent.json và giao diện ứng dụng.
list-binaries, delete-binaryđược thiết lập tự độngQuản lý các tệp nhị phân đã tải lên.
submitđược thiết lập tự độngGửi một phiên bản để kiểm duyệt.
TrườngÝ nghĩa
nameTên hiển thị. Slug được tạo từ tên này.
descriptionMột dòng, từ 10 đến 500 ký tự để gửi.
manifestContentTệp chính của sản phẩm: SKILL.md, AGENT.md hoặc PLUGIN.md.
versionPhiên bản ngữ nghĩa. Mặc định 0.1.0.
visibilityprivate (mặc định), loop (chia sẻ với các Kênh của bạn) hoặc public.
categoryDanh mục trên chợ ứng dụng.
longDescriptionVăn bản “Chức năng” trên chợ ứng dụng (chỉ với update).
sourceUrl, manifestUrlCác liên kết tùy chọn.
dependenciesChỉ dành cho nhân viên. Xem Phụ thuộc.

Công cụ marketplace tìm kiếm trên chợ ứng dụng và liệt kê các danh mục. Công cụ pricing đặt giá cho một sản phẩm; sản phẩm trả phí yêu cầu hoàn tất thiết lập nhận thanh toán.

Xuất bản một kỹ năng

Tạo kỹ năng với SKILL.md làm nội dung.

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

Đặt tên kỹ năng bằng name trong frontmatter. Tên đầy đủ của nó là @<namespace>/skills/<slug>, với slug được tạo từ tên hiển thị, và bot phân giải tên đầy đủ dựa trên name trong frontmatter, nên hai giá trị này phải khớp nhau.

Nếu kỹ năng có các tệp khác, hãy tải thư mục lên dưới dạng tệp zip. Một thư mục cấp cao nhất duy nhất trong tệp zip sẽ tự động bị bỏ đi, và các thư mục build và quản lý phiên bản được bỏ qua.

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
Quy tắc góiGiới hạn
Kích thước zip50 MB
Mỗi tệp10 MB
Tất cả tệp50 MB
Loại tệpVăn bản, mã, dữ liệu, hình ảnh, PDF và phông chữ, chẳng hạn .md, .py, .js, .ts, .json, .yaml, .csv, .html. Mọi thứ trong scripts/, bin/ hoặc dist/ đều được chấp nhận.
Đường dẫnKhông có .. và không có đường dẫn tuyệt đối.

Đặt kỹ năng ở chế độ công khai và gửi một phiên bản.

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

Xuất bản một nhân viên

Tạo nhân viên với AGENT.md làm nội dung cùng các phụ thuộc từ chợ ứng dụng.

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

Tải lên agent.json bằng binary token. Nhân viên không cần tệp nhị phân; config là đủ. Để đưa vào thư mục skills/ riêng của nhân viên, hãy tải gói lên dưới dạng bundle thay vào đó: AGENT.md, agent.json và skills/ trong một tệp 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

Giữ phụ thuộc trong agent.json. Một agent.json được tải lên sẽ thay thế cấu hình đã lưu, bao gồm các phụ thuộc đặt bằng create hoặc update, và một lệnh update có dependencies sẽ thay thế agent.json đã lưu. Khi dùng cả hai, hãy đặt cùng một đối tượng dependencies bên trong agent.json.

Phụ thuộc

dependencies có các danh sách skills, agents và connectors. Mỗi mục là {qualifiedName, id, name}; NeboAI kiểm tra qualified name trước, rồi đến id. Plugin được liệt kê trong skills. Các plugin mà kỹ năng có tên trong agent.json cần sẽ được thêm tự động. Khi chủ sở hữu cài nhân viên của bạn từ chợ ứng dụng hoặc bằng mã của nhân viên, bot sẽ cài kèm các kỹ năng, plugin và nhân viên phụ thuộc.

Xuất bản một plugin hoặc một ứng dụng

Plugin tải lên một tệp nhị phân cho mỗi nền tảng cùng plugin.json và các kỹ năng của plugin; xem Phát hành plugin. Ứng dụng chỉ có trang không cần tệp nhị phân: tải lên một bundle bằng bundle-token chứa AGENT.md (với artifact_type: app), agent.json, manifest.json, ui/ và mọi skills/. Ứng dụng có sidecar dùng cùng cách tải tệp nhị phân với công cụ agent: tệp nhị phân sidecar dưới dạng file kèm platform của nó, và trang dưới dạng ui, một tệp .tar.gz của thư mục ui/. Xem Ứng dụng.

Kiểm duyệt

submit cần nội dung của tệp chính và một mô tả từ 10 đến 500 ký tự. Mỗi lần gửi đều được quét. Kết quả quét không có vấn đề có thể được duyệt tự động; bất cứ thứ gì bị gắn cờ sẽ được chuyển sang kiểm duyệt thủ công. Việc phê duyệt sẽ ký số mọi tệp nhị phân và kích hoạt phiên bản. Phiên bản bị từ chối sẽ quay về bản nháp.

Trạng thái sản phẩmÝ nghĩa
draftChưa gửi, hoặc bị từ chối.
pending_review, reviewĐang chờ kiểm duyệt.
activeĐã duyệt. Được niêm yết trên chợ ứng dụng khi chế độ hiển thị là public.
revokedĐã rút.

Mã cài đặt

Mỗi sản phẩm nhận mã cài đặt ngay khi được tạo: SKIL-, AGNT-, PLUG-, APPS-, CONN- hoặc COLL- theo sau là tám ký tự. Gõ mã đó làm tin nhắn trong cuộc trò chuyện của Nebo sẽ cài sản phẩm; xem Khái niệm cốt lõi.