NeboAI
NeboAI
Kezdés

Közzététel

A NeboAI piactéren a NeboAI MCP-szerverén keresztül tehet közzé. Csatlakoztasson egy MCP-klienst, hozza létre az elemet, töltse fel a fájljait, és küldjön be egy verziót ellenőrzésre. Ugyanazok az eszközök szolgálják ki a készségeket, a munkatársakat, a bővítményeket és az alkalmazásokat.

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űveletFejlesztői fiókMit csinál
createnem szükségesLétrehozza az elemet és a telepítési kódját.
updatenem szükségesMódosítja a mezőket, a tartalmat, a verziót vagy a láthatóságot.
get, list, deletenem szükségesBeolvassa vagy eltávolítja az elemeit.
installnem szükségesTelepít az egyik botjára: id, botId, és cascade a függőségek bevonásához.
bundle-tokenautomatikusan beállítvaToken szöveges fájlokat tartalmazó zip feltöltéséhez.
binary-tokenautomatikusan beállítvaToken binárisok, plugin.json, agent.json és alkalmazásfelületek feltöltéséhez.
list-binaries, delete-binaryautomatikusan beállítvaKezeli a feltöltött binárisokat.
submitautomatikusan beállítvaBeküld egy verziót ellenőrzésre.
MezőJelentés
nameMegjelenített név. Ebből készül a slug.
descriptionEgy sor, beküldéshez 10–500 karakter.
manifestContentAz elem fő fájlja: SKILL.md, AGENT.md vagy PLUGIN.md.
versionSzemantikus verzió. Alapértelmezés: 0.1.0.
visibilityprivate (alapértelmezés), loop (megosztva a csatornáival) vagy public.
categoryPiactéri kategória.
longDescriptionA piactéri „Mit csinál” szöveg (csak update esetén).
sourceUrl, manifestUrlOpcionális linkek.
dependenciesCsak 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ályKorlát
Zip-méret50 MB
Fájlonként10 MB
Összes fájl50 MB
FájltípusokSzö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 utakNincs .. é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 állapotaJelentés
draftNincs beküldve, vagy elutasítva.
pending_review, reviewEllenőrzésre vár.
activeJóváhagyva. Ha a láthatóság public, megjelenik a piactéren.
revokedVisszavonva.

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.