התחברות
הוסף את 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 | שם תצוגה. ה-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>") תן לכישור שם באמצעות ה-name שב-frontmatter. השם המלא שלו הוא @<namespace>/skills/<slug>, כשה-slug נוצר משם התצוגה, ובוטים מתרגמים שמות מלאים לפי ה-name שב-frontmatter, ולכן השניים חייבים להתאים.
אם לכישור יש קבצים נוספים, העלה את התיקייה כקובץ 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/ של העובד עצמו, העלה את החבילה כ-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 משתמשת באותה העלאה בינארית עם הכלי agent: הקובץ הבינארי של ה-sidecar כ-file עם ה-platform שלו, והדף כ-ui, קובץ .tar.gz של התיקייה ui/. ראה אפליקציות.
בדיקה
submit צריך את התוכן של הקובץ הראשי ותיאור באורך 10 עד 500 תווים. כל הגשה נסרקת. סריקה נקייה יכולה להיות מאושרת אוטומטית; כל מה שמסומן עובר לבדיקה ידנית. האישור חותם על כל הקבצים הבינאריים ומפעיל את הגרסה. גרסה שנדחתה חוזרת לטיוטה.
| סטטוס הפריט | משמעות |
|---|---|
draft | לא נשלח, או נדחה. |
pending_review, review | ממתין לבדיקה. |
active | אושר. מופיע בחנות כשהנראות היא public. |
revoked | הוסר. |
קודי התקנה
כל פריט מקבל את קוד ההתקנה שלו כשהוא נוצר: SKIL-, AGNT-, PLUG-, APPS-, CONN- או COLL- ואחריו שמונה תווים. הקלדת הקוד כהודעה בצ׳אט של Nebo מתקינה את הפריט; ראה מושגי יסוד.