جوڑیں
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")۔ منتخب نیم اسپیس آپ کے شائع کردہ ہر qualified نام کا حصہ بن جاتی ہے۔
ٹولز
skill، agent اور plugin ٹولز کارروائیوں کا ایک ہی مجموعہ استعمال کرتے ہیں۔ ایپس agent ٹول سے شائع کی جاتی ہیں۔
| کارروائی | ڈویلپر اکاؤنٹ | کیا کرتا ہے |
|---|---|---|
create | ضرورت نہیں | چیز اور اس کا انسٹال کوڈ بناتا ہے۔ |
update | ضرورت نہیں | فیلڈز، مواد، ورژن یا مرئیت بدلتا ہے۔ |
get, list, delete | ضرورت نہیں | آپ کی چیزیں پڑھتا یا ہٹاتا ہے۔ |
install | ضرورت نہیں | آپ کے کسی بوٹ پر انسٹال کرتا ہے: id، botId، اور انحصار شامل کرنے کے لیے cascade۔ |
bundle-token | خود بخود سیٹ اپ ہوتا ہے | ٹیکسٹ فائلوں کی zip اپ لوڈ کرنے کا ٹوکن۔ |
binary-token | خود بخود سیٹ اپ ہوتا ہے | بائنریز، plugin.json، agent.json اور ایپ UIs اپ لوڈ کرنے کا ٹوکن۔ |
list-binaries, delete-binary | خود بخود سیٹ اپ ہوتا ہے | اپ لوڈ شدہ بائنریز کا انتظام کرتا ہے۔ |
submit | خود بخود سیٹ اپ ہوتا ہے | ایک ورژن جائزے کے لیے جمع کرواتا ہے۔ |
| فیلڈ | مطلب |
|---|---|
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 نام @<namespace>/skills/<slug> ہے، جس میں slug ڈسپلے نام سے بنتا ہے، اور بوٹس qualified ناموں کو 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/ فولڈر شامل کرنے کے لیے، اس کے بجائے پیکج کو بنڈل کی صورت میں اپ لوڈ کریں: 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 آبجیکٹ 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/ ہوں۔ سائیڈکار والی ایپ agent ٹول کے ساتھ وہی بائنری اپ لوڈ استعمال کرتی ہے: سائیڈکار بائنری file کے طور پر اپنے platform کے ساتھ، اور صفحہ ui کے طور پر، یعنی ui/ فولڈر کا ایک .tar.gz۔ ایپس دیکھیں۔
جائزہ
submit کو مرکزی فائل کا مواد اور 10 سے 500 حروف کی تفصیل درکار ہے۔ ہر جمع کروائی گئی چیز اسکین کی جاتی ہے۔ صاف اسکین خود بخود منظور ہو سکتا ہے؛ نشان زد کوئی بھی چیز دستی جائزے میں جاتی ہے۔ منظوری کسی بھی بائنری کو سائن کرتی ہے اور ورژن کو فعال کر دیتی ہے۔ مسترد ورژن واپس مسودے میں چلا جاتا ہے۔
| چیز کی حالت | مطلب |
|---|---|
draft | جمع نہیں کروائی گئی، یا مسترد۔ |
pending_review, review | جائزے کا انتظار۔ |
active | منظور شدہ۔ مرئیت public ہونے پر مارکیٹ پلیس پر فہرست میں۔ |
revoked | واپس لے لی گئی۔ |
انسٹال کوڈز
ہر چیز کو بنتے وقت اس کا انسٹال کوڈ ملتا ہے: SKIL-، AGNT-، PLUG-، APPS-، CONN- یا COLL- جس کے بعد آٹھ حروف ہوں۔ Nebo چیٹ میں پیغام کے طور پر کوڈ ٹائپ کرنے سے چیز انسٹال ہو جاتی ہے؛ بنیادی تصورات دیکھیں۔