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 động | Tài khoản nhà phát triển | Chức năng |
|---|---|---|
create | không cần | Tạo sản phẩm và mã cài đặt của nó. |
update | không cần | Thay đổi các trường, nội dung, phiên bản hoặc chế độ hiển thị. |
get, list, delete | không cần | Đọc hoặc gỡ bỏ các sản phẩm của bạn. |
install | không cần | Cà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ự động | Token để 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ự động | Token để 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ự động | Quản lý các tệp nhị phân đã tải lên. |
submit | được thiết lập tự động | Gửi một phiên bản để kiểm duyệt. |
| Trường | Ý nghĩa |
|---|---|
name | Tên hiển thị. Slug được tạo từ tên này. |
description | Một dòng, từ 10 đến 500 ký tự để gửi. |
manifestContent | Tệp chính của sản phẩm: SKILL.md, AGENT.md hoặc PLUGIN.md. |
version | Phiên bản ngữ nghĩa. Mặc định 0.1.0. |
visibility | private (mặc định), loop (chia sẻ với các Kênh của bạn) hoặc public. |
category | Danh mục trên chợ ứng dụng. |
longDescription | Văn bản “Chức năng” trên chợ ứng dụng (chỉ với update). |
sourceUrl, manifestUrl | Các liên kết tùy chọn. |
dependencies | Chỉ 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ói | Giới hạn |
|---|---|
| Kích thước zip | 50 MB |
| Mỗi tệp | 10 MB |
| Tất cả tệp | 50 MB |
| Loại tệp | Vă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ẫn | Khô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 |
|---|---|
draft | Chư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.