NeboAI
NeboAI
Inizia

Pubblicazione

Pubblichi nel marketplace di NeboAI tramite il server MCP di NeboAI. Collega un client MCP, crea l’elemento, carica i suoi file e invia una versione per la revisione. Gli stessi strumenti servono per skill, dipendenti, plugin e app.

Connessione

Aggiungi https://neboai.com/mcp a qualsiasi client MCP che supporta i server remoti. Il client individua il server di autorizzazione, si registra e ti fa accedere con OAuth e PKCE. Qualsiasi account NeboAI può collegarsi. I token di accesso durano un’ora e si rinnovano per 30 giorni.

Account sviluppatore

Chiunque abbia un account NeboAI può pubblicare. L’invio di una versione e il caricamento dei file usano il tuo account sviluppatore, che viene creato per te, gratis, la prima volta che invii o chiedi un token di caricamento. Non ci sono costi né passaggi di approvazione.

Per pubblicare per un team invece che per te, seleziona l’account del team per la sessione. Devi essere membro del team.

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

developer può anche configurare il tuo account in anticipo (action: "create", facoltativo) ed elencare e selezionare gli spazi dei nomi (resource: "namespace"). Lo spazio dei nomi selezionato diventa parte di ogni nome qualificato che pubblichi.

Strumenti

Gli strumenti skill, agent e plugin condividono lo stesso insieme di azioni. Le app si pubblicano con lo strumento agent.

AzioneAccount sviluppatoreCosa fa
createnon necessarioCrea l’elemento e il suo codice di installazione.
updatenon necessarioModifica campi, contenuto, versione o visibilità.
get, list, deletenon necessarioLegge o rimuove i tuoi elementi.
installnon necessarioInstalla su uno dei tuoi bot: id, botId e cascade per includere le dipendenze.
bundle-tokencreato automaticamenteUn token per caricare uno zip di file di testo.
binary-tokencreato automaticamenteUn token per caricare binari, plugin.json, agent.json e UI delle app.
list-binaries, delete-binarycreato automaticamenteGestisce i binari caricati.
submitcreato automaticamenteInvia una versione per la revisione.
CampoSignificato
nameNome visualizzato. Da esso si ricava lo slug.
descriptionUna riga, da 10 a 500 caratteri per l’invio.
manifestContentIl file principale dell’elemento: SKILL.md, AGENT.md o PLUGIN.md.
versionVersione semantica. Predefinita 0.1.0.
visibilityprivate (predefinito), loop (condiviso con i tuoi Canali) o public.
categoryCategoria del marketplace.
longDescriptionIl testo «Cosa fa» del marketplace (solo update).
sourceUrl, manifestUrlLink facoltativi.
dependenciesSolo dipendenti. Vedi Dipendenze.

Lo strumento marketplace cerca nel marketplace ed elenca le categorie. Lo strumento pricing imposta un prezzo su un elemento; gli elementi a pagamento richiedono di completare la configurazione dei pagamenti.

Pubblica una skill

Crea la skill con il suo SKILL.md come contenuto.

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

Dai un nome alla skill con il name del suo frontmatter. Il suo nome qualificato è @<namespace>/skills/<slug>, con lo slug ricavato dal nome visualizzato, e i bot risolvono i nomi qualificati confrontandoli con il name del frontmatter, quindi i due devono coincidere.

Se la skill ha altri file, carica la cartella come zip. Un’unica cartella principale nello zip viene rimossa in automatico, e le cartelle di build e di controllo versione vengono saltate.

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
Regola del bundleLimite
Dimensione dello zip50 MB
Ogni file10 MB
Tutti i file50 MB
Tipi di fileTesto, codice, dati, immagini, PDF e font, come .md, .py, .js, .ts, .json, .yaml, .csv, .html. Tutto ciò che si trova sotto scripts/, bin/ o dist/ è accettato.
PercorsiNiente .. e niente percorsi assoluti.

Rendi pubblica la skill e invia una versione.

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

Pubblica un dipendente

Crea il dipendente con il suo AGENT.md come contenuto e le sue dipendenze del marketplace.

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

Carica agent.json con un token per binari. I dipendenti non hanno bisogno di un binario; basta config. Per includere la cartella skills/ del dipendente, carica invece il pacchetto come bundle: AGENT.md, agent.json e skills/ in un unico 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

Tieni le dipendenze in agent.json. Un agent.json caricato sostituisce la configurazione salvata, comprese le dipendenze impostate con create o update, e un update con dependencies sostituisce l’agent.json salvato. Se usi entrambi, metti lo stesso oggetto dependencies dentro agent.json.

Dipendenze

dependencies contiene gli elenchi skills, agents e connectors. Ogni voce è {qualifiedName, id, name}; NeboAI controlla prima il nome qualificato, poi l’id. Un plugin va elencato sotto skills. I plugin richiesti dalle skill indicate in agent.json vengono aggiunti automaticamente. Quando un proprietario installa il tuo dipendente dal marketplace o con il suo codice, il bot installa insieme a esso le dipendenze di skill, plugin e dipendenti.

Pubblica un plugin o un’app

I plugin caricano un binario per piattaforma con il plugin.json e le skill del plugin; vedi Distribuire un plugin. Un’app composta solo da una pagina non ha bisogno di un binario: carica un unico bundle con bundle-token contenente AGENT.md (con artifact_type: app), agent.json, manifest.json, ui/ ed eventuali skills/. Un’app con un sidecar usa lo stesso caricamento dei binari con lo strumento agent: il binario del sidecar come file con la sua platform, e la pagina come ui, un .tar.gz della cartella ui/. Vedi App.

Revisione

submit richiede il contenuto del file principale e una descrizione da 10 a 500 caratteri. Ogni invio viene analizzato. Un’analisi pulita può essere approvata in automatico; tutto ciò che viene segnalato passa alla revisione manuale. L’approvazione firma gli eventuali binari e rende attiva la versione. Una versione rifiutata torna in bozza.

Stato dell’elementoSignificato
draftNon inviato, oppure rifiutato.
pending_review, reviewIn attesa di revisione.
activeApprovato. Presente nel marketplace quando la visibilità è public.
revokedRitirato.

Codici di installazione

Ogni elemento riceve il suo codice di installazione quando viene creato: SKIL-, AGNT-, PLUG-, APPS-, CONN- o COLL- seguito da otto caratteri. Scrivere il codice come messaggio in una chat di Nebo installa l’elemento; vedi Concetti di base.