NeboAI
NeboAI
Mulakan

Penerbitan

Anda menerbitkan ke pasaran NeboAI melalui pelayan MCP NeboAI. Sambungkan klien MCP, cipta artifak, muat naik failnya dan hantar satu versi untuk semakan. Alat yang sama melayani kemahiran, pekerja, plugin dan aplikasi.

Sambung

Tambah https://neboai.com/mcp ke mana-mana klien MCP yang menyokong pelayan jauh. Klien menemui pelayan kebenaran, mendaftarkan dirinya dan melog masuk anda dengan OAuth dan PKCE. Mana-mana akaun NeboAI boleh menyambung. Token akses bertahan satu jam dan disegarkan selama 30 hari.

Akaun pembangun

Sesiapa sahaja yang mempunyai akaun NeboAI boleh menerbitkan. Menghantar versi dan memuat naik fail menggunakan akaun pembangun anda, yang disediakan untuk anda secara percuma pada kali pertama anda menghantar atau meminta token muat naik. Tiada yuran dan tiada langkah kelulusan.

Untuk menerbitkan bagi pihak pasukan dan bukannya diri sendiri, pilih akaun pasukan itu untuk sesi tersebut. Anda mesti ahli pasukan itu.

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

developer juga boleh menyediakan akaun anda lebih awal (action: "create", pilihan) dan menyenaraikan serta memilih ruang nama (resource: "namespace"). Ruang nama yang dipilih menjadi sebahagian daripada setiap nama layak yang anda terbitkan.

Alat

Alat skill, agent dan plugin berkongsi satu set tindakan. Aplikasi diterbitkan dengan alat agent.

TindakanAkaun pembangunMelakukan
createtidak diperlukanMencipta artifak dan kod pemasangannya.
updatetidak diperlukanMengubah medan, kandungan, versi atau keterlihatan.
get, list, deletetidak diperlukanMembaca atau membuang artifak anda.
installtidak diperlukanMemasang pada salah satu bot anda: id, botId, dan cascade untuk menyertakan kebergantungan.
bundle-tokendisediakan secara automatikToken untuk memuat naik zip fail teks.
binary-tokendisediakan secara automatikToken untuk memuat naik binari, plugin.json, agent.json dan UI aplikasi.
list-binaries, delete-binarydisediakan secara automatikMenguruskan binari yang dimuat naik.
submitdisediakan secara automatikMenghantar versi untuk semakan.
MedanMaksud
nameNama paparan. Slug dibuat daripadanya.
descriptionSatu baris, 10 hingga 500 aksara untuk dihantar.
manifestContentFail utama artifak: SKILL.md, AGENT.md atau PLUGIN.md.
versionVersi semantik. Lalai 0.1.0.
visibilityprivate (lalai), loop (dikongsi dengan Saluran anda) atau public.
categoryKategori pasaran.
longDescriptionTeks “Apa yang dilakukannya” di pasaran (update sahaja).
sourceUrl, manifestUrlPautan pilihan.
dependenciesPekerja sahaja. Lihat Kebergantungan.

Alat marketplace mencari dalam pasaran dan menyenaraikan kategori. Alat pricing menetapkan harga pada artifak; artifak berbayar memerlukan penyelesaian proses permulaan pembayaran.

Terbitkan kemahiran

Cipta kemahiran dengan SKILL.mdnya sebagai kandungan.

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

Namakan kemahiran dengan name dalam frontmatternya. Nama layaknya ialah @<namespace>/skills/<slug>, dengan slug dibuat daripada nama paparan, dan bot menyelesaikan nama layak berdasarkan name dalam frontmatter, jadi kedua-duanya mesti sepadan.

Jika kemahiran mempunyai fail lain, muat naik folder sebagai zip. Satu folder peringkat atas dalam zip dibuang secara automatik, dan folder binaan serta kawalan versi dilangkau.

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
Peraturan himpunanHad
Saiz zip50 MB
Setiap fail10 MB
Semua fail50 MB
Jenis failTeks, kod, data, imej, PDF dan fon, seperti .md, .py, .js, .ts, .json, .yaml, .csv, .html. Apa sahaja di bawah scripts/, bin/ atau dist/ diterima.
LaluanTiada .. dan tiada laluan mutlak.

Jadikan kemahiran itu awam dan hantar satu versi.

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

Terbitkan pekerja

Cipta pekerja dengan AGENT.mdnya sebagai kandungan dan kebergantungan pasarannya.

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

Muat naik agent.json dengan token binari. Pekerja tidak memerlukan binari; config sudah memadai. Untuk menyertakan folder skills/ pekerja itu sendiri, muat naik pakej sebagai himpunan sebaliknya: AGENT.md, agent.json dan skills/ dalam satu 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

Simpan kebergantungan dalam agent.json. agent.json yang dimuat naik menggantikan konfigurasi yang disimpan, termasuk kebergantungan yang ditetapkan dengan create atau update, dan update dengan dependencies menggantikan agent.json yang disimpan. Apabila anda menggunakan kedua-duanya, letakkan objek dependencies yang sama di dalam agent.json.

Kebergantungan

dependencies mempunyai senarai skills, agents dan connectors. Setiap entri ialah {qualifiedName, id, name}; NeboAI menyemak nama berkelayakan dahulu, kemudian id. Plugin disenaraikan di bawah skills. Plugin yang diperlukan oleh kemahiran yang dinamakan dalam agent.json ditambah secara automatik. Apabila pemilik memasang pekerja anda daripada pasaran atau dengan kodnya, bot memasang kebergantungan kemahiran, plugin dan pekerjanya bersama.

Terbitkan plugin atau aplikasi

Plugin memuat naik satu binari bagi setiap platform bersama plugin.json dan kemahiran plugin itu; lihat Menghantar Plugin. Aplikasi halaman sahaja tidak memerlukan binari: muat naik satu himpunan dengan bundle-token yang mengandungi AGENT.md (dengan artifact_type: app), agent.json, manifest.json, ui/ dan sebarang skills/. Aplikasi dengan sidecar menggunakan muat naik binari yang sama dengan alat agent: binari sidecar sebagai file bersama platformnya, dan halaman sebagai ui, iaitu .tar.gz bagi folder ui/. Lihat Aplikasi.

Semakan

submit memerlukan kandungan fail utama dan penerangan 10 hingga 500 aksara. Setiap penghantaran diimbas. Imbasan yang bersih boleh diluluskan secara automatik; apa-apa yang ditanda pergi ke semakan manual. Kelulusan menandatangani sebarang binari dan menjadikan versi itu aktif. Versi yang ditolak kembali kepada draf.

Status artifakMaksud
draftBelum dihantar, atau ditolak.
pending_review, reviewMenunggu semakan.
activeDiluluskan. Disenaraikan di pasaran apabila keterlihatan ialah public.
revokedDitarik balik.

Kod pemasangan

Setiap artifak mendapat kod pemasangannya apabila ia dicipta: SKIL-, AGNT-, PLUG-, APPS-, CONN- atau COLL- diikuti lapan aksara. Menaip kod itu sebagai mesej dalam sembang Nebo memasang artifak tersebut; lihat Konsep Teras.