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.
| Toiminto | Kehittäjätili | Tekee |
|---|---|---|
create | ei tarvita | Luo julkaisun ja sen asennuskoodin. |
update | ei tarvita | Muuttaa kenttiä, sisältöä, versiota tai näkyvyyttä. |
get, list, delete | ei tarvita | Lukee tai poistaa julkaisujasi. |
install | ei tarvita | Asentaa johonkin boteistasi: id, botId ja cascade riippuvuuksien sisällyttämiseksi. |
bundle-token | luodaan automaattisesti | Merkki tekstitiedostoja sisältävän zipin lataamiseen. |
binary-token | luodaan automaattisesti | Merkki binäärien, plugin.json-, agent.json-tiedostojen ja sovellusten käyttöliittymien lataamiseen. |
list-binaries, delete-binary | luodaan automaattisesti | Hallinnoi ladattuja binäärejä. |
submit | luodaan automaattisesti | Lähettää version tarkistettavaksi. |
| Kenttä | Merkitys |
|---|---|
name | Näyttönimi. Slug muodostetaan siitä. |
description | Yksi rivi, lähetettäessä 10–500 merkkiä. |
manifestContent | Julkaisun päätiedosto: SKILL.md, AGENT.md tai PLUGIN.md. |
version | Semanttinen versio. Oletus 0.1.0. |
visibility | private (oletus), loop (jaettu kanaviesi kanssa) tai public. |
category | Kaupan luokka. |
longDescription | Kaupan ”Mitä se tekee” -teksti (vain update). |
sourceUrl, manifestUrl | Valinnaiset linkit. |
dependencies | Vain 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 koko | 50 MB |
| Kukin tiedosto | 10 MB |
| Kaikki tiedostot | 50 MB |
| Tiedostotyypit | Teksti, koodi, data, kuvat, PDF ja fontit, kuten .md, .py, .js, .ts, .json, .yaml, .csv, .html. Kaikki hakemistoissa scripts/, bin/ tai dist/ hyväksytään. |
| Polut | Ei ..-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 tila | Merkitys |
|---|---|
draft | Ei lähetetty tai hylätty. |
pending_review, review | Odottaa tarkistusta. |
active | Hyväksytty. Listattu kauppaan, kun näkyvyys on public. |
revoked | Vedetty 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.