เชื่อมต่อ
เพิ่ม 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 ใช้ชุด action เดียวกัน แอปเผยแพร่ด้วยเครื่องมือ agent
| Action | บัญชีนักพัฒนา | ทำอะไร |
|---|---|---|
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 | เวอร์ชันแบบ Semantic ค่าเริ่มต้น 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 ใน frontmatter ชื่อแบบเต็มคือ @<namespace>/skills/<slug> โดย slug สร้างจากชื่อที่แสดง และบอทจะจับคู่ชื่อแบบเต็มกับ name ใน frontmatter ทั้งสองจึงต้องตรงกัน
หากทักษะมีไฟล์อื่น ให้อัปโหลดโฟลเดอร์เป็น 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 และ update ที่มี dependencies จะแทนที่ agent.json ที่จัดเก็บไว้ เมื่อใช้ทั้งสองอย่าง ให้ใส่ออบเจกต์ dependencies เดียวกันไว้ใน agent.json
สิ่งที่ต้องพึ่งพา
dependencies มีรายการ skills, agents และ connectors แต่ละรายการคือ {qualifiedName, id, name} โดย NeboAI จะตรวจสอบ qualified name ก่อน แล้วจึงตรวจ id ปลั๊กอินจะแสดงอยู่ภายใต้ skills ปลั๊กอินที่ทักษะซึ่งระบุใน agent.json ต้องใช้จะถูกเพิ่มให้อัตโนมัติ เมื่อเจ้าของติดตั้งพนักงานของคุณจากมาร์เก็ตเพลสหรือด้วยรหัส บอทจะติดตั้งทักษะ ปลั๊กอิน และพนักงานที่เป็น dependency ไปพร้อมกัน
เผยแพร่ปลั๊กอินหรือแอป
ปลั๊กอินอัปโหลดไบนารีหนึ่งไฟล์ต่อแพลตฟอร์มพร้อม plugin.json และทักษะของปลั๊กอิน ดู การเผยแพร่ปลั๊กอิน แอปที่มีแค่หน้าไม่ต้องมีไบนารี อัปโหลดบันเดิลเดียวด้วย bundle-token ซึ่งมี AGENT.md (พร้อม artifact_type: app), agent.json, manifest.json, ui/ และ skills/ ถ้ามี แอปที่มี sidecar ใช้การอัปโหลดไบนารีแบบเดียวกันด้วยเครื่องมือ agent: ไบนารี sidecar เป็น file พร้อม platform และหน้าเป็น ui ซึ่งเป็น .tar.gz ของโฟลเดอร์ ui/ ดู แอป
การตรวจสอบ
submit ต้องมีเนื้อหาของไฟล์หลักและคำอธิบายยาว 10 ถึง 500 ตัวอักษร ทุกการส่งจะถูกสแกน ผลสแกนที่ไม่มีปัญหาอาจได้รับอนุมัติโดยอัตโนมัติ สิ่งที่ถูกทำเครื่องหมายจะเข้าสู่การตรวจสอบด้วยตนเอง การอนุมัติจะลงนามไบนารีทั้งหมดและทำให้เวอร์ชันนั้นใช้งานได้ เวอร์ชันที่ถูกปฏิเสธจะกลับเป็นฉบับร่าง
| สถานะของรายการ | ความหมาย |
|---|---|
draft | ยังไม่ได้ส่ง หรือถูกปฏิเสธ |
pending_review, review | รอการตรวจสอบ |
active | อนุมัติแล้ว แสดงในมาร์เก็ตเพลสเมื่อการมองเห็นเป็น public |
revoked | ถอนออกแล้ว |
รหัสติดตั้ง
ทุกรายการได้รับรหัสติดตั้งเมื่อสร้าง: SKIL-, AGNT-, PLUG-, APPS-, CONN- หรือ COLL- ตามด้วยอักขระแปดตัว การพิมพ์รหัสเป็นข้อความในแชทของ Nebo จะติดตั้งรายการนั้น ดู แนวคิดหลัก