NeboAI
NeboAI
Začít

Publikování

Do obchodu NeboAI publikujete přes server MCP NeboAI. Připojte klienta MCP, vytvořte položku, nahrajte její soubory a odešlete verzi ke kontrole. Stejné nástroje slouží pro dovednosti, zaměstnance, pluginy i aplikace.

Připojení

Přidejte https://neboai.com/mcp do libovolného klienta MCP, který podporuje vzdálené servery. Klient zjistí autorizační server, zaregistruje se a přihlásí vás pomocí OAuth a PKCE. Připojit se může jakýkoli účet NeboAI. Přístupové tokeny platí jednu hodinu a obnovují se po dobu 30 dní.

Účet vývojáře

Publikovat může kdokoli s účtem NeboAI. Odeslání verze a nahrávání souborů používá váš účet vývojáře, který se vám zdarma nastaví, když poprvé něco odešlete nebo požádáte o token pro nahrání. Žádný poplatek ani schvalování.

Chcete-li publikovat za tým místo sebe, vyberte pro relaci účet týmu. Musíte být členem týmu.

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

developer umí také nastavit váš účet předem (action: "create", volitelné) a vypisuje a vybírá jmenné prostory (resource: "namespace"). Vybraný jmenný prostor se stane součástí každého kvalifikovaného názvu, který publikujete.

Nástroje

Nástroje skill, agent a plugin sdílejí jednu sadu akcí. Aplikace se publikují nástrojem agent.

AkceÚčet vývojářeCo dělá
createnení potřebaVytvoří položku a její instalační kód.
updatenení potřebaMění pole, obsah, verzi nebo viditelnost.
get, list, deletenení potřebaČte nebo odstraňuje vaše položky.
installnení potřebaNainstaluje do jednoho z vašich botů: id, botId a cascade pro zahrnutí závislostí.
bundle-tokennastaví se automatickyToken pro nahrání zipu s textovými soubory.
binary-tokennastaví se automatickyToken pro nahrávání binárních souborů, plugin.json, agent.json a UI aplikací.
list-binaries, delete-binarynastaví se automatickySpravuje nahrané binární soubory.
submitnastaví se automatickyOdešle verzi ke kontrole.
PoleVýznam
nameZobrazovaný název. Vytváří se z něj slug.
descriptionJeden řádek, pro odeslání 10 až 500 znaků.
manifestContentHlavní soubor položky: SKILL.md, AGENT.md nebo PLUGIN.md.
versionSémantická verze. Výchozí 0.1.0.
visibilityprivate (výchozí), loop (sdíleno s vašimi kanály) nebo public.
categoryKategorie v obchodě.
longDescriptionText „Co dělá“ v obchodě (jen update).
sourceUrl, manifestUrlVolitelné odkazy.
dependenciesJen zaměstnanci. Viz Závislosti.

Nástroj marketplace prohledává obchod a vypisuje kategorie. Nástroj pricing nastavuje cenu položky; placené položky vyžadují dokončení nastavení výplat.

Publikování dovednosti

Vytvořte dovednost s jejím SKILL.md jako obsahem.

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

Pojmenujte dovednost pomocí name v jejím úvodním bloku. Její kvalifikovaný název je @<namespace>/skills/<slug>, se slugem vytvořeným ze zobrazovaného názvu, a boti kvalifikované názvy porovnávají s name z úvodního bloku, takže se obojí musí shodovat.

Pokud má dovednost další soubory, nahrajte složku jako zip. Jediná složka nejvyšší úrovně v zipu se automaticky odstraní a složky pro sestavení a správu verzí se přeskočí.

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
Pravidlo balíkuLimit
Velikost zipu50 MB
Každý soubor10 MB
Všechny soubory50 MB
Typy souborůText, kód, data, obrázky, PDF a písma, například .md, .py, .js, .ts, .json, .yaml, .csv, .html. Cokoli v scripts/, bin/ nebo dist/ se přijme.
CestyŽádné .. a žádné absolutní cesty.

Zveřejněte dovednost a odešlete verzi.

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

Publikování zaměstnance

Vytvořte zaměstnance s jeho AGENT.md jako obsahem a s jeho závislostmi z obchodu.

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

Nahrajte agent.json pomocí binárního tokenu. Zaměstnanci nepotřebují binární soubor; stačí config. Chcete-li zahrnout vlastní složku skills/ zaměstnance, nahrajte místo toho balíček jako balík: AGENT.md, agent.json a skills/ v jednom zipu.

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

Závislosti držte v agent.json. Nahraný agent.json nahradí uloženou konfiguraci včetně závislostí nastavených pomocí create nebo update a update s dependencies nahradí uložený agent.json. Když používáte obojí, vložte stejný objekt dependencies do agent.json.

Závislosti

dependencies obsahuje seznamy skills, agents a connectors. Každá položka je {qualifiedName, id, name}; NeboAI nejprve kontroluje kvalifikovaný název, poté id. Plugin se uvádí pod skills. Pluginy vyžadované dovednostmi uvedenými v agent.json se přidají automaticky. Když vlastník nainstaluje vašeho zaměstnance z obchodu nebo pomocí jeho kódu, bot s ním nainstaluje i jeho závislosti na dovednostech, pluginech a zaměstnancích.

Publikování pluginu nebo aplikace

Pluginy nahrávají jeden binární soubor na platformu spolu s plugin.json a dovednostmi pluginu; viz Vydání pluginu. Aplikace jen se stránkou nepotřebuje binární soubor: nahrajte jeden balík pomocí bundle-token, který obsahuje AGENT.md (s artifact_type: app), agent.json, manifest.json, ui/ a případné skills/. Aplikace se sidecarem používá stejné nahrávání binárních souborů s nástrojem agent: binární soubor sidecaru jako file s jeho platform a stránku jako ui, tedy .tar.gz složky ui/. Viz Aplikace.

Kontrola

submit potřebuje obsah hlavního souboru a popis o délce 10 až 500 znaků. Každé odeslání se prověří. Čisté prověření může být schváleno automaticky; cokoli označeného jde k ruční kontrole. Schválení podepíše případné binární soubory a aktivuje verzi. Zamítnutá verze se vrátí do konceptu.

Stav položkyVýznam
draftNeodesláno, nebo zamítnuto.
pending_review, reviewČeká na kontrolu.
activeSchváleno. Zveřejněno v obchodě, pokud je viditelnost public.
revokedStaženo.

Instalační kódy

Každá položka dostane instalační kód při vytvoření: SKIL-, AGNT-, PLUG-, APPS-, CONN- nebo COLL- následované osmi znaky. Napsáním kódu jako zprávy do chatu Nebo se položka nainstaluje; viz Základní pojmy.