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Отображаемое имя. Из него формируется слаг.
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>, где слаг формируется из отображаемого имени, а боты сопоставляют полные имена с name из фронтматтера, поэтому они должны совпадать.

Если у навыка есть другие файлы, загрузите папку как 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 сначала проверяет полное имя, затем id. Плагин указывается в skills. Плагины, необходимые навыкам, перечисленным в agent.json, добавляются автоматически. Когда владелец устанавливает вашего сотрудника из маркетплейса или по его коду, бот вместе с ним устанавливает зависимости — навыки, плагины и сотрудников.

Публикация плагина или приложения

Плагины загружают по одному бинарному файлу на платформу вместе с plugin.json и навыками плагина; см. Выпуск плагина. Приложению только со страницей бинарный файл не нужен: загрузите один пакет через 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, объект установится; см. Основные понятия.