NeboAI
NeboAI
Бастау

Жариялау

Сіз NeboAI маркетплейсінде NeboAI MCP сервері арқылы жариялайсыз. 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 және қолданба интерфейстерін жүктеуге арналған токен.
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/ қалтасын қосу үшін оның орнына пакетті жиынтық ретінде жүктеңіз: бір zip ішінде AGENT.md, agent.json және skills/.

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 файлын алмастырады. Екеуін де пайдаланғанда, сол dependencies нысанын agent.json ішіне салыңыз.

Тәуелділіктер

dependencies ішінде skills, agents және connectors тізімдері бар. Әр жазба — {qualifiedName, id, name}; NeboAI алдымен толық атауды, содан кейін id-ді тексереді. Плагин skills тізімінде көрсетіледі. agent.json ішінде аталған дағдыларға қажет плагиндер автоматты түрде қосылады. Иесі қызметкеріңізді маркетплейстен немесе оның кодымен орнатқанда, бот оның дағды, плагин және қызметкер тәуелділіктерін бірге орнатады.

Плагинді немесе қолданбаны жариялау

Плагиндер әр платформаға бір бинарлық файлды плагиннің plugin.json файлымен және дағдыларымен бірге жүктейді; Плагинді шығару бөлімін қараңыз. Тек беттен тұратын қолданбаға бинарлық файл қажет емес: bundle-token арқылы AGENT.md (artifact_type: app бар), agent.json, manifest.json, ui/ және кез келген skills/ бар бір жиынтықты жүктеңіз. Sidecar-ы бар қолданба agent құралымен сол бинарлық жүктеуді пайдаланады: sidecar бинарлық файлы platform мәнімен file ретінде, ал бет ui ретінде, яғни ui/ қалтасының .tar.gz мұрағаты. Қолданбалар бөлімін қараңыз.

Тексеру

submit үшін негізгі файлдың мазмұны және 10-нан 500 таңбаға дейінгі сипаттама қажет. Әр жіберілім сканерленеді. Таза сканерлеу автоматты түрде мақұлдануы мүмкін; белгіленген кез келген нәрсе қолмен тексеруге жіберіледі. Мақұлдау кез келген бинарлық файлдарға қолтаңба қойып, нұсқаны белсенді етеді. Қабылданбаған нұсқа жоба күйіне қайтады.

Жұмыс күйіМағынасы
draftЖіберілмеген немесе қабылданбаған.
pending_review, reviewТексеруді күтуде.
activeМақұлданды. Көріну деңгейі public болғанда маркетплейсте тізімделеді.
revokedАлынып тасталды.

Орнату кодтары

Әр жұмыс жасалған кезде өз орнату кодын алады: SKIL-, AGNT-, PLUG-, APPS-, CONN- немесе COLL- және одан кейін сегіз таңба. Кодты Nebo чатында хабар ретінде теру жұмысты орнатады; Негізгі ұғымдар бөлімін қараңыз.