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ára | Robí |
|---|---|---|
create | netreba | Vytvorí položku a jej inštalačný kód. |
update | netreba | Mení polia, obsah, verziu alebo viditeľnosť. |
get, list, delete | netreba | Prečíta alebo odstráni vaše položky. |
install | netreba | Nainštaluje na jedného z vašich botov: id, botId a cascade na zahrnutie závislostí. |
bundle-token | nastaví sa automaticky | Token na nahratie zipu s textovými súbormi. |
binary-token | nastaví sa automaticky | Token na nahrávanie binárnych súborov, plugin.json, agent.json a UI aplikácií. |
list-binaries, delete-binary | nastaví sa automaticky | Spravuje nahraté binárne súbory. |
submit | nastaví sa automaticky | Odošle verziu na kontrolu. |
| Pole | Význam |
|---|---|
name | Zobrazovaný názov. Vytvára sa z neho slug. |
description | Jeden riadok, na odoslanie 10 až 500 znakov. |
manifestContent | Hlavný súbor položky: SKILL.md, AGENT.md alebo PLUGIN.md. |
version | Sémantická verzia. Predvolene 0.1.0. |
visibility | private (predvolené), loop (zdieľané s vašimi kanálmi) alebo public. |
category | Kategória v obchode. |
longDescription | Text „Čo robí“ v obchode (len update). |
sourceUrl, manifestUrl | Voliteľné odkazy. |
dependencies | Len 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íka | Limit |
|---|---|
| Veľkosť zipu | 50 MB |
| Každý súbor | 10 MB |
| Všetky súbory | 50 MB |
| Typy súborov | Text, 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žky | Význam |
|---|---|
draft | Neodoslané alebo zamietnuté. |
pending_review, review | Čaká na kontrolu. |
active | Schválené. Zverejnené v obchode, keď je viditeľnosť public. |
revoked | Stiahnuté. |
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.