ချိတ်ဆက်ပါ
remote ဆာဗာများကို ပံ့ပိုးသော မည်သည့် MCP client တွင်မဆို https://neboai.com/mcp ကို ထည့်ပါ။ client က ခွင့်ပြုချက် ဆာဗာကို ရှာဖွေ၊ ကိုယ်တိုင် မှတ်ပုံတင်ပြီး OAuth နှင့် PKCE ဖြင့် သင့်ကို အကောင့်ဝင်ပေးပါသည်။ မည်သည့် NeboAI အကောင့်မဆို ချိတ်ဆက်နိုင်ပါသည်။ Access token များသည် တစ်နာရီ ခံပြီး 30 ရက်ကြာ ပြန်လည်ဆန်းသစ်ပါသည်။
ဆော့ဖ်ဝဲရေးသားသူ အကောင့်
NeboAI အကောင့်ရှိသူ မည်သူမဆို ထုတ်ဝေနိုင်ပါသည်။ ဗားရှင်း တင်သွင်းခြင်းနှင့် ဖိုင် အပ်လုဒ်လုပ်ခြင်းတို့သည် သင့်ဆော့ဖ်ဝဲရေးသားသူ အကောင့်ကို အသုံးပြုပြီး ၎င်းကို သင် ပထမဆုံး တင်သွင်းသည့်အခါ သို့မဟုတ် အပ်လုဒ် token တောင်းသည့်အခါ သင့်အတွက် အခမဲ့ စနစ်ထည့်သွင်းပေးပါသည်။ အခကြေးငွေ မရှိ၊ အတည်ပြုရသည့် အဆင့် မရှိပါ။
ကိုယ်တိုင်အစား အဖွဲ့အတွက် ထုတ်ဝေရန် session အတွက် အဖွဲ့၏ အကောင့်ကို ရွေးပါ။ သင်သည် အဖွဲ့၏ အဖွဲ့ဝင် ဖြစ်ရပါမည်။
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer သည် သင့်အကောင့်ကို ကြိုတင် စနစ်ထည့်သွင်းပေးနိုင်ပြီး (action: "create"၊ ရွေးချယ်နိုင်သည်) namespace များကို စာရင်းပြုစု၍ ရွေးချယ်ပေးပါသည် (resource: "namespace")။ ရွေးချယ်ထားသော namespace သည် သင်ထုတ်ဝေသော qualified name တိုင်း၏ အစိတ်အပိုင်း ဖြစ်လာပါသည်။
ကိရိယာများ
skill၊ agent နှင့် plugin ကိရိယာများသည် action အစုတစ်ခုကို မျှဝေကြသည်။ အက်ပ်များကို agent ကိရိယာဖြင့် ထုတ်ဝေပါသည်။
| Action | ဆော့ဖ်ဝဲရေးသားသူ အကောင့် | လုပ်ဆောင်ပုံ |
|---|---|---|
create | မလိုပါ | ထုတ်ဝေမည့်အရာနှင့် ၎င်း၏ ထည့်သွင်းရေး ကုဒ်ကို ဖန်တီးသည်။ |
update | မလိုပါ | field များ၊ အကြောင်းအရာ၊ ဗားရှင်း သို့မဟုတ် မြင်နိုင်မှုကို ပြောင်းလဲသည်။ |
get, list, delete | မလိုပါ | သင့်ထုတ်ဝေထားသည့်အရာများကို ဖတ်သည် သို့မဟုတ် ဖယ်ရှားသည်။ |
install | မလိုပါ | သင့် bot တစ်ခုပေါ်တွင် ထည့်သွင်းသည်- id၊ botId နှင့် မှီခိုမှုများ ပါဝင်စေရန် cascade။ |
bundle-token | အလိုအလျောက် စနစ်ထည့်သွင်းသည် | စာသားဖိုင်များ၏ zip ကို အပ်လုဒ်လုပ်ရန် token။ |
binary-token | အလိုအလျောက် စနစ်ထည့်သွင်းသည် | binary များ၊ plugin.json၊ agent.json နှင့် အက်ပ် UI များ အပ်လုဒ်လုပ်ရန် token။ |
list-binaries, delete-binary | အလိုအလျောက် စနစ်ထည့်သွင်းသည် | အပ်လုဒ်လုပ်ထားသော binary များကို စီမံသည်။ |
submit | အလိုအလျောက် စနစ်ထည့်သွင်းသည် | ဗားရှင်းကို စစ်ဆေးရန် တင်သွင်းသည်။ |
| Field | အဓိပ္ပာယ် |
|---|---|
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>") ကျွမ်းကျင်မှုကို ၎င်း၏ frontmatter name ဖြင့် အမည်ပေးပါ။ ၎င်း၏ qualified name သည် @<namespace>/skills/<slug> ဖြစ်ပြီး slug ကို ပြသမည့်အမည်မှ ပြုလုပ်ထားကာ bot များသည် qualified name များကို frontmatter name နှင့် တိုက်ဆိုင်စစ်ဆေးသောကြောင့် နှစ်ခု ကိုက်ညီရပါမည်။
ကျွမ်းကျင်မှုတွင် အခြား ဖိုင်များ ရှိပါက ဖိုလ်ဒါကို zip အဖြစ် အပ်လုဒ်လုပ်ပါ။ zip ထဲရှိ ထိပ်ဆုံးအဆင့် ဖိုလ်ဒါ တစ်ခုတည်းကို အလိုအလျောက် ဖယ်ရှားပြီး build နှင့် version-control ဖိုလ်ဒါများကို ကျော်သွားပါသည်။
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
| Bundle စည်းမျဉ်း | ကန့်သတ်ချက် |
|---|---|
| Zip အရွယ်အစား | 50 MB |
| ဖိုင်တစ်ခုစီ | 10 MB |
| ဖိုင် အားလုံး | 50 MB |
| ဖိုင် အမျိုးအစားများ | စာသား၊ ကုဒ်၊ ဒေတာ၊ ရုပ်ပုံများ၊ PDF နှင့် font များ၊ ဥပမာ .md၊ .py၊ .js၊ .ts၊ .json၊ .yaml၊ .csv၊ .html။ scripts/၊ bin/ သို့မဟုတ် dist/ အောက်ရှိ မည်သည့်အရာကိုမဆို လက်ခံသည်။ |
| Path များ | .. မပါရ၊ absolute path မပါရ။ |
ကျွမ်းကျင်မှုကို အများသုံး ပြုလုပ်ပြီး ဗားရှင်းတစ်ခုကို တင်သွင်းပါ။
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 ဖြင့် အပ်လုဒ်လုပ်ပါ။ ဝန်ထမ်းများသည် binary မလိုပါ၊ config ဖြင့် လုံလောက်ပါသည်။ ဝန်ထမ်း၏ ကိုယ်ပိုင် skills/ ဖိုလ်ဒါကို ထည့်ရန် package ကို bundle အဖြစ် အစားထိုး အပ်လုဒ်လုပ်ပါ- 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 ဖြင့် သတ်မှတ်ထားသော မှီခိုမှုများ အပါအဝင် သိမ်းဆည်းထားသော ဖွဲ့စည်းမှုကို အစားထိုးပြီး dependencies ပါသော update သည် သိမ်းဆည်းထားသော agent.json ကို အစားထိုးပါသည်။ နှစ်ခုလုံး အသုံးပြုသည့်အခါ တူညီသော dependencies object ကို agent.json ထဲတွင် ထည့်ပါ။
မှီခိုမှုများ
dependencies တွင် skills၊ agents နှင့် connectors စာရင်းများ ပါသည်။ ထည့်သွင်းချက်တစ်ခုစီသည် {qualifiedName, id, name} ဖြစ်သည်၊ NeboAI သည် qualified name ကို ဦးစွာ စစ်ပြီးနောက် id ကို စစ်သည်။ plugin တစ်ခုကို skills အောက်တွင် စာရင်းသွင်းသည်။ agent.json တွင် အမည်ပါသော ကျွမ်းကျင်မှုများက လိုအပ်သည့် plugin များကို အလိုအလျောက် ထည့်ပေးသည်။ ပိုင်ရှင်တစ်ဦးက သင့်ဝန်ထမ်းကို စျေးကွက်မှ သို့မဟုတ် ၎င်း၏ ကုဒ်ဖြင့် ထည့်သွင်းသည့်အခါ ဘော့ က ၎င်း၏ ကျွမ်းကျင်မှု၊ plugin နှင့် ဝန်ထမ်း dependency များကိုပါ တစ်ပါတည်း ထည့်သွင်းသည်။
Plugin သို့မဟုတ် အက်ပ်ကို ထုတ်ဝေပါ
Plugin များသည် ပလက်ဖောင်းတစ်ခုလျှင် binary တစ်ခုကို plugin ၏ plugin.json နှင့် ကျွမ်းကျင်မှုများနှင့်အတူ အပ်လုဒ်လုပ်ပါသည်။ Plugin တစ်ခု ထုတ်ပေးခြင်း ကို ကြည့်ပါ။ စာမျက်နှာသာပါသော အက်ပ်သည် binary မလိုပါ- AGENT.md (artifact_type: app ပါ)၊ agent.json၊ manifest.json၊ ui/ နှင့် skills/ ပါသော bundle တစ်ခုကို bundle-token ဖြင့် အပ်လုဒ်လုပ်ပါ။ sidecar ပါသော အက်ပ်သည် agent ကိရိယာဖြင့် တူညီသော binary အပ်လုဒ်ကို အသုံးပြုပါသည်- sidecar binary ကို ၎င်း၏ platform နှင့်အတူ file အဖြစ်နှင့် စာမျက်နှာကို ui/ ဖိုလ်ဒါ၏ .tar.gz ဖြစ်သော ui အဖြစ်။ အက်ပ်များ ကို ကြည့်ပါ။
စစ်ဆေးခြင်း
submit သည် အဓိက ဖိုင်၏ အကြောင်းအရာနှင့် စာလုံး 10 မှ 500 အထိ ဖော်ပြချက် လိုအပ်ပါသည်။ တင်သွင်းမှုတိုင်းကို စကင်ဖတ်ပါသည်။ ပြဿနာမရှိသော စကင်ဖတ်မှုကို အလိုအလျောက် အတည်ပြုနိုင်ပြီး အမှတ်အသားပြုခံရသည့် မည်သည့်အရာမဆို လူကိုယ်တိုင် စစ်ဆေးမှုသို့ သွားပါသည်။ အတည်ပြုချက်က binary များကို လက်မှတ်ထိုးပြီး ဗားရှင်းကို အသက်ဝင်စေပါသည်။ ငြင်းပယ်ခံရသော ဗားရှင်းသည် မူကြမ်းသို့ ပြန်သွားပါသည်။
| ထုတ်ဝေထားသည့်အရာ၏ အခြေအနေ | အဓိပ္ပာယ် |
|---|---|
draft | မတင်သွင်းရသေး၊ သို့မဟုတ် ငြင်းပယ်ခံရသည်။ |
pending_review, review | စစ်ဆေးမှုကို စောင့်နေသည်။ |
active | အတည်ပြုထားသည်။ မြင်နိုင်မှုသည် public ဖြစ်သည့်အခါ စျေးကွက်တွင် စာရင်းတင်သည်။ |
revoked | ရုပ်သိမ်းထားသည်။ |
ထည့်သွင်းရေး ကုဒ်များ
ထုတ်ဝေထားသည့်အရာတိုင်းသည် ဖန်တီးသည့်အခါ ၎င်း၏ ထည့်သွင်းရေး ကုဒ်ကို ရရှိပါသည်- SKIL-၊ AGNT-၊ PLUG-၊ APPS-၊ CONN- သို့မဟုတ် COLL- နောက်တွင် စာလုံး ရှစ်လုံး။ Nebo ချတ်တွင် ကုဒ်ကို မက်ဆေ့ချ်အဖြစ် ရိုက်ထည့်ခြင်းက ထိုအရာကို ထည့်သွင်းပါသည်။ အဓိက သဘောတရားများ ကို ကြည့်ပါ။