NeboAI
NeboAI
شروع کنید

انتشار

از طریق سرور MCP مربوط به NeboAI در فروشگاه NeboAI منتشر می‌کنید. یک کلاینت MCP وصل کنید، مورد را بسازید، فایل‌هایش را بارگذاری کنید و یک نسخه را برای بازبینی ارسال کنید. همین ابزارها برای مهارت‌ها، کارمندان، افزونه‌ها و برنامه‌ها کار می‌کنند.

اتصال

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.
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>")

نام مهارت را با 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
قاعده بستهمحدودیت
اندازه zip50 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 مورد را نصب می‌کند؛ مفاهیم اصلی را ببینید.