NeboAI
NeboAI
Aan de slag

Publiceren

Je publiceert op de NeboAI-marktplaats via de NeboAI MCP-server. Verbind een MCP-client, maak het item aan, upload de bestanden en dien een versie in ter beoordeling. Dezelfde tools werken voor skills, medewerkers, plug-ins en apps.

Verbinden

Voeg https://neboai.com/mcp toe aan elke MCP-client die externe servers ondersteunt. De client vindt de autorisatieserver, registreert zichzelf en logt je in met OAuth en PKCE. Elk NeboAI-account kan verbinding maken. Toegangstokens zijn een uur geldig en worden 30 dagen lang vernieuwd.

Ontwikkelaarsaccount

Iedereen met een NeboAI-account kan publiceren. Een versie indienen en bestanden uploaden gebeurt met je ontwikkelaarsaccount, dat gratis voor je wordt aangemaakt de eerste keer dat je iets indient of om een uploadtoken vraagt. Er zijn geen kosten en er is geen goedkeuringsstap.

Selecteer voor de sessie het account van het team als je voor een team wilt publiceren in plaats van voor jezelf. Je moet lid zijn van het team.

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

developer kan je account ook van tevoren aanmaken (action: "create", optioneel) en namespaces weergeven en selecteren (resource: "namespace"). De geselecteerde namespace wordt onderdeel van elke volledige naam die je publiceert.

Tools

De tools skill, agent en plugin delen één set acties. Apps worden gepubliceerd met de tool agent.

ActieOntwikkelaarsaccountDoet
createniet nodigMaakt het item en de installatiecode aan.
updateniet nodigWijzigt velden, inhoud, versie of zichtbaarheid.
get, list, deleteniet nodigLeest of verwijdert je items.
installniet nodigInstalleert op een van je bots: id, botId en cascade om afhankelijkheden mee te nemen.
bundle-tokenautomatisch aangemaaktEen token om een zip met tekstbestanden te uploaden.
binary-tokenautomatisch aangemaaktEen token om binaries, plugin.json, agent.json en app-UI's te uploaden.
list-binaries, delete-binaryautomatisch aangemaaktBeheert geüploade binaries.
submitautomatisch aangemaaktDient een versie in ter beoordeling.
VeldBetekenis
nameWeergavenaam. De slug wordt ervan afgeleid.
descriptionEén regel, 10 tot 500 tekens om in te dienen.
manifestContentHet hoofdbestand van het item: SKILL.md, AGENT.md of PLUGIN.md.
versionSemantische versie. Standaard 0.1.0.
visibilityprivate (standaard), loop (gedeeld met je kanalen) of public.
categoryCategorie op de marktplaats.
longDescriptionDe tekst “Wat het doet” op de marktplaats (alleen update).
sourceUrl, manifestUrlOptionele links.
dependenciesAlleen medewerkers. Zie Afhankelijkheden.

De tool marketplace doorzoekt de marktplaats en geeft categorieën weer. De tool pricing stelt een prijs in voor een item; voor betaalde items moet je de onboarding voor uitbetalingen afronden.

Een skill publiceren

Maak de skill aan met zijn SKILL.md als inhoud.

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

Geef de skill een naam met de name in zijn frontmatter. Zijn volledige naam is @<namespace>/skills/<slug>, waarbij de slug van de weergavenaam wordt afgeleid, en bots zoeken volledige namen op aan de hand van de name in de frontmatter, dus die twee moeten overeenkomen.

Heeft de skill nog andere bestanden, upload de map dan als zip. Eén enkele map op het hoogste niveau in de zip wordt automatisch verwijderd, en build- en versiebeheermappen worden overgeslagen.

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
BundelregelLimiet
Zipgrootte50 MB
Elk bestand10 MB
Alle bestanden50 MB
BestandstypenTekst, code, data, afbeeldingen, PDF en lettertypen, zoals .md, .py, .js, .ts, .json, .yaml, .csv, .html. Alles onder scripts/, bin/ of dist/ wordt geaccepteerd.
PadenGeen .. en geen absolute paden.

Maak de skill openbaar en dien een versie in.

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

Een medewerker publiceren

Maak de medewerker aan met zijn AGENT.md als inhoud en zijn afhankelijkheden van de marktplaats.

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

Upload agent.json met een binary-token. Medewerkers hebben geen binary nodig; config is genoeg. Wil je de eigen map skills/ van de medewerker meenemen, upload het pakket dan als bundel: AGENT.md, agent.json en skills/ in één zip.

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

Houd afhankelijkheden in agent.json. Een geüploade agent.json vervangt de opgeslagen configuratie, inclusief afhankelijkheden die met create of update zijn ingesteld, en een update met dependencies vervangt de opgeslagen agent.json. Gebruik je beide, zet dan hetzelfde dependencies-object in agent.json.

Afhankelijkheden

dependencies bevat de lijsten skills, agents en connectors. Elk item is {qualifiedName, id, name}; NeboAI controleert eerst de gekwalificeerde naam en daarna de id. Een plugin staat onder skills. Plugins die nodig zijn voor skills die in agent.json worden genoemd, worden automatisch toegevoegd. Als een eigenaar je medewerker installeert vanuit de marktplaats of met de code, installeert de bot de afhankelijke skills, plugins en medewerkers mee.

Een plug-in of app publiceren

Plug-ins uploaden één binary per platform met de plugin.json en skills van de plug-in; zie Een plug-in uitbrengen. Een app met alleen een pagina heeft geen binary nodig: upload één bundel met bundle-token die AGENT.md (met artifact_type: app), agent.json, manifest.json, ui/ en eventuele skills/ bevat. Een app met een sidecar gebruikt dezelfde binary-upload met de tool agent: de sidecar-binary als file met zijn platform, en de pagina als ui, een .tar.gz van de map ui/. Zie Apps.

Beoordeling

submit heeft de inhoud van het hoofdbestand nodig en een beschrijving van 10 tot 500 tekens. Elke indiening wordt gescand. Een schone scan kan automatisch worden goedgekeurd; alles wat wordt gemarkeerd, gaat naar handmatige beoordeling. Bij goedkeuring worden eventuele binaries ondertekend en wordt de versie actief. Een afgewezen versie gaat terug naar concept.

Status van het itemBetekenis
draftNiet ingediend, of afgewezen.
pending_review, reviewWacht op beoordeling.
activeGoedgekeurd. Vermeld op de marktplaats als de zichtbaarheid public is.
revokedTeruggetrokken.

Installatiecodes

Elk item krijgt bij het aanmaken een installatiecode: SKIL-, AGNT-, PLUG-, APPS-, CONN- of COLL- gevolgd door acht tekens. Als je de code als bericht in een Nebo-chat typt, wordt het item geïnstalleerd; zie Kernbegrippen.