តភ្ជាប់
បន្ថែម https://neboai.com/mcp ទៅ MCP client ណាមួយដែលគាំទ្រម៉ាស៊ីនមេពីចម្ងាយ។ client រកឃើញម៉ាស៊ីនមេផ្ដល់សិទ្ធិ ចុះឈ្មោះខ្លួនឯង ហើយចូលគណនីអ្នកដោយប្រើ OAuth និង PKCE។ គណនី NeboAI ណាមួយអាចតភ្ជាប់បាន។ Access tokens មានសុពលភាពមួយម៉ោង ហើយធ្វើឱ្យស្រស់បានរយៈពេល 30 ថ្ងៃ។
គណនីអ្នកអភិវឌ្ឍន៍
អ្នកណាក៏ដោយដែលមានគណនី NeboAI អាចបោះផ្សាយបាន។ ការដាក់ស្នើកំណែ និងការផ្ទុកឡើងឯកសារ ប្រើគណនីអ្នកអភិវឌ្ឍន៍របស់អ្នក ដែលត្រូវបានរៀបចំជូនអ្នកដោយឥតគិតថ្លៃ នៅលើកដំបូងដែលអ្នកដាក់ស្នើ ឬស្នើសុំ token ផ្ទុកឡើង។ គ្មានថ្លៃ និងគ្មានជំហានយល់ព្រមទេ។
ដើម្បីបោះផ្សាយសម្រាប់ក្រុមជំនួសឱ្យខ្លួនអ្នក សូមជ្រើសរើសគណនីរបស់ក្រុមសម្រាប់វគ្គនោះ។ អ្នកត្រូវតែជាសមាជិកនៃក្រុម។
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer ក៏អាចរៀបចំគណនីរបស់អ្នកជាមុន (action: "create" ជាជម្រើស) ហើយរាយ និងជ្រើសរើស namespaces (resource: "namespace")។ namespace ដែលបានជ្រើសរើស ក្លាយជាផ្នែកនៃឈ្មោះពេញលេញនីមួយៗដែលអ្នកបោះផ្សាយ។
ឧបករណ៍
ឧបករណ៍ skill, agent និង plugin ចែករំលែកសំណុំសកម្មភាពតែមួយ។ កម្មវិធីត្រូវបានបោះផ្សាយដោយប្រើឧបករណ៍ agent។
| សកម្មភាព | គណនីអ្នកអភិវឌ្ឍន៍ | ធ្វើ |
|---|---|---|
create | មិនត្រូវការ | បង្កើតធាតុ និងកូដដំឡើងរបស់វា។ |
update | មិនត្រូវការ | ផ្លាស់ប្ដូរវាល ខ្លឹមសារ កំណែ ឬភាពមើលឃើញ។ |
get, list, delete | មិនត្រូវការ | អាន ឬដកធាតុរបស់អ្នកចេញ។ |
install | មិនត្រូវការ | ដំឡើងលើបូតមួយរបស់អ្នក៖ id, botId និង cascade ដើម្បីរួមបញ្ចូលការពឹងផ្អែក។ |
bundle-token | រៀបចំដោយស្វ័យប្រវត្តិ | token សម្រាប់ផ្ទុកឡើង zip នៃឯកសារអត្ថបទ។ |
binary-token | រៀបចំដោយស្វ័យប្រវត្តិ | 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 ត្រូវបានដកចេញដោយស្វ័យប្រវត្តិ ហើយថត build និងថតគ្រប់គ្រងកំណែត្រូវបានរំលង។
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 ដោយប្រើ binary token។ បុគ្គលិកមិនត្រូវការឯកសារប្រព័ន្ធគោលពីរទេ 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 ដែលបានរក្សាទុក។ នៅពេលអ្នកប្រើទាំងពីរ សូមដាក់ object dependencies ដដែលនៅក្នុង agent.json។
ការពឹងផ្អែក
dependencies មានបញ្ជី skills, agents និង connectors។ ធាតុនីមួយៗគឺ {qualifiedName, id, name}; NeboAI ពិនិត្យឈ្មោះពេញ (qualified name) ជាមុន បន្ទាប់មក id។ Plugin ត្រូវបានរាយនៅក្រោម skills។ Plugin ដែលតម្រូវដោយជំនាញដែលមានឈ្មោះក្នុង agent.json ត្រូវបានបន្ថែមដោយស្វ័យប្រវត្តិ។ នៅពេលម្ចាស់ដំឡើងបុគ្គលិករបស់អ្នកពីទីផ្សារ ឬដោយប្រើលេខកូដរបស់វា បូតដំឡើងជំនាញ Plugin និងបុគ្គលិកដែលវាពឹងផ្អែកជាមួយវាផងដែរ។
បោះផ្សាយ Plugin ឬកម្មវិធី
Plugin ផ្ទុកឡើងឯកសារប្រព័ន្ធគោលពីរមួយក្នុងមួយវេទិកា ជាមួយ plugin.json និងជំនាញរបស់ Plugin មើល ការចេញផ្សាយ Plugin។ កម្មវិធីដែលមានតែទំព័រមិនត្រូវការឯកសារប្រព័ន្ធគោលពីរទេ៖ ផ្ទុកឡើងបណ្ដុំមួយដោយប្រើ 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 ដំឡើងធាតុនោះ មើល គោលគំនិតស្នូល។