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áře | Co dělá |
|---|---|---|
create | není potřeba | Vytvoří položku a její instalační kód. |
update | není potřeba | Mění pole, obsah, verzi nebo viditelnost. |
get, list, delete | není potřeba | Čte nebo odstraňuje vaše položky. |
install | není potřeba | Nainstaluje do jednoho z vašich botů: id, botId a cascade pro zahrnutí závislostí. |
bundle-token | nastaví se automaticky | Token pro nahrání zipu s textovými soubory. |
binary-token | nastaví se automaticky | Token pro nahrávání binárních souborů, plugin.json, agent.json a UI aplikací. |
list-binaries, delete-binary | nastaví se automaticky | Spravuje nahrané binární soubory. |
submit | nastaví se automaticky | Odešle verzi ke kontrole. |
| Pole | Význam |
|---|---|
name | Zobrazovaný název. Vytváří se z něj slug. |
description | Jeden řádek, pro odeslání 10 až 500 znaků. |
manifestContent | Hlavní soubor položky: SKILL.md, AGENT.md nebo PLUGIN.md. |
version | Sémantická verze. Výchozí 0.1.0. |
visibility | private (výchozí), loop (sdíleno s vašimi kanály) nebo public. |
category | Kategorie v obchodě. |
longDescription | Text „Co dělá“ v obchodě (jen update). |
sourceUrl, manifestUrl | Volitelné odkazy. |
dependencies | Jen 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íku | Limit |
|---|---|
| Velikost zipu | 50 MB |
| Každý soubor | 10 MB |
| Všechny soubory | 50 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žky | Význam |
|---|---|
draft | Neodesláno, nebo zamítnuto. |
pending_review, review | Čeká na kontrolu. |
active | Schváleno. Zveřejněno v obchodě, pokud je viditelnost public. |
revoked | Staž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.