NeboAI
NeboAI
Commencer

Publication

Vous publiez sur la boutique NeboAI via le serveur MCP de NeboAI. Connectez un client MCP, créez l'élément, téléversez ses fichiers et soumettez une version pour examen. Les mêmes outils servent pour les skills, les employés, les plugins et les applications.

Connexion

Ajoutez https://neboai.com/mcp à n'importe quel client MCP qui prend en charge les serveurs distants. Le client découvre le serveur d'autorisation, s'enregistre et vous connecte avec OAuth et PKCE. N'importe quel compte NeboAI peut se connecter. Les jetons d'accès durent une heure et s'actualisent pendant 30 jours.

Compte développeur

Toute personne disposant d'un compte NeboAI peut publier. La soumission d'une version et le téléversement de fichiers utilisent votre compte développeur, qui est créé pour vous, gratuitement, la première fois que vous soumettez ou demandez un jeton de téléversement. Il n'y a ni frais ni étape d'approbation.

Pour publier au nom d'une équipe plutôt qu'en votre nom, sélectionnez le compte de l'équipe pour la session. Vous devez être membre de l'équipe.

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

developer peut aussi créer votre compte à l'avance (action: "create", facultatif) et liste et sélectionne les espaces de noms (resource: "namespace"). L'espace de noms sélectionné fait partie de chaque nom qualifié que vous publiez.

Outils

Les outils skill, agent et plugin partagent un même ensemble d'actions. Les applications sont publiées avec l'outil agent.

ActionCompte développeurRôle
createnon requisCrée l'élément et son code d'installation.
updatenon requisModifie les champs, le contenu, la version ou la visibilité.
get, list, deletenon requisLit ou supprime vos éléments.
installnon requisInstalle sur l'un de vos bots : id, botId, et cascade pour inclure les dépendances.
bundle-tokencréé automatiquementUn jeton pour téléverser un zip de fichiers texte.
binary-tokencréé automatiquementUn jeton pour téléverser des binaires, plugin.json, agent.json et des interfaces d'application.
list-binaries, delete-binarycréé automatiquementGère les binaires téléversés.
submitcréé automatiquementSoumet une version pour examen.
ChampSignification
nameNom affiché. Le slug en est dérivé.
descriptionUne ligne, de 10 à 500 caractères pour la soumission.
manifestContentLe fichier principal de l'élément : SKILL.md, AGENT.md ou PLUGIN.md.
versionVersion sémantique. Par défaut 0.1.0.
visibilityprivate (par défaut), loop (partagé avec vos Canaux) ou public.
categoryCatégorie de la boutique.
longDescriptionLe texte « Ce qu'il fait » de la boutique (update uniquement).
sourceUrl, manifestUrlLiens facultatifs.
dependenciesEmployés uniquement. Voir Dépendances.

L'outil marketplace recherche dans la boutique et liste les catégories. L'outil pricing fixe un prix pour un élément ; les éléments payants nécessitent de terminer la configuration des versements.

Publier un skill

Créez le skill avec son SKILL.md comme contenu.

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

Nommez le skill avec le champ name de son en-tête. Son nom qualifié est @<namespace>/skills/<slug>, le slug étant dérivé du nom affiché, et les bots résolvent les noms qualifiés à partir du name de l'en-tête : les deux doivent donc correspondre.

Si le skill comporte d'autres fichiers, téléversez le dossier sous forme de zip. Un dossier racine unique dans le zip est retiré automatiquement, et les dossiers de build et de gestion de versions sont ignorés.

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
Règle du bundleLimite
Taille du zip50 MB
Chaque fichier10 MB
Tous les fichiers50 MB
Types de fichiersTexte, code, données, images, PDF et polices, comme .md, .py, .js, .ts, .json, .yaml, .csv, .html. Tout ce qui se trouve sous scripts/, bin/ ou dist/ est accepté.
CheminsPas de .. ni de chemins absolus.

Rendez le skill public et soumettez une version.

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

Publier un employé

Créez l'employé avec son AGENT.md comme contenu et ses dépendances de la boutique.

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

Téléversez agent.json avec un jeton de binaire. Les employés n'ont pas besoin de binaire ; config suffit. Pour inclure le dossier skills/ propre à l'employé, téléversez plutôt le package sous forme de bundle : AGENT.md, agent.json et skills/ dans un seul 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

Gardez les dépendances dans agent.json. Un agent.json téléversé remplace la configuration stockée, y compris les dépendances définies avec create ou update, et un update avec dependencies remplace l’agent.json stocké. Si vous utilisez les deux, placez le même objet dependencies dans agent.json.

Dépendances

dependencies contient les listes skills, agents et connectors. Chaque entrée est de la forme {qualifiedName, id, name} ; NeboAI vérifie d'abord le nom qualifié, puis l'identifiant. Un plugin se déclare sous skills. Les plugins requis par les skills nommées dans agent.json sont ajoutés automatiquement. Quand un propriétaire installe votre employé depuis la boutique ou avec son code, le bot installe avec lui ses dépendances de skills, de plugins et d'employés.

Publier un plugin ou une application

Les plugins téléversent un binaire par plateforme avec le plugin.json et les skills du plugin ; voir Livrer un plugin. Une application composée d'une seule page n'a pas besoin de binaire : téléversez un seul bundle avec bundle-token contenant AGENT.md (avec artifact_type: app), agent.json, manifest.json, ui/ et les éventuels skills/. Une application avec un sidecar utilise le même téléversement de binaire avec l'outil agent : le binaire du sidecar en tant que file avec sa platform, et la page en tant que ui, un .tar.gz du dossier ui/. Voir Applications.

Examen

submit nécessite le contenu du fichier principal et une description de 10 à 500 caractères. Chaque soumission est analysée. Une analyse sans problème peut être approuvée automatiquement ; tout élément signalé passe en examen manuel. L'approbation signe les éventuels binaires et active la version. Une version refusée repasse à l'état de brouillon.

Statut de l'élémentSignification
draftNon soumis, ou refusé.
pending_review, reviewEn attente d'examen.
activeApprouvé. Référencé sur la boutique lorsque la visibilité est public.
revokedRetiré.

Codes d'installation

Chaque élément reçoit son code d'installation dès sa création : SKIL-, AGNT-, PLUG-, APPS-, CONN- ou COLL- suivi de huit caractères. Taper le code comme message dans une discussion Nebo installe l'élément ; voir Concepts clés.