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ärd | Utvecklarkonto | Gör |
|---|---|---|
create | behövs inte | Skapar objektet och dess installationskod. |
update | behövs inte | Ändrar fält, innehåll, version eller synlighet. |
get, list, delete | behövs inte | Läser eller tar bort dina objekt. |
install | behövs inte | Installerar på en av dina bottar: id, botId och cascade för att ta med beroenden. |
bundle-token | skapas automatiskt | En token för att ladda upp en zip-fil med textfiler. |
binary-token | skapas automatiskt | En token för att ladda upp binärfiler, plugin.json, agent.json och appgränssnitt. |
list-binaries, delete-binary | skapas automatiskt | Hanterar uppladdade binärfiler. |
submit | skapas automatiskt | Skickar in en version för granskning. |
| Fält | Betydelse |
|---|---|
name | Visningsnamn. Slug skapas utifrån det. |
description | En rad, 10 till 500 tecken för att kunna skicka in. |
manifestContent | Objektets huvudfil: SKILL.md, AGENT.md eller PLUGIN.md. |
version | Semantisk version. Standard 0.1.0. |
visibility | private (standard), loop (delas med dina kanaler) eller public. |
category | Kategori på marknadsplatsen. |
longDescription | Marknadsplatsens text för ”Vad den gör” (endast update). |
sourceUrl, manifestUrl | Valfria länkar. |
dependencies | Endast 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 paketet | Gräns |
|---|---|
| Zip-storlek | 50 MB |
| Varje fil | 10 MB |
| Alla filer | 50 MB |
| Filtyper | Text, 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ägar | Inga .. 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 status | Betydelse |
|---|---|
draft | Inte inskickad, eller avvisad. |
pending_review, review | Väntar på granskning. |
active | Godkänd. Listas på marknadsplatsen när synligheten är public. |
revoked | Tillbakadragen. |
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.