NeboAI
NeboAI
Magsimula

Pag-publish

Nagpa-publish ka sa NeboAI marketplace sa pamamagitan ng NeboAI MCP server. Ikonekta ang isang MCP client, gawin ang artifact, i-upload ang mga file nito, at mag-submit ng bersyon para sa review. Parehong mga tool ang nagsisilbi sa mga skill, empleyado, plugin at app.

Kumonekta

Idagdag ang https://neboai.com/mcp sa kahit anong MCP client na sumusuporta sa mga remote server. Natutuklasan ng client ang authorization server, nire-register ang sarili, at pinapa-sign in ka gamit ang OAuth at PKCE. Kahit anong NeboAI account ay makakakonekta. Tumatagal nang isang oras ang mga access token at nare-refresh nang hanggang 30 araw.

Developer account

Kahit sino na may NeboAI account ay puwedeng mag-publish. Ginagamit ng pag-submit ng bersyon at pag-upload ng mga file ang developer account mo, na libreng sine-set up para sa iyo sa unang beses na mag-submit ka o humingi ng upload token. Walang bayad at walang hakbang ng pag-apruba.

Para mag-publish para sa isang team sa halip na para sa sarili mo, piliin ang account ng team para sa session. Dapat miyembro ka ng team.

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

Kaya rin ng developer na i-set up ang account mo nang maaga (action: "create", opsyonal) at maglista at pumili ng mga namespace (resource: "namespace"). Nagiging bahagi ng bawat qualified name na pina-publish mo ang napiling namespace.

Mga Tool

Iisang hanay ng action ang ginagamit ng mga tool na skill, agent at plugin. Pina-publish ang mga app gamit ang agent tool.

ActionDeveloper accountGinagawa
createhindi kailanganGinagawa ang artifact at ang install code nito.
updatehindi kailanganBinabago ang mga field, content, bersyon o visibility.
get, list, deletehindi kailanganBinabasa o inaalis ang mga artifact mo.
installhindi kailanganNag-i-install sa isa sa mga bot mo: id, botId, at cascade para isama ang mga dependency.
bundle-tokenkusang sine-set upToken para sa pag-upload ng zip ng mga text file.
binary-tokenkusang sine-set upToken para sa pag-upload ng mga binary, plugin.json, agent.json at mga app UI.
list-binaries, delete-binarykusang sine-set upPinamamahalaan ang mga na-upload na binary.
submitkusang sine-set upNagsu-submit ng bersyon para sa review.
FieldKahulugan
nameDisplay name. Dito ginagawa ang slug.
descriptionIsang linya, 10 hanggang 500 character para ma-submit.
manifestContentAng pangunahing file ng artifact: SKILL.md, AGENT.md o PLUGIN.md.
versionSemantic version. Default 0.1.0.
visibilityprivate (default), loop (ibinabahagi sa mga Channel mo) o public.
categoryKategorya sa marketplace.
longDescriptionAng text na “What it does” sa marketplace (update lang).
sourceUrl, manifestUrlMga opsyonal na link.
dependenciesPara lang sa mga empleyado. Tingnan ang Dependencies.

Naghahanap sa marketplace at naglilista ng mga kategorya ang marketplace tool. Nagtatakda ng presyo sa isang artifact ang pricing tool; kailangang tapusin ang payout onboarding para sa mga bayad na artifact.

Mag-publish ng skill

Gawin ang skill na ang SKILL.md nito ang content.

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

Pangalanan ang skill gamit ang name sa frontmatter nito. Ang qualified name nito ay @<namespace>/skills/<slug>, na ang slug ay ginawa mula sa display name, at nire-resolve ng mga bot ang mga qualified name laban sa name sa frontmatter, kaya dapat magkatugma ang dalawa.

Kung may iba pang file ang skill, i-upload ang folder bilang zip. Kusang inaalis ang iisang top-level folder sa zip, at nilalaktawan ang mga folder ng build at version control.

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
Patakaran sa bundleLimitasyon
Laki ng zip50 MB
Bawat file10 MB
Lahat ng file50 MB
Mga uri ng fileText, code, data, larawan, PDF at font, gaya ng .md, .py, .js, .ts, .json, .yaml, .csv, .html. Tinatanggap ang anumang nasa ilalim ng scripts/, bin/ o dist/.
Mga PathWalang .. at walang absolute path.

Gawing public ang skill at mag-submit ng bersyon.

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

Mag-publish ng empleyado

Gawin ang empleyado na ang AGENT.md nito ang content at kasama ang mga marketplace dependency nito.

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

I-upload ang agent.json gamit ang binary token. Hindi kailangan ng binary ang mga empleyado; sapat na ang config. Para isama ang sariling skills/ folder ng empleyado, i-upload na lang ang package bilang bundle: AGENT.md, agent.json at skills/ sa iisang 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

Panatilihin ang mga dependency sa agent.json. Pinapalitan ng na-upload na agent.json ang nakaimbak na configuration, kasama ang mga dependency na itinakda gamit ang create o update, at pinapalitan ng update na may dependencies ang nakaimbak na agent.json. Kapag ginamit mo ang dalawa, ilagay ang parehong dependencies object sa loob ng agent.json.

Mga Dependency

May listahang skills, agents at connectors ang dependencies. Ang bawat entry ay {qualifiedName, id, name}; sinusuri muna ng NeboAI ang qualified name, pagkatapos ang id. Nakalista sa ilalim ng skills ang isang plugin. Awtomatikong idinadagdag ang mga plugin na kailangan ng mga skill na pinangalanan sa agent.json. Kapag in-install ng may-ari ang empleyado mo mula sa marketplace o gamit ang code nito, ini-install din ng bot ang mga skill, plugin at empleyadong dependency nito.

Mag-publish ng plugin o app

Nag-a-upload ang mga plugin ng isang binary bawat platform kasama ang plugin.json at mga skill ng plugin; tingnan ang Pag-ship ng Plugin. Hindi kailangan ng binary ang app na pahina lang: mag-upload ng isang bundle gamit ang bundle-token na may AGENT.md (na may artifact_type: app), agent.json, manifest.json, ui/ at anumang skills/. Ginagamit ng app na may sidecar ang parehong binary upload gamit ang agent tool: ang sidecar binary bilang file kasama ang platform nito, at ang pahina bilang ui, isang .tar.gz ng ui/ folder. Tingnan ang Apps.

Review

Kailangan ng submit ang content ng pangunahing file at isang paglalarawan na 10 hanggang 500 character. Ini-scan ang bawat submission. Puwedeng awtomatikong maaprubahan ang malinis na scan; napupunta sa manual na review ang anumang na-flag. Pinipirmahan ng pag-apruba ang anumang binary at ginagawang aktibo ang bersyon. Bumabalik sa draft ang na-reject na bersyon.

Status ng artifactKahulugan
draftHindi na-submit, o na-reject.
pending_review, reviewNaghihintay ng review.
activeInaprubahan. Nakalista sa marketplace kapag public ang visibility.
revokedBinawi.

Mga install code

Nakukuha ng bawat artifact ang install code nito kapag ginawa ito: SKIL-, AGNT-, PLUG-, APPS-, CONN- o COLL- na sinusundan ng walong character. Nag-i-install ng artifact ang pag-type ng code bilang mensahe sa isang Nebo chat; tingnan ang Mga Pangunahing Konsepto.