NeboAI
NeboAI
Kom igång

Publicering

Du publicerar på NeboAI:s marknadsplats via NeboAI:s MCP-server. Anslut en MCP-klient, skapa objektet, ladda upp dess filer och skicka in en version för granskning. Samma verktyg används för färdigheter, medarbetare, plugins och appar.

Anslut

Lägg till https://neboai.com/mcp i valfri MCP-klient som stöder fjärrservrar. Klienten hittar auktoriseringsservern, registrerar sig och loggar in dig med OAuth och PKCE. Alla NeboAI-konton kan ansluta. Åtkomsttoken gäller i en timme och förnyas i 30 dagar.

Utvecklarkonto

Alla med ett NeboAI-konto kan publicera. Att skicka in en version och ladda upp filer använder ditt utvecklarkonto, som skapas åt dig, gratis, första gången du skickar in eller ber om en uppladdningstoken. Det finns ingen avgift och inget godkännandesteg.

För att publicera för ett team i stället för dig själv väljer du teamets konto för sessionen. Du måste vara medlem i teamet.

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

developer kan också skapa ditt konto i förväg (action: "create", valfritt) samt lista och välja namnrymder (resource: "namespace"). Den valda namnrymden blir en del av varje kvalificerat namn som du publicerar.

Verktyg

Verktygen skill, agent och plugin delar samma uppsättning åtgärder. Appar publiceras med verktyget agent.

ÅtgärdUtvecklarkontoGör
createbehövs inteSkapar objektet och dess installationskod.
updatebehövs inteÄndrar fält, innehåll, version eller synlighet.
get, list, deletebehövs inteLäser eller tar bort dina objekt.
installbehövs inteInstallerar på en av dina bottar: id, botId och cascade för att ta med beroenden.
bundle-tokenskapas automatisktEn token för att ladda upp en zip-fil med textfiler.
binary-tokenskapas automatisktEn token för att ladda upp binärfiler, plugin.json, agent.json och appgränssnitt.
list-binaries, delete-binaryskapas automatisktHanterar uppladdade binärfiler.
submitskapas automatisktSkickar in en version för granskning.
FältBetydelse
nameVisningsnamn. Slug skapas utifrån det.
descriptionEn rad, 10 till 500 tecken för att kunna skicka in.
manifestContentObjektets huvudfil: SKILL.md, AGENT.md eller PLUGIN.md.
versionSemantisk version. Standard 0.1.0.
visibilityprivate (standard), loop (delas med dina kanaler) eller public.
categoryKategori på marknadsplatsen.
longDescriptionMarknadsplatsens text för ”Vad den gör” (endast update).
sourceUrl, manifestUrlValfria länkar.
dependenciesEndast medarbetare. Se Beroenden.

Verktyget marketplace söker på marknadsplatsen och listar kategorier. Verktyget pricing sätter ett pris på ett objekt; betalda objekt kräver att du slutför registreringen för utbetalningar.

Publicera en färdighet

Skapa färdigheten med dess SKILL.md som innehåll.

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

Namnge färdigheten med name i dess frontmatter. Dess kvalificerade namn är @<namespace>/skills/<slug>, där slug skapas från visningsnamnet, och bottar slår upp kvalificerade namn mot name i frontmatter, så de två måste stämma överens.

Om färdigheten har andra filer laddar du upp mappen som en zip-fil. En enskild toppmapp i zip-filen tas bort automatiskt, och mappar för byggen och versionshantering hoppas över.

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 för paketetGräns
Zip-storlek50 MB
Varje fil10 MB
Alla filer50 MB
FiltyperText, kod, data, bilder, PDF och typsnitt, till exempel .md, .py, .js, .ts, .json, .yaml, .csv, .html. Allt under scripts/, bin/ eller dist/ accepteras.
SökvägarInga .. och inga absoluta sökvägar.

Gör färdigheten offentlig och skicka in en version.

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

Publicera en medarbetare

Skapa medarbetaren med dess AGENT.md som innehåll och dess beroenden från marknadsplatsen.

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

Ladda upp agent.json med en binärtoken. Medarbetare behöver ingen binärfil; config räcker. För att ta med medarbetarens egen skills/-mapp laddar du i stället upp paketet som ett paket: AGENT.md, agent.json och skills/ i en 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

Håll beroendena i agent.json. En uppladdad agent.json ersätter den sparade konfigurationen, inklusive beroenden som har angetts med create eller update, och en update med dependencies ersätter den sparade agent.json. När du använder båda lägger du samma dependencies-objekt i agent.json.

Beroenden

dependencies har listorna skills, agents och connectors. Varje post är {qualifiedName, id, name}; NeboAI kontrollerar det fullständiga namnet först och sedan id:t. Ett plugin listas under skills. Plugins som krävs av färdigheter som anges i agent.json läggs till automatiskt. När en ägare installerar din medarbetare från marknadsplatsen eller med dess kod installerar boten dess beroenden – färdigheter, plugins och medarbetare – tillsammans med den.

Publicera ett plugin eller en app

Plugins laddar upp en binärfil per plattform med pluginets plugin.json och färdigheter; se Leverera ett plugin. En app som bara består av en sida behöver ingen binärfil: ladda upp ett paket med bundle-token som innehåller AGENT.md (med artifact_type: app), agent.json, manifest.json, ui/ och eventuella skills/. En app med en sidecar använder samma binära uppladdning med verktyget agent: sidecar-binärfilen som file med sin platform, och sidan som ui, en .tar.gz av ui/-mappen. Se Appar.

Granskning

submit kräver huvudfilens innehåll och en beskrivning på 10 till 500 tecken. Varje inskickning skannas. En ren skanning kan godkännas automatiskt; allt som flaggas går till manuell granskning. Ett godkännande signerar eventuella binärfiler och gör versionen aktiv. En avvisad version går tillbaka till utkast.

Objektets statusBetydelse
draftInte inskickad, eller avvisad.
pending_review, reviewVäntar på granskning.
activeGodkänd. Listas på marknadsplatsen när synligheten är public.
revokedTillbakadragen.

Installationskoder

Varje objekt får sin installationskod när det skapas: SKIL-, AGNT-, PLUG-, APPS-, CONN- eller COLL- följt av åtta tecken. Om du skriver koden som ett meddelande i en Nebo-chatt installeras objektet; se Grundbegrepp.