الاتصال
أضِف 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"). وتصبح مساحة الأسماء المختارة جزءًا من كل اسم مؤهّل تنشره.
الأدوات
تتشارك الأدوات skill وagent وplugin مجموعة واحدة من الإجراءات. وتُنشر التطبيقات عبر الأداة agent.
| الإجراء | حساب المطوّر | ما يفعله |
|---|---|---|
create | غير مطلوب | ينشئ العنصر ورمز تثبيته. |
update | غير مطلوب | يغيّر الحقول أو المحتوى أو الإصدار أو مستوى الظهور. |
get, list, delete | غير مطلوب | يقرأ عناصرك أو يزيلها. |
install | غير مطلوب | يثبّت على أحد بوتاتك: id وbotId وcascade لتضمين الاعتماديات. |
bundle-token | يُعَدّ تلقائيًا | رمز لرفع ملف zip من الملفات النصية. |
binary-token | يُعَدّ تلقائيًا | رمز لرفع الملفات التنفيذية وplugin.json وagent.json وواجهات التطبيقات. |
list-binaries, delete-binary | يُعَدّ تلقائيًا | يدير الملفات التنفيذية المرفوعة. |
submit | يُعَدّ تلقائيًا | يقدّم إصدارًا للمراجعة. |
| الحقل | المعنى |
|---|---|
name | اسم العرض. يُصنع منه الاسم المختصر. |
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>") سمِّ المهارة عبر الحقل name في مقدمتها. اسمها المؤهّل هو @<namespace>/skills/<slug>، والاسم المختصر مصنوع من اسم العرض، وتحلّ البوتات الأسماء المؤهّلة مقابل 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، ويستبدل update مع dependencies ملف agent.json المخزّن. عندما تستخدم الاثنين، ضع كائن dependencies نفسه داخل agent.json.
الاعتماديات
يحتوي dependencies على القوائم skills وagents وconnectors. كل عنصر هو {qualifiedName, id, name}؛ يتحقق NeboAI من الاسم المؤهَّل أولًا، ثم من المعرّف. تُدرَج الإضافة تحت skills. وتُضاف تلقائيًا الإضافات التي تتطلبها المهارات المذكورة في agent.json. وعندما يثبّت مالك موظفك من المتجر أو باستخدام رمزه، يثبّت البوت معه تبعياته من المهارات والإضافات والموظفين.
نشر إضافة أو تطبيق
ترفع الإضافات ملفًا تنفيذيًا واحدًا لكل منصة مع ملف plugin.json الخاص بالإضافة ومهاراتها، انظر شحن إضافة. التطبيق المقتصر على صفحة لا يحتاج إلى ملف تنفيذي: ارفع حزمة واحدة عبر bundle-token تضم AGENT.md (مع artifact_type: app) وagent.json وmanifest.json وui/ وأي skills/. أما التطبيق الذي لديه مكوّن مرافق فيستخدم رفع الملف التنفيذي نفسه عبر الأداة agent: الملف التنفيذي للمكوّن المرافق بوصفه file مع platform الخاصة به، والصفحة بوصفها ui، وهي ملف .tar.gz للمجلد ui/. انظر التطبيقات.
المراجعة
يحتاج submit إلى محتوى الملف الرئيسي ووصف من 10 إلى 500 حرف. يُفحص كل تقديم. ويمكن الموافقة تلقائيًا على الفحص النظيف، وكل ما يُعلَّم يذهب إلى المراجعة اليدوية. الموافقة توقّع أي ملفات تنفيذية وتجعل الإصدار نشطًا. والإصدار المرفوض يعود إلى المسودة.
| حالة العنصر | المعنى |
|---|---|
draft | لم يُقدَّم، أو مرفوض. |
pending_review, review | بانتظار المراجعة. |
active | موافَق عليه. يُدرج في المتجر عندما يكون مستوى الظهور public. |
revoked | مسحوب. |
رموز التثبيت
يحصل كل عنصر على رمز تثبيته عند إنشائه: SKIL- أو AGNT- أو PLUG- أو APPS- أو CONN- أو COLL- متبوعًا بثمانية أحرف. كتابة الرمز كرسالة في محادثة Nebo تثبّت العنصر، انظر المفاهيم الأساسية.