NeboAI
NeboAI
Kom i gang

Udgivelse

Du udgiver på NeboAI-markedspladsen gennem NeboAI's MCP-server. Forbind en MCP-klient, opret elementet, upload dets filer, og indsend en version til gennemgang. De samme værktøjer bruges til færdigheder, medarbejdere, plugins og apps.

Forbind

Tilføj https://neboai.com/mcp til en hvilken som helst MCP-klient, der understøtter fjernservere. Klienten finder godkendelsesserveren, registrerer sig selv og logger dig ind med OAuth og PKCE. Enhver NeboAI-konto kan forbinde. Adgangstokens varer én time og fornyes i 30 dage.

Udviklerkonto

Alle med en NeboAI-konto kan udgive. At indsende en version og uploade filer bruger din udviklerkonto, som oprettes for dig, gratis, første gang du indsender eller beder om et upload-token. Der er intet gebyr og intet godkendelsestrin.

For at udgive for et team i stedet for dig selv vælger du teamets konto for sessionen. Du skal være medlem af teamet.

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

developer kan også oprette din konto på forhånd (action: "create", valgfrit) og viser og vælger navnerum (resource: "namespace"). Det valgte navnerum bliver en del af hvert kvalificeret navn, du udgiver.

Værktøjer

Værktøjerne skill, agent og plugin deler ét sæt handlinger. Apps udgives med værktøjet agent.

HandlingUdviklerkontoGør
createikke nødvendigOpretter elementet og dets installationskode.
updateikke nødvendigÆndrer felter, indhold, version eller synlighed.
get, list, deleteikke nødvendigLæser eller fjerner dine elementer.
installikke nødvendigInstallerer på en af dine bots: id, botId og cascade for at medtage afhængigheder.
bundle-tokenoprettes automatiskEt token til at uploade en zip-fil med tekstfiler.
binary-tokenoprettes automatiskEt token til at uploade binære filer, plugin.json, agent.json og appgrænseflader.
list-binaries, delete-binaryoprettes automatiskAdministrerer uploadede binære filer.
submitoprettes automatiskIndsender en version til gennemgang.
FeltBetydning
nameVisningsnavn. Slug'en dannes ud fra det.
descriptionÉn linje, 10 til 500 tegn for at indsende.
manifestContentElementets hovedfil: SKILL.md, AGENT.md eller PLUGIN.md.
versionSemantisk version. Standard 0.1.0.
visibilityprivate (standard), loop (delt med dine kanaler) eller public.
categoryKategori på markedspladsen.
longDescriptionMarkedspladsens tekst “Hvad den gør” (kun update).
sourceUrl, manifestUrlValgfrie links.
dependenciesKun medarbejdere. Se Afhængigheder.

Værktøjet marketplace søger på markedspladsen og viser kategorier. Værktøjet pricing sætter en pris på et element; betalte elementer kræver, at opsætningen af udbetalinger er gennemført.

Udgiv en færdighed

Opret færdigheden med dens SKILL.md som indhold.

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

Navngiv færdigheden med dens frontmatter name. Dens kvalificerede navn er @<namespace>/skills/<slug>, hvor slug'en dannes ud fra visningsnavnet, og bots slår kvalificerede navne op mod frontmatter name, så de to skal passe sammen.

Hvis færdigheden har andre filer, så upload mappen som en zip-fil. En enkelt mappe på øverste niveau i zip-filen fjernes automatisk, og mapper til build og versionsstyring springes over.

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
Regel for pakkenGrænse
Zip-størrelse50 MB
Hver fil10 MB
Alle filer50 MB
FiltyperTekst, kode, data, billeder, PDF og skrifttyper, f.eks. .md, .py, .js, .ts, .json, .yaml, .csv, .html. Alt under scripts/, bin/ eller dist/ accepteres.
StierIngen .. og ingen absolutte stier.

Gør færdigheden offentlig, og indsend en version.

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

Udgiv en medarbejder

Opret medarbejderen med dens AGENT.md som indhold og dens afhængigheder fra markedspladsen.

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 med et binært token. Medarbejdere kræver ingen binær; config er nok. For at medtage medarbejderens egen skills/-mappe uploader du i stedet pakken som et bundt: AGENT.md, agent.json og skills/ i én zip-fil.

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

Hold afhængigheder i agent.json. En uploadet agent.json erstatter den gemte konfiguration, herunder afhængigheder angivet med create eller update, og en update med dependencies erstatter den gemte agent.json. Når du bruger begge, så læg det samme dependencies-objekt i agent.json.

Afhængigheder

dependencies har listerne skills, agents og connectors. Hver post er {qualifiedName, id, name}; NeboAI tjekker først det kvalificerede navn og derefter id'et. Et plugin angives under skills. Plugins, som kræves af færdigheder nævnt i agent.json, tilføjes automatisk. Når en ejer installerer din medarbejder fra markedspladsen eller med dens kode, installerer botten dens færdigheds-, plugin- og medarbejderafhængigheder sammen med den.

Udgiv et plugin eller en app

Plugins uploader én binær pr. platform med pluginets plugin.json og færdigheder; se Udgiv et plugin. En app, der kun består af en side, kræver ingen binær: upload ét bundt med bundle-token, der indeholder AGENT.md (med artifact_type: app), agent.json, manifest.json, ui/ og eventuelle skills/. En app med en sidecar bruger den samme binære upload med værktøjet agent: sidecar-binæren som file med dens platform og siden som ui, en .tar.gz af ui/-mappen. Se Apps.

Gennemgang

submit kræver hovedfilens indhold og en beskrivelse på 10 til 500 tegn. Hver indsendelse scannes. En ren scanning kan godkendes automatisk; alt, der markeres, går til manuel gennemgang. Godkendelse signerer eventuelle binære filer og gør versionen aktiv. En afvist version vender tilbage til kladde.

Elementets statusBetydning
draftIkke indsendt, eller afvist.
pending_review, reviewVenter på gennemgang.
activeGodkendt. Listet på markedspladsen, når synligheden er public.
revokedTrukket tilbage.

Installationskoder

Hvert element får sin installationskode, når det oprettes: SKIL-, AGNT-, PLUG-, APPS-, CONN- eller COLL- efterfulgt af otte tegn. Når du skriver koden som en besked i en Nebo-chat, installeres elementet; se Grundbegreber.