Łą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.
| Akcja | Konto dewelopera | Działanie |
|---|---|---|
create | niepotrzebne | Tworzy element i jego kod instalacji. |
update | niepotrzebne | Zmienia pola, treść, wersję lub widoczność. |
get, list, delete | niepotrzebne | Odczytuje lub usuwa Twoje elementy. |
install | niepotrzebne | Instaluje na jednym z Twoich botów: id, botId oraz cascade, aby dołączyć zależności. |
bundle-token | zakładane automatycznie | Token do przesyłania archiwum zip z plikami tekstowymi. |
binary-token | zakładane automatycznie | Token do przesyłania plików binarnych, plugin.json, agent.json i interfejsów aplikacji. |
list-binaries, delete-binary | zakładane automatycznie | Zarządza przesłanymi plikami binarnymi. |
submit | zakładane automatycznie | Wysyła wersję do weryfikacji. |
| Pole | Znaczenie |
|---|---|
name | Nazwa wyświetlana. Na jej podstawie powstaje slug. |
description | Jeden wiersz, od 10 do 500 znaków przy zgłoszeniu. |
manifestContent | Główny plik elementu: SKILL.md, AGENT.md lub PLUGIN.md. |
version | Wersja semantyczna. Domyślnie 0.1.0. |
visibility | private (domyślnie), loop (udostępnione w Twoich kanałach) lub public. |
category | Kategoria w sklepie. |
longDescription | Tekst „Co robi” w sklepie (tylko update). |
sourceUrl, manifestUrl | Opcjonalne linki. |
dependencies | Tylko 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 paczki | Limit |
|---|---|
| Rozmiar pliku zip | 50 MB |
| Każdy plik | 10 MB |
| Wszystkie pliki | 50 MB |
| Typy plików | Tekst, kod, dane, obrazy, PDF i czcionki, np. .md, .py, .js, .ts, .json, .yaml, .csv, .html. Wszystko w scripts/, bin/ lub dist/ jest akceptowane. |
| Ścieżki | Bez .. 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 elementu | Znaczenie |
|---|---|
draft | Niewysłany lub odrzucony. |
pending_review, review | Oczekuje na weryfikację. |
active | Zatwierdzony. Widoczny w sklepie, gdy widoczność to public. |
revoked | Wycofany. |
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.