Koble til
Legg til https://neboai.com/mcp i en hvilken som helst MCP-klient som støtter eksterne servere. Klienten oppdager autorisasjonsserveren, registrerer seg selv og logger deg inn med OAuth og PKCE. Alle NeboAI-kontoer kan koble til. Tilgangstokener varer i én time og fornyes i 30 dager.
Utviklerkonto
Alle med en NeboAI-konto kan publisere. Innsending av en versjon og opplasting av filer bruker utviklerkontoen din, som settes opp for deg, gratis, første gang du sender inn eller ber om et opplastingstoken. Det er ingen avgift og ingen godkjenningstrinn.
For å publisere for et team i stedet for deg selv velger du teamets konto for økten. Du må være medlem av teamet.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer kan også sette opp kontoen din på forhånd (action: "create", valgfritt) og lister opp og velger navnerom (resource: "namespace"). Det valgte navnerommet blir en del av hvert kvalifiserte navn du publiserer.
Verktøy
Verktøyene skill, agent og plugin deler ett sett med handlinger. Apper publiseres med verktøyet agent.
| Handling | Utviklerkonto | Gjør |
|---|---|---|
create | ikke nødvendig | Oppretter elementet og installasjonskoden. |
update | ikke nødvendig | Endrer felt, innhold, versjon eller synlighet. |
get, list, delete | ikke nødvendig | Leser eller fjerner elementene dine. |
install | ikke nødvendig | Installerer på en av botene dine: id, botId, og cascade for å ta med avhengigheter. |
bundle-token | settes opp automatisk | Et token for å laste opp en zip med tekstfiler. |
binary-token | settes opp automatisk | Et token for å laste opp binærfiler, plugin.json, agent.json og app-UI-er. |
list-binaries, delete-binary | settes opp automatisk | Administrerer opplastede binærfiler. |
submit | settes opp automatisk | Sender inn en versjon til gjennomgang. |
| Felt | Betydning |
|---|---|
name | Visningsnavn. Sluggen lages ut fra det. |
description | Én linje, 10 til 500 tegn for å sende inn. |
manifestContent | Elementets hovedfil: SKILL.md, AGENT.md eller PLUGIN.md. |
version | Semantisk versjon. Standard 0.1.0. |
visibility | private (standard), loop (delt med kanalene dine) eller public. |
category | Kategori på markedsplassen. |
longDescription | Markedsplassteksten «Hva den gjør» (bare update). |
sourceUrl, manifestUrl | Valgfrie lenker. |
dependencies | Bare ansatte. Se Avhengigheter. |
Verktøyet marketplace søker på markedsplassen og lister opp kategorier. Verktøyet pricing setter en pris på et element; betalte elementer krever at du fullfører oppsettet for utbetalinger.
Publiser en ferdighet
Opprett ferdigheten med SKILL.md som innhold.
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>") Gi ferdigheten navn med name i frontmatter. Det kvalifiserte navnet er @<namespace>/skills/<slug>, der sluggen lages ut fra visningsnavnet, og boter slår opp kvalifiserte navn mot name i frontmatter, så de to må samsvare.
Hvis ferdigheten har andre filer, laster du opp mappen som en zip. En enkelt toppmappe i zip-filen fjernes automatisk, og mapper for bygg og versjonskontroll hoppes 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
| Pakkeregel | Grense |
|---|---|
| Zip-størrelse | 50 MB |
| Hver fil | 10 MB |
| Alle filer | 50 MB |
| Filtyper | Tekst, kode, data, bilder, PDF og skrifter, som .md, .py, .js, .ts, .json, .yaml, .csv, .html. Alt under scripts/, bin/ eller dist/ godtas. |
| Stier | Ingen .. og ingen absolutte stier. |
Gjør ferdigheten offentlig og send inn en versjon.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Publiser en ansatt
Opprett den ansatte med AGENT.md som innhold og avhengighetene fra markedsplassen.
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" } ] }) Last opp agent.json med et binærtoken. Ansatte trenger ingen binærfil; config er nok. For å ta med den ansattes egen skills/-mappe laster du heller opp pakken som en bunt: AGENT.md, agent.json og skills/ i én 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
Hold avhengighetene i agent.json. En opplastet agent.json erstatter den lagrede konfigurasjonen, inkludert avhengigheter satt med create eller update, og en update med dependencies erstatter den lagrede agent.json. Når du bruker begge, legger du det samme dependencies-objektet inn i agent.json.
Avhengigheter
dependencies har listene skills, agents og connectors. Hver oppføring er {qualifiedName, id, name}; NeboAI sjekker det kvalifiserte navnet først, deretter ID-en. Et tillegg føres opp under skills. Tillegg som kreves av ferdigheter nevnt i agent.json, legges til automatisk. Når en eier installerer den ansatte din fra markedsplassen eller med koden, installerer boten avhengighetene for ferdigheter, tillegg og ansatte sammen med den.
Publiser et tillegg eller en app
Tillegg laster opp én binærfil per plattform med tilleggets plugin.json og ferdigheter; se Lansere et tillegg. En app som bare er en side, trenger ingen binærfil: last opp én bunt med bundle-token som inneholder AGENT.md (med artifact_type: app), agent.json, manifest.json, ui/ og eventuelle skills/. En app med en sidecar bruker den samme binæropplastingen med verktøyet agent: sidecar-binærfilen som file med sin platform, og siden som ui, en .tar.gz av ui/-mappen. Se Apper.
Gjennomgang
submit krever innholdet i hovedfilen og en beskrivelse på 10 til 500 tegn. Hver innsending skannes. En ren skanning kan godkjennes automatisk; alt som flagges, går til manuell gjennomgang. Godkjenning signerer eventuelle binærfiler og gjør versjonen aktiv. En avvist versjon går tilbake til utkast.
| Elementstatus | Betydning |
|---|---|
draft | Ikke sendt inn, eller avvist. |
pending_review, review | Venter på gjennomgang. |
active | Godkjent. Listet på markedsplassen når synligheten er public. |
revoked | Trukket tilbake. |
Installasjonskoder
Hvert element får installasjonskoden sin når det opprettes: SKIL-, AGNT-, PLUG-, APPS-, CONN- eller COLL- etterfulgt av åtte tegn. Å skrive koden som en melding i en Nebo-chat installerer elementet; se Kjernebegreper.