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.
| Azione | Account sviluppatore | Cosa fa |
|---|---|---|
create | non necessario | Crea l’elemento e il suo codice di installazione. |
update | non necessario | Modifica campi, contenuto, versione o visibilità. |
get, list, delete | non necessario | Legge o rimuove i tuoi elementi. |
install | non necessario | Installa su uno dei tuoi bot: id, botId e cascade per includere le dipendenze. |
bundle-token | creato automaticamente | Un token per caricare uno zip di file di testo. |
binary-token | creato automaticamente | Un token per caricare binari, plugin.json, agent.json e UI delle app. |
list-binaries, delete-binary | creato automaticamente | Gestisce i binari caricati. |
submit | creato automaticamente | Invia una versione per la revisione. |
| Campo | Significato |
|---|---|
name | Nome visualizzato. Da esso si ricava lo slug. |
description | Una riga, da 10 a 500 caratteri per l’invio. |
manifestContent | Il file principale dell’elemento: SKILL.md, AGENT.md o PLUGIN.md. |
version | Versione semantica. Predefinita 0.1.0. |
visibility | private (predefinito), loop (condiviso con i tuoi Canali) o public. |
category | Categoria del marketplace. |
longDescription | Il testo «Cosa fa» del marketplace (solo update). |
sourceUrl, manifestUrl | Link facoltativi. |
dependencies | Solo 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 bundle | Limite |
|---|---|
| Dimensione dello zip | 50 MB |
| Ogni file | 10 MB |
| Tutti i file | 50 MB |
| Tipi di file | Testo, 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. |
| Percorsi | Niente .. 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’elemento | Significato |
|---|---|
draft | Non inviato, oppure rifiutato. |
pending_review, review | In attesa di revisione. |
active | Approvato. Presente nel marketplace quando la visibilità è public. |
revoked | Ritirato. |
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.