اتصال
https://neboai.com/mcp را به هر کلاینت MCP که از سرورهای راه دور پشتیبانی میکند اضافه کنید. کلاینت سرور مجوزدهی را پیدا میکند، خودش را ثبت میکند و شما را با OAuth و PKCE وارد میکند. هر حساب NeboAI میتواند وصل شود. توکنهای دسترسی یک ساعت اعتبار دارند و تا ۳۰ روز تازه میشوند.
حساب توسعهدهنده
هر کسی با حساب 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 و رابطهای کاربری برنامه. |
list-binaries, delete-binary | خودکار راهاندازی میشود | فایلهای اجرایی بارگذاریشده را مدیریت میکند. |
submit | خودکار راهاندازی میشود | یک نسخه را برای بازبینی ارسال میکند. |
| فیلد | معنا |
|---|---|
name | نام نمایشی. slug از روی آن ساخته میشود. |
description | یک خط، برای ارسال ۱۰ تا ۵۰۰ نویسه. |
manifestContent | فایل اصلی مورد: SKILL.md، AGENT.md یا PLUGIN.md. |
version | نسخه معنایی. پیشفرض 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 بارگذاری کنید. کارمندان به فایل اجرایی نیاز ندارند؛ config کافی است. برای شامل کردن پوشه skills/ خود کارمند، بهجای آن بسته را بهصورت 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 تعیین شدهاند، و یک update با dependencies جایگزین agent.json ذخیرهشده میشود. وقتی از هر دو استفاده میکنید، همان شیء dependencies را داخل agent.json بگذارید.
وابستگیها
dependencies فهرستهای skills، agents و connectors را دارد. هر مورد به شکل {qualifiedName, id, name} است؛ NeboAI ابتدا نام کامل و سپس شناسه را بررسی میکند. افزونه زیر skills فهرست میشود. افزونههایی که مهارتهای نامبرده در agent.json لازم دارند خودکار اضافه میشوند. وقتی مالکی کارمند شما را از فروشگاه یا با کدش نصب میکند، ربات مهارتها، افزونهها و کارمندانی را که به آنها وابسته است همراهش نصب میکند.
انتشار افزونه یا برنامه
افزونهها برای هر پلتفرم یک فایل اجرایی همراه با plugin.json و مهارتهای افزونه بارگذاری میکنند؛ عرضه یک افزونه را ببینید. برنامهای که فقط صفحه دارد به فایل اجرایی نیاز ندارد: یک bundle با bundle-token بارگذاری کنید که شامل AGENT.md (با artifact_type: app)، agent.json، manifest.json، ui/ و هر skills/ باشد. برنامهای که sidecar دارد از همان بارگذاری binary با ابزار agent استفاده میکند: فایل اجرایی sidecar بهعنوان file با platform آن، و صفحه بهعنوان ui، یک .tar.gz از پوشه ui/. برنامهها را ببینید.
بازبینی
submit به محتوای فایل اصلی و توضیحی ۱۰ تا ۵۰۰ نویسهای نیاز دارد. هر ارسال اسکن میشود. اسکن سالم میتواند خودکار تأیید شود؛ هر چیز علامتخورده به بازبینی دستی میرود. تأیید هر فایل اجرایی را امضا میکند و نسخه را فعال میکند. نسخه ردشده به پیشنویس برمیگردد.
| وضعیت مورد | معنا |
|---|---|
draft | ارسالنشده، یا ردشده. |
pending_review, review | در انتظار بازبینی. |
active | تأییدشده. وقتی میزان دیده شدن public باشد در فروشگاه فهرست میشود. |
revoked | خارجشده. |
کدهای نصب
هر مورد هنگام ساخته شدن کد نصب خودش را میگیرد: SKIL-، AGNT-، PLUG-، APPS-، CONN- یا COLL- و پس از آن هشت نویسه. تایپ کد بهعنوان پیام در چت Nebo مورد را نصب میکند؛ مفاهیم اصلی را ببینید.