NeboAI
NeboAI
Zacznij

Publikowanie

Publikujesz w sklepie NeboAI przez serwer MCP NeboAI. Podłącz klienta MCP, utwórz element, prześlij jego pliki i wyślij wersję do weryfikacji. Te same narzędzia obsługują umiejętności, pracowników, wtyczki i aplikacje.

Łączenie

Dodaj https://neboai.com/mcp do dowolnego klienta MCP, który obsługuje serwery zdalne. Klient wykrywa serwer autoryzacji, rejestruje się i loguje Cię przez OAuth z PKCE. Połączyć się może każde konto NeboAI. Tokeny dostępu są ważne godzinę i odświeżają się przez 30 dni.

Konto dewelopera

Publikować może każdy, kto ma konto NeboAI. Wysyłanie wersji i przesyłanie plików korzysta z Twojego konta dewelopera, które jest zakładane za Ciebie, bezpłatnie, przy pierwszym zgłoszeniu lub prośbie o token przesyłania. Nie ma opłaty ani etapu zatwierdzania.

Aby publikować w imieniu zespołu, a nie własnym, wybierz konto zespołu na czas sesji. Musisz być członkiem zespołu.

developer(resource: "account", action: "list")
developer(resource: "account", action: "select", slug: "example-team")

developer może też założyć Twoje konto z wyprzedzeniem (action: "create", opcjonalnie) oraz wyświetlać i wybierać przestrzenie nazw (resource: "namespace"). Wybrana przestrzeń nazw staje się częścią każdej kwalifikowanej nazwy, którą publikujesz.

Narzędzia

Narzędzia skill, agent i plugin mają wspólny zestaw akcji. Aplikacje publikuje się narzędziem agent.

AkcjaKonto deweloperaDziałanie
createniepotrzebneTworzy element i jego kod instalacji.
updateniepotrzebneZmienia pola, treść, wersję lub widoczność.
get, list, deleteniepotrzebneOdczytuje lub usuwa Twoje elementy.
installniepotrzebneInstaluje na jednym z Twoich botów: id, botId oraz cascade, aby dołączyć zależności.
bundle-tokenzakładane automatycznieToken do przesyłania archiwum zip z plikami tekstowymi.
binary-tokenzakładane automatycznieToken do przesyłania plików binarnych, plugin.json, agent.json i interfejsów aplikacji.
list-binaries, delete-binaryzakładane automatycznieZarządza przesłanymi plikami binarnymi.
submitzakładane automatycznieWysyła wersję do weryfikacji.
PoleZnaczenie
nameNazwa wyświetlana. Na jej podstawie powstaje slug.
descriptionJeden wiersz, od 10 do 500 znaków przy zgłoszeniu.
manifestContentGłówny plik elementu: SKILL.md, AGENT.md lub PLUGIN.md.
versionWersja semantyczna. Domyślnie 0.1.0.
visibilityprivate (domyślnie), loop (udostępnione w Twoich kanałach) lub public.
categoryKategoria w sklepie.
longDescriptionTekst „Co robi” w sklepie (tylko update).
sourceUrl, manifestUrlOpcjonalne linki.
dependenciesTylko pracownicy. Zobacz Zależności.

Narzędzie marketplace przeszukuje sklep i wyświetla kategorie. Narzędzie pricing ustala cenę elementu; płatne elementy wymagają ukończenia konfiguracji wypłat.

Opublikuj umiejętność

Utwórz umiejętność z jej plikiem SKILL.md jako treścią.

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>")

Nazwij umiejętność polem name w nagłówku. Jej kwalifikowana nazwa to @<namespace>/skills/<slug>, ze slugiem utworzonym z nazwy wyświetlanej, a boty dopasowują kwalifikowane nazwy do pola name z nagłówka, więc obie muszą się zgadzać.

Jeśli umiejętność ma inne pliki, prześlij folder jako zip. Pojedynczy folder najwyższego poziomu w pliku zip jest usuwany automatycznie, a foldery kompilacji i kontroli wersji są pomijane.

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
Zasada paczkiLimit
Rozmiar pliku zip50 MB
Każdy plik10 MB
Wszystkie pliki50 MB
Typy plikówTekst, kod, dane, obrazy, PDF i czcionki, np. .md, .py, .js, .ts, .json, .yaml, .csv, .html. Wszystko w scripts/, bin/ lub dist/ jest akceptowane.
ŚcieżkiBez .. i bez ścieżek bezwzględnych.

Ustaw umiejętność jako publiczną i wyślij wersję.

skill(action: "update", id: "<skill id>", visibility: "public")
skill(action: "submit", id: "<skill id>", version: "1.0.0")

Opublikuj pracownika

Utwórz pracownika z jego plikiem AGENT.md jako treścią i jego zależnościami ze sklepu.

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" } ] })

Prześlij agent.json za pomocą tokenu binarnego. Pracownicy nie potrzebują pliku binarnego; config wystarczy. Aby dołączyć własny folder skills/ pracownika, prześlij zamiast tego pakiet jako paczkę: AGENT.md, agent.json i skills/ w jednym pliku 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

Trzymaj zależności w agent.json. Przesłany agent.json zastępuje zapisaną konfigurację, łącznie z zależnościami ustawionymi przez create lub update, a update z dependencies zastępuje zapisany agent.json. Gdy używasz obu, umieść ten sam obiekt dependencies wewnątrz agent.json.

Zależności

dependencies zawiera listy skills, agents i connectors. Każdy wpis to {qualifiedName, id, name}; NeboAI sprawdza najpierw pełną nazwę kwalifikowaną, a potem id. Wtyczkę umieszcza się na liście skills. Wtyczki wymagane przez umiejętności wymienione w agent.json są dodawane automatycznie. Gdy właściciel instaluje Twojego pracownika ze sklepu lub za pomocą jego kodu, bot instaluje razem z nim zależne umiejętności, wtyczki i pracowników.

Opublikuj wtyczkę lub aplikację

Wtyczki przesyłają po jednym pliku binarnym na platformę razem z plugin.json i umiejętnościami wtyczki; zobacz Wydawanie wtyczki. Aplikacja składająca się tylko ze strony nie potrzebuje pliku binarnego: prześlij jedną paczkę przez bundle-token zawierającą AGENT.md (z artifact_type: app), agent.json, manifest.json, ui/ i ewentualne skills/. Aplikacja z sidecarem używa tego samego przesyłania plików binarnych z narzędziem agent: plik binarny sidecara jako file z jego platform, a stronę jako ui, czyli archiwum .tar.gz folderu ui/. Zobacz Aplikacje.

Weryfikacja

submit wymaga treści głównego pliku i opisu o długości od 10 do 500 znaków. Każde zgłoszenie jest skanowane. Czysty wynik skanowania może zostać zatwierdzony automatycznie; wszystko, co zostanie oznaczone, trafia do ręcznej weryfikacji. Zatwierdzenie podpisuje ewentualne pliki binarne i aktywuje wersję. Odrzucona wersja wraca do szkicu.

Status elementuZnaczenie
draftNiewysłany lub odrzucony.
pending_review, reviewOczekuje na weryfikację.
activeZatwierdzony. Widoczny w sklepie, gdy widoczność to public.
revokedWycofany.

Kody instalacji

Każdy element dostaje kod instalacji przy utworzeniu: SKIL-, AGNT-, PLUG-, APPS-, CONN- lub COLL-, a po nim osiem znaków. Wpisanie kodu jako wiadomości na czacie Nebo instaluje element; zobacz Podstawowe pojęcia.