সংযুক্ত করুন
রিমোট সার্ভার সমর্থন করে এমন যেকোনো MCP ক্লায়েন্টে https://neboai.com/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 ও অ্যাপ UI আপলোডের জন্য একটি টোকেন। |
list-binaries, delete-binary | স্বয়ংক্রিয়ভাবে সেট আপ হয় | আপলোড করা বাইনারি পরিচালনা করে। |
submit | স্বয়ংক্রিয়ভাবে সেট আপ হয় | পর্যালোচনার জন্য একটি সংস্করণ জমা দেয়। |
| ফিল্ড | অর্থ |
|---|---|
name | প্রদর্শিত নাম। slug এটি থেকেই তৈরি হয়। |
description | এক লাইন, জমা দিতে 10 থেকে 500 অক্ষর। |
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>") দক্ষতার নাম দিন তার 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" } ] }) একটি binary token দিয়ে 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 প্রথমে qualified name যাচাই করে, তারপর id। প্লাগইন তালিকাভুক্ত হয় skills-এর অধীনে। agent.json-এ উল্লেখ করা দক্ষতাগুলোর জন্য প্রয়োজনীয় প্লাগইন স্বয়ংক্রিয়ভাবে যোগ হয়। কোনো মালিক মার্কেটপ্লেস থেকে বা এর কোড দিয়ে আপনার কর্মী ইনস্টল করলে, বট এর সঙ্গে এর দক্ষতা, প্লাগইন ও কর্মী নির্ভরতাগুলোও ইনস্টল করে।
একটি প্লাগইন বা অ্যাপ প্রকাশ করুন
প্লাগইন প্রতি প্ল্যাটফর্মে একটি বাইনারি আপলোড করে, সাথে প্লাগইনের plugin.json ও দক্ষতা; প্লাগইন প্রকাশ করা দেখুন। শুধু-পাতার একটি অ্যাপের কোনো বাইনারি লাগে না: bundle-token দিয়ে একটি বান্ডেল আপলোড করুন, যাতে থাকবে AGENT.md (artifact_type: app-সহ), agent.json, manifest.json, ui/ এবং যেকোনো skills/। সাইডকারসহ একটি অ্যাপ agent টুল দিয়ে একই বাইনারি আপলোড ব্যবহার করে: সাইডকার বাইনারি file হিসেবে তার platform-সহ, এবং পাতাটি ui হিসেবে, ui/ ফোল্ডারের একটি .tar.gz। অ্যাপ দেখুন।
পর্যালোচনা
submit-এর জন্য মূল ফাইলের কনটেন্ট এবং 10 থেকে 500 অক্ষরের একটি বিবরণ লাগে। প্রতিটি জমা স্ক্যান করা হয়। সমস্যাহীন স্ক্যান স্বয়ংক্রিয়ভাবে অনুমোদিত হতে পারে; চিহ্নিত যেকোনো কিছু হাতে পর্যালোচনায় যায়। অনুমোদন যেকোনো বাইনারি সাইন করে এবং সংস্করণটি সক্রিয় করে। প্রত্যাখ্যাত সংস্করণ খসড়ায় ফিরে যায়।
| আইটেমের অবস্থা | অর্থ |
|---|---|
draft | জমা দেওয়া হয়নি, অথবা প্রত্যাখ্যাত। |
pending_review, review | পর্যালোচনার অপেক্ষায়। |
active | অনুমোদিত। দৃশ্যমানতা public হলে মার্কেটপ্লেসে তালিকাভুক্ত। |
revoked | প্রত্যাহার করা হয়েছে। |
ইনস্টল কোড
প্রতিটি আইটেম তৈরি হওয়ার সময়েই তার ইনস্টল কোড পায়: SKIL-, AGNT-, PLUG-, APPS-, CONN- অথবা COLL-, তারপর আটটি অক্ষর। Nebo চ্যাটে বার্তা হিসেবে কোডটি টাইপ করলে আইটেমটি ইনস্টল হয়; মূল ধারণা দেখুন।