Conectare
Adaugă https://neboai.com/mcp în orice client MCP care acceptă servere la distanță. Clientul descoperă serverul de autorizare, se înregistrează și te autentifică cu OAuth și PKCE. Se poate conecta orice cont NeboAI. Tokenurile de acces durează o oră și se reîmprospătează timp de 30 de zile.
Cont de dezvoltator
Oricine are un cont NeboAI poate publica. Trimiterea unei versiuni și încărcarea fișierelor folosesc contul tău de dezvoltator, care e configurat pentru tine, gratuit, prima dată când trimiți ceva sau ceri un token de încărcare. Nu există nicio taxă și nicio etapă de aprobare.
Ca să publici pentru o echipă în loc de tine, selectează contul echipei pentru sesiune. Trebuie să fii membru al echipei.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer îți poate și configura contul din timp (action: "create", opțional) și listează și selectează spații de nume (resource: "namespace"). Spațiul de nume selectat devine parte din fiecare nume calificat pe care îl publici.
Instrumente
Instrumentele skill, agent și plugin au în comun același set de acțiuni. Aplicațiile se publică cu instrumentul agent.
| Acțiune | Cont de dezvoltator | Ce face |
|---|---|---|
create | nu e necesar | Creează artefactul și codul lui de instalare. |
update | nu e necesar | Modifică câmpuri, conținutul, versiunea sau vizibilitatea. |
get, list, delete | nu e necesar | Citește sau elimină artefactele tale. |
install | nu e necesar | Instalează pe unul dintre boții tăi: id, botId și cascade pentru a include dependențele. |
bundle-token | configurat automat | Un token pentru încărcarea unei arhive zip cu fișiere text. |
binary-token | configurat automat | Un token pentru încărcarea binarelor, a plugin.json, agent.json și a interfețelor aplicațiilor. |
list-binaries, delete-binary | configurat automat | Gestionează binarele încărcate. |
submit | configurat automat | Trimite o versiune la verificare. |
| Câmp | Semnificație |
|---|---|
name | Numele afișat. Slugul e generat din el. |
description | Un rând, între 10 și 500 de caractere pentru trimitere. |
manifestContent | Fișierul principal al artefactului: SKILL.md, AGENT.md sau PLUGIN.md. |
version | Versiune semantică. Implicit 0.1.0. |
visibility | private (implicit), loop (partajat cu Canalele tale) sau public. |
category | Categoria din magazin. |
longDescription | Textul „Ce face” din magazin (doar update). |
sourceUrl, manifestUrl | Linkuri opționale. |
dependencies | Doar pentru angajați. Vezi Dependențe. |
Instrumentul marketplace caută în magazin și listează categoriile. Instrumentul pricing setează un preț pentru un artefact; artefactele plătite necesită finalizarea configurării plăților.
Publică o abilitate
Creează abilitatea cu SKILL.md ca și conținut.
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>") Numește abilitatea cu name din frontmatter. Numele ei calificat este @<namespace>/skills/<slug>, cu slugul generat din numele afișat, iar boții rezolvă numele calificate pe baza name din frontmatter, așa că cele două trebuie să corespundă.
Dacă abilitatea are și alte fișiere, încarcă folderul ca arhivă zip. Un singur folder de nivel superior din arhivă e eliminat automat, iar folderele de build și de control al versiunilor sunt omise.
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
| Regula pachetului | Limită |
|---|---|
| Dimensiunea arhivei zip | 50 MB |
| Fiecare fișier | 10 MB |
| Toate fișierele | 50 MB |
| Tipuri de fișiere | Text, cod, date, imagini, PDF și fonturi, de exemplu .md, .py, .js, .ts, .json, .yaml, .csv, .html. Orice se află în scripts/, bin/ sau dist/ e acceptat. |
| Căi | Fără .. și fără căi absolute. |
Fă abilitatea publică și trimite o versiune.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Publică un angajat
Creează angajatul cu AGENT.md ca și conținut și cu dependențele lui din magazin.
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" } ] }) Încarcă agent.json cu un token pentru binare. Angajații nu au nevoie de binar; config e suficient. Ca să incluzi folderul skills/ al angajatului, încarcă în schimb pachetul ca bundle: AGENT.md, agent.json și skills/ într-o singură arhivă 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
Păstrează dependențele în agent.json. Un agent.json încărcat înlocuiește configurația stocată, inclusiv dependențele setate cu create sau update, iar un update cu dependencies înlocuiește agent.json stocat. Când le folosești pe amândouă, pune același obiect dependencies în agent.json.
Dependențe
dependencies conține listele skills, agents și connectors. Fiecare intrare este {qualifiedName, id, name}; NeboAI verifică mai întâi numele calificat, apoi ID-ul. Un plugin se trece la skills. Pluginurile cerute de abilitățile menționate în agent.json sunt adăugate automat. Când un proprietar îți instalează angajatul din marketplace sau cu codul lui, botul instalează odată cu el și dependențele lui de abilități, pluginuri și angajați.
Publică un plugin sau o aplicație
Pluginurile încarcă câte un binar pentru fiecare platformă, împreună cu plugin.json și abilitățile pluginului; vezi Lansarea unui plugin. O aplicație care are doar pagină nu are nevoie de binar: încarcă un singur bundle cu bundle-token, care să conțină AGENT.md (cu artifact_type: app), agent.json, manifest.json, ui/ și eventualul skills/. O aplicație cu sidecar folosește aceeași încărcare de binare cu instrumentul agent: binarul sidecarului ca file, cu platform lui, iar pagina ca ui, o arhivă .tar.gz a folderului ui/. Vezi Aplicații.
Verificare
submit are nevoie de conținutul fișierului principal și de o descriere de 10 până la 500 de caractere. Fiecare trimitere e scanată. O scanare curată poate fi aprobată automat; orice e semnalat ajunge la verificare manuală. Aprobarea semnează eventualele binare și activează versiunea. O versiune respinsă revine la stadiul de ciornă.
| Starea artefactului | Semnificație |
|---|---|
draft | Netrimis sau respins. |
pending_review, review | În așteptarea verificării. |
active | Aprobat. Listat în magazin când vizibilitatea e public. |
revoked | Retras. |
Coduri de instalare
Fiecare artefact își primește codul de instalare când e creat: SKIL-, AGNT-, PLUG-, APPS-, CONN- sau COLL-, urmat de opt caractere. Dacă scrii codul ca mesaj într-un chat Nebo, artefactul se instalează; vezi Concepte de bază.