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.
| Handling | Udviklerkonto | Gør |
|---|---|---|
create | ikke nødvendig | Opretter elementet og dets installationskode. |
update | ikke nødvendig | Ændrer felter, indhold, version eller synlighed. |
get, list, delete | ikke nødvendig | Læser eller fjerner dine elementer. |
install | ikke nødvendig | Installerer på en af dine bots: id, botId og cascade for at medtage afhængigheder. |
bundle-token | oprettes automatisk | Et token til at uploade en zip-fil med tekstfiler. |
binary-token | oprettes automatisk | Et token til at uploade binære filer, plugin.json, agent.json og appgrænseflader. |
list-binaries, delete-binary | oprettes automatisk | Administrerer uploadede binære filer. |
submit | oprettes automatisk | Indsender en version til gennemgang. |
| Felt | Betydning |
|---|---|
name | Visningsnavn. Slug'en dannes ud fra det. |
description | Én linje, 10 til 500 tegn for at indsende. |
manifestContent | Elementets hovedfil: SKILL.md, AGENT.md eller PLUGIN.md. |
version | Semantisk version. Standard 0.1.0. |
visibility | private (standard), loop (delt med dine kanaler) eller public. |
category | Kategori på markedspladsen. |
longDescription | Markedspladsens tekst “Hvad den gør” (kun update). |
sourceUrl, manifestUrl | Valgfrie links. |
dependencies | Kun 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 pakken | Grænse |
|---|---|
| Zip-størrelse | 50 MB |
| Hver fil | 10 MB |
| Alle filer | 50 MB |
| Filtyper | Tekst, kode, data, billeder, PDF og skrifttyper, f.eks. .md, .py, .js, .ts, .json, .yaml, .csv, .html. Alt under scripts/, bin/ eller dist/ accepteres. |
| Stier | Ingen .. 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 status | Betydning |
|---|---|
draft | Ikke indsendt, eller afvist. |
pending_review, review | Venter på gennemgang. |
active | Godkendt. Listet på markedspladsen, når synligheden er public. |
revoked | Trukket 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.