NeboAI
NeboAI
Začať

Publikovanie

V obchode NeboAI publikujete cez server MCP NeboAI. Pripojte klienta MCP, vytvorte položku, nahrajte jej súbory a odošlite verziu na kontrolu. Tie isté nástroje slúžia pre zručnosti, zamestnancov, doplnky aj aplikácie.

Pripojenie

Pridajte https://neboai.com/mcp do ľubovoľného klienta MCP, ktorý podporuje vzdialené servery. Klient zistí autorizačný server, zaregistruje sa a prihlási vás cez OAuth a PKCE. Pripojiť sa môže ktorýkoľvek účet NeboAI. Prístupové tokeny platia jednu hodinu a obnovujú sa 30 dní.

Účet vývojára

Publikovať môže ktokoľvek s účtom NeboAI. Odoslanie verzie a nahrávanie súborov používajú váš účet vývojára, ktorý sa vám zadarmo nastaví, keď prvýkrát niečo odošlete alebo požiadate o token na nahrávanie. Nie je tu žiadny poplatok ani schvaľovanie.

Ak chcete publikovať za tím namiesto seba, vyberte pre reláciu účet tímu. Musíte byť členom tímu.

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

developer vám môže účet nastaviť aj vopred (action: "create", voliteľné) a vypisuje a vyberá menné priestory (resource: "namespace"). Vybraný menný priestor sa stane súčasťou každého kvalifikovaného názvu, ktorý publikujete.

Nástroje

Nástroje skill, agent a plugin zdieľajú jednu sadu akcií. Aplikácie sa publikujú nástrojom agent.

AkciaÚčet vývojáraRobí
createnetrebaVytvorí položku a jej inštalačný kód.
updatenetrebaMení polia, obsah, verziu alebo viditeľnosť.
get, list, deletenetrebaPrečíta alebo odstráni vaše položky.
installnetrebaNainštaluje na jedného z vašich botov: id, botId a cascade na zahrnutie závislostí.
bundle-tokennastaví sa automatickyToken na nahratie zipu s textovými súbormi.
binary-tokennastaví sa automatickyToken na nahrávanie binárnych súborov, plugin.json, agent.json a UI aplikácií.
list-binaries, delete-binarynastaví sa automatickySpravuje nahraté binárne súbory.
submitnastaví sa automatickyOdošle verziu na kontrolu.
PoleVýznam
nameZobrazovaný názov. Vytvára sa z neho slug.
descriptionJeden riadok, na odoslanie 10 až 500 znakov.
manifestContentHlavný súbor položky: SKILL.md, AGENT.md alebo PLUGIN.md.
versionSémantická verzia. Predvolene 0.1.0.
visibilityprivate (predvolené), loop (zdieľané s vašimi kanálmi) alebo public.
categoryKategória v obchode.
longDescriptionText „Čo robí“ v obchode (len update).
sourceUrl, manifestUrlVoliteľné odkazy.
dependenciesLen zamestnanci. Pozri Závislosti.

Nástroj marketplace vyhľadáva v obchode a vypisuje kategórie. Nástroj pricing nastavuje cenu položky; platené položky vyžadujú dokončenie nastavenia výplat.

Publikovanie zručnosti

Vytvorte zručnosť s jej SKILL.md ako obsahom.

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

Pomenujte zručnosť pomocou name vo frontmatteri. Jej kvalifikovaný názov je @<namespace>/skills/<slug>, pričom slug sa vytvára zo zobrazovaného názvu, a boty prekladajú kvalifikované názvy podľa name vo frontmatteri, takže oba sa musia zhodovať.

Ak má zručnosť ďalšie súbory, nahrajte priečinok ako zip. Jediný priečinok na najvyššej úrovni v zipe sa automaticky odstráni a priečinky zostavovania a správy verzií sa preskočia.

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íkaLimit
Veľkosť zipu50 MB
Každý súbor10 MB
Všetky súbory50 MB
Typy súborovText, kód, dáta, obrázky, PDF a písma, napríklad .md, .py, .js, .ts, .json, .yaml, .csv, .html. Čokoľvek v scripts/, bin/ alebo dist/ sa prijme.
CestyŽiadne .. a žiadne absolútne cesty.

Zverejnite zručnosť a odošlite verziu.

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

Publikovanie zamestnanca

Vytvorte zamestnanca s jeho AGENT.md ako obsahom a s jeho závislosťami 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 pomocou binárneho tokenu. Zamestnanci nepotrebujú binárny súbor; stačí config. Ak chcete zahrnúť vlastný priečinok skills/ zamestnanca, nahrajte namiesto toho balík ako bundle: AGENT.md, agent.json a skills/ v jednom zipe.

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. Nahratý agent.json nahradí uloženú konfiguráciu vrátane závislostí nastavených cez create alebo update a update s dependencies nahradí uložený agent.json. Keď používate oboje, vložte ten istý objekt dependencies do agent.json.

Závislosti

dependencies obsahuje zoznamy skills, agents a connectors. Každá položka je {qualifiedName, id, name}; NeboAI najprv overí úplný názov, potom id. Doplnok sa uvádza v skills. Doplnky, ktoré vyžadujú zručnosti uvedené v agent.json, sa pridajú automaticky. Keď vlastník nainštaluje vášho zamestnanca z obchodu alebo pomocou jeho kódu, bot s ním nainštaluje aj jeho závislosti — zručnosti, doplnky a zamestnancov.

Publikovanie doplnku alebo aplikácie

Doplnky nahrávajú jeden binárny súbor na platformu spolu s plugin.json a zručnosťami doplnku; pozri Vydanie doplnku. Aplikácia len so stránkou nepotrebuje binárny súbor: nahrajte jeden balík pomocou bundle-token s AGENT.md (s artifact_type: app), agent.json, manifest.json, ui/ a prípadnými skills/. Aplikácia so sidecarom používa to isté nahrávanie binárnych súborov s nástrojom agent: binárny súbor sidecaru ako file s jeho platform a stránku ako ui, archív .tar.gz priečinka ui/. Pozri Aplikácie.

Kontrola

submit potrebuje obsah hlavného súboru a popis s 10 až 500 znakmi. Každé odoslanie sa preskenuje. Čisté skenovanie môže byť schválené automaticky; čokoľvek označené ide na ručnú kontrolu. Schválením sa podpíšu prípadné binárne súbory a verzia sa aktivuje. Zamietnutá verzia sa vráti do konceptu.

Stav položkyVýznam
draftNeodoslané alebo zamietnuté.
pending_review, reviewČaká na kontrolu.
activeSchválené. Zverejnené v obchode, keď je viditeľnosť public.
revokedStiahnuté.

Inštalačné kódy

Každá položka dostane inštalačný kód pri vytvorení: SKIL-, AGNT-, PLUG-, APPS-, CONN- alebo COLL- nasledované ôsmimi znakmi. Napísaním kódu ako správy do chatu Nebo sa položka nainštaluje; pozri Základné pojmy.