NeboAI
NeboAI
Aloita

Julkaiseminen

Julkaiset NeboAI-kauppaan NeboAI MCP -palvelimen kautta. Yhdistä MCP-asiakas, luo julkaisu, lataa sen tiedostot ja lähetä versio tarkistettavaksi. Samat työkalut palvelevat taitoja, työntekijöitä, laajennuksia ja sovelluksia.

Yhdistä

Lisää https://neboai.com/mcp mihin tahansa MCP-asiakkaaseen, joka tukee etäpalvelimia. Asiakas löytää valtuutuspalvelimen, rekisteröi itsensä ja kirjaa sinut sisään OAuthilla ja PKCE:llä. Mikä tahansa NeboAI-tili voi yhdistää. Käyttötunnukset ovat voimassa tunnin ja päivittyvät 30 päivän ajan.

Kehittäjätili

Kuka tahansa, jolla on NeboAI-tili, voi julkaista. Version lähettäminen ja tiedostojen lataaminen käyttävät kehittäjätiliäsi, joka luodaan sinulle maksutta, kun ensimmäisen kerran lähetät tai pyydät latausmerkkiä. Maksua tai hyväksyntävaihetta ei ole.

Jos haluat julkaista tiimin puolesta itsesi sijaan, valitse tiimin tili istunnolle. Sinun on oltava tiimin jäsen.

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

developer voi myös luoda tilisi etukäteen (action: "create", valinnainen) sekä luetella ja valita nimiavaruuksia (resource: "namespace"). Valitusta nimiavaruudesta tulee osa jokaista julkaisemaasi täydellistä nimeä.

Työkalut

Työkalut skill, agent ja plugin jakavat saman toimintojoukon. Sovellukset julkaistaan agent-työkalulla.

ToimintoKehittäjätiliTekee
createei tarvitaLuo julkaisun ja sen asennuskoodin.
updateei tarvitaMuuttaa kenttiä, sisältöä, versiota tai näkyvyyttä.
get, list, deleteei tarvitaLukee tai poistaa julkaisujasi.
installei tarvitaAsentaa johonkin boteistasi: id, botId ja cascade riippuvuuksien sisällyttämiseksi.
bundle-tokenluodaan automaattisestiMerkki tekstitiedostoja sisältävän zipin lataamiseen.
binary-tokenluodaan automaattisestiMerkki binäärien, plugin.json-, agent.json-tiedostojen ja sovellusten käyttöliittymien lataamiseen.
list-binaries, delete-binaryluodaan automaattisestiHallinnoi ladattuja binäärejä.
submitluodaan automaattisestiLähettää version tarkistettavaksi.
KenttäMerkitys
nameNäyttönimi. Slug muodostetaan siitä.
descriptionYksi rivi, lähetettäessä 10–500 merkkiä.
manifestContentJulkaisun päätiedosto: SKILL.md, AGENT.md tai PLUGIN.md.
versionSemanttinen versio. Oletus 0.1.0.
visibilityprivate (oletus), loop (jaettu kanaviesi kanssa) tai public.
categoryKaupan luokka.
longDescriptionKaupan ”Mitä se tekee” -teksti (vain update).
sourceUrl, manifestUrlValinnaiset linkit.
dependenciesVain työntekijät. Katso Riippuvuudet.

marketplace-työkalu hakee kaupasta ja luettelee luokat. pricing-työkalu asettaa julkaisulle hinnan; maksulliset julkaisut edellyttävät maksujen käyttöönoton suorittamista.

Julkaise taito

Luo taito niin, että sen SKILL.md on sisältönä.

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

Nimeä taito sen etuosan name-kentällä. Sen täydellinen nimi on @<namespace>/skills/<slug>, ja slug muodostetaan näyttönimestä; botit ratkaisevat täydelliset nimet etuosan name-kenttää vasten, joten näiden kahden on vastattava toisiaan.

Jos taidossa on muita tiedostoja, lataa kansio zip-tiedostona. Zipin yksittäinen ylätason kansio poistetaan automaattisesti, ja käännös- ja versionhallintakansiot ohitetaan.

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
NippusääntöRaja
Zipin koko50 MB
Kukin tiedosto10 MB
Kaikki tiedostot50 MB
TiedostotyypitTeksti, koodi, data, kuvat, PDF ja fontit, kuten .md, .py, .js, .ts, .json, .yaml, .csv, .html. Kaikki hakemistoissa scripts/, bin/ tai dist/ hyväksytään.
PolutEi ..-merkintöjä eikä absoluuttisia polkuja.

Tee taidosta julkinen ja lähetä versio.

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

Julkaise työntekijä

Luo työntekijä niin, että sen AGENT.md on sisältönä, ja lisää sen kaupan riippuvuudet.

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

Lataa agent.json binäärimerkillä. Työntekijät eivät tarvitse binääriä; config riittää. Jos haluat sisällyttää työntekijän oman skills/-kansion, lataa paketti sen sijaan nippuna: AGENT.md, agent.json ja skills/ yhdessä zipissä.

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

Pidä riippuvuudet tiedostossa agent.json. Ladattu agent.json korvaa tallennetut määritykset, mukaan lukien kutsuilla create tai update asetetut riippuvuudet, ja update, jossa on dependencies, korvaa tallennetun tiedoston agent.json. Kun käytät molempia, laita sama dependencies-olio tiedoston agent.json sisään.

Riippuvuudet

dependencies sisältää luettelot skills, agents ja connectors. Jokainen merkintä on muotoa {qualifiedName, id, name}; NeboAI tarkistaa ensin täydellisen nimen ja sitten tunnuksen. Laajennus luetellaan kohdassa skills. Tiedostossa agent.json nimettyjen taitojen vaatimat laajennukset lisätään automaattisesti. Kun omistaja asentaa työntekijäsi kaupasta tai sen koodilla, botti asentaa samalla sen taito-, laajennus- ja työntekijäriippuvuudet.

Julkaise laajennus tai sovellus

Laajennukset lataavat yhden binäärin alustaa kohden yhdessä laajennuksen plugin.json-tiedoston ja taitojen kanssa; katso Laajennuksen julkaiseminen. Pelkästä sivusta koostuva sovellus ei tarvitse binääriä: lataa yksi nippu bundle-token-merkillä, ja siinä on AGENT.md (jossa artifact_type: app), agent.json, manifest.json, ui/ ja mahdolliset skills/. Sivuvaunullinen sovellus käyttää samaa binäärilatausta agent-työkalulla: sivuvaunun binääri kenttänä file ja sen platform, ja sivu kenttänä ui, ui/-kansion .tar.gz-arkistona. Katso Sovellukset.

Tarkistus

submit vaatii päätiedoston sisällön ja 10–500 merkin kuvauksen. Jokainen lähetys skannataan. Puhdas skannaus voidaan hyväksyä automaattisesti; kaikki merkitty menee manuaaliseen tarkistukseen. Hyväksyntä allekirjoittaa mahdolliset binäärit ja tekee versiosta aktiivisen. Hylätty versio palaa luonnokseksi.

Julkaisun tilaMerkitys
draftEi lähetetty tai hylätty.
pending_review, reviewOdottaa tarkistusta.
activeHyväksytty. Listattu kauppaan, kun näkyvyys on public.
revokedVedetty pois.

Asennuskoodit

Jokainen julkaisu saa asennuskoodinsa luotaessa: SKIL-, AGNT-, PLUG-, APPS-, CONN- tai COLL- ja sen perässä kahdeksan merkkiä. Koodin kirjoittaminen viestinä Nebo-chatissa asentaa julkaisun; katso Peruskäsitteet.