NeboAI
NeboAI
Почати

Публікація

Ви публікуєте на маркетплейсі NeboAI через MCP-сервер NeboAI. Підключіть MCP-клієнт, створіть продукт, завантажте його файли й надішліть версію на перевірку. Ті самі інструменти працюють для навичок, співробітників, плагінів і застосунків.

Підключення

Додайте 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.
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 у фронтматері. Її повна назва — @<namespace>/skills/<slug>, де 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
Правило пакетаЛіміт
Розмір 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 з токеном для виконуваних файлів. Співробітникам виконуваний файл не потрібен; достатньо 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 спершу перевіряє повну назву, потім id. Плагін указується в 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 встановлює продукт; див. Основні поняття.