Csatlakozás
Adja hozzá a https://neboai.com/mcp címet bármely olyan MCP-klienshez, amely támogatja a távoli szervereket. A kliens felderíti az engedélyezési szervert, regisztrálja magát, és OAuth-tal és PKCE-vel bejelentkezteti Önt. Bármely NeboAI-fiók csatlakozhat. A hozzáférési tokenek egy óráig érvényesek, és 30 napig frissülnek.
Fejlesztői fiók
Bárki közzétehet, akinek NeboAI-fiókja van. A verzió beküldése és a fájlok feltöltése a fejlesztői fiókját használja, amelyet ingyen beállítunk Önnek, amikor először küld be vagy kér feltöltési tokent. Nincs díj, és nincs jóváhagyási lépés.
Ha saját maga helyett egy csapat nevében szeretne közzétenni, válassza ki a munkamenethez a csapat fiókját. Ehhez a csapat tagjának kell lennie.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
A developer előre is beállíthatja a fiókját (action: "create", opcionális), valamint listázza és kiválasztja a névtereket (resource: "namespace"). A kiválasztott névtér része lesz minden minősített névnek, amelyet közzétesz.
Eszközök
A skill, az agent és a plugin eszköz egy közös műveletkészleten osztozik. Az alkalmazásokat az agent eszközzel teheti közzé.
| Művelet | Fejlesztői fiók | Mit csinál |
|---|---|---|
create | nem szükséges | Létrehozza az elemet és a telepítési kódját. |
update | nem szükséges | Módosítja a mezőket, a tartalmat, a verziót vagy a láthatóságot. |
get, list, delete | nem szükséges | Beolvassa vagy eltávolítja az elemeit. |
install | nem szükséges | Telepít az egyik botjára: id, botId, és cascade a függőségek bevonásához. |
bundle-token | automatikusan beállítva | Token szöveges fájlokat tartalmazó zip feltöltéséhez. |
binary-token | automatikusan beállítva | Token binárisok, plugin.json, agent.json és alkalmazásfelületek feltöltéséhez. |
list-binaries, delete-binary | automatikusan beállítva | Kezeli a feltöltött binárisokat. |
submit | automatikusan beállítva | Beküld egy verziót ellenőrzésre. |
| Mező | Jelentés |
|---|---|
name | Megjelenített név. Ebből készül a slug. |
description | Egy sor, beküldéshez 10–500 karakter. |
manifestContent | Az elem fő fájlja: SKILL.md, AGENT.md vagy PLUGIN.md. |
version | Szemantikus verzió. Alapértelmezés: 0.1.0. |
visibility | private (alapértelmezés), loop (megosztva a csatornáival) vagy public. |
category | Piactéri kategória. |
longDescription | A piactéri „Mit csinál” szöveg (csak update esetén). |
sourceUrl, manifestUrl | Opcionális linkek. |
dependencies | Csak munkatársaknál. Lásd: Függőségek. |
A marketplace eszköz a piactéren keres, és listázza a kategóriákat. A pricing eszköz árat állít be egy elemhez; a fizetős elemekhez el kell végezni a kifizetési regisztrációt.
Készség közzététele
Hozza létre a készséget a SKILL.md fájljával mint tartalommal.
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>") Nevezze el a készséget a fejléc name mezőjével. A minősített neve @<namespace>/skills/<slug>, ahol a slug a megjelenített névből készül, és a botok a minősített neveket a fejléc name mezőjéhez illesztik, ezért a kettőnek egyeznie kell.
Ha a készségnek más fájljai is vannak, töltse fel a mappát zip-fájlként. A zip-fájlban lévő egyetlen legfelső szintű mappát automatikusan eltávolítjuk, a build- és verziókezelő mappákat pedig kihagyjuk.
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
| Csomagszabály | Korlát |
|---|---|
| Zip-méret | 50 MB |
| Fájlonként | 10 MB |
| Összes fájl | 50 MB |
| Fájltípusok | Szöveg, kód, adatok, képek, PDF és betűtípusok, például .md, .py, .js, .ts, .json, .yaml, .csv, .html. A scripts/, bin/ vagy dist/ alatti tartalom bármi lehet. |
| Elérési utak | Nincs .. és nincsenek abszolút elérési utak. |
Tegye nyilvánossá a készséget, és küldjön be egy verziót.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Munkatárs közzététele
Hozza létre a munkatársat az AGENT.md fájljával mint tartalommal és a piactéri függőségeivel.
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" } ] }) Töltse fel az agent.json fájlt egy binárisfeltöltési tokennel. A munkatársakhoz nem kell bináris; a config elég. Ha a munkatárs saját skills/ mappáját is bele szeretné foglalni, inkább csomagként töltse fel: az AGENT.md, az agent.json és a skills/ egy zip-fájlban.
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
A függőségeket tartsa az agent.json fájlban. A feltöltött agent.json lecseréli a tárolt konfigurációt, a create vagy update művelettel beállított függőségeket is beleértve, a dependencies értéket tartalmazó update pedig lecseréli a tárolt agent.json fájlt. Ha mindkettőt használja, ugyanazt a dependencies objektumot tegye az agent.json fájlba is.
Függőségek
A dependencies mező skills, agents és connectors listákat tartalmaz. Minden bejegyzés {qualifiedName, id, name} alakú; a NeboAI először a minősített nevet ellenőrzi, majd az azonosítót. A bővítmények a skills alatt szerepelnek. Az agent.json fájlban megnevezett készségekhez szükséges bővítmények automatikusan hozzáadódnak. Amikor egy tulajdonos a piactérről vagy a kódjával telepíti a munkatársát, a bot vele együtt telepíti a készség-, bővítmény- és munkatárs-függőségeit is.
Bővítmény vagy alkalmazás közzététele
A bővítmények platformonként egy binárist töltenek fel a bővítmény plugin.json fájljával és készségeivel; lásd: Bővítmény kiadása. A csak oldalból álló alkalmazáshoz nem kell bináris: töltsön fel egy csomagot a bundle-token segítségével, amely tartalmazza az AGENT.md (artifact_type: app értékkel), az agent.json, a manifest.json fájlt, a ui/ mappát és az esetleges skills/ mappát. A sidecarral rendelkező alkalmazás ugyanazt a binárisfeltöltést használja az agent eszközzel: a sidecar binárisát file értékként a platform megadásával, az oldalt pedig ui értékként, a ui/ mappa .tar.gz archívumaként. Lásd: Alkalmazások.
Ellenőrzés
A submit művelethez a fő fájl tartalma és egy 10–500 karakteres leírás szükséges. Minden beküldést átvizsgálunk. A tiszta vizsgálati eredmény automatikusan jóváhagyható; minden megjelölt elem kézi ellenőrzésre kerül. A jóváhagyás aláírja az esetleges binárisokat, és aktívvá teszi a verziót. Az elutasított verzió visszakerül piszkozat állapotba.
| Elem állapota | Jelentés |
|---|---|
draft | Nincs beküldve, vagy elutasítva. |
pending_review, review | Ellenőrzésre vár. |
active | Jóváhagyva. Ha a láthatóság public, megjelenik a piactéren. |
revoked | Visszavonva. |
Telepítési kódok
Minden elem a létrehozásakor megkapja a telepítési kódját: SKIL-, AGNT-, PLUG-, APPS-, CONN- vagy COLL-, utána nyolc karakter. Ha a kódot üzenetként beírja egy Nebo-csevegésbe, az telepíti az elemet; lásd: Alapfogalmak.