Hubungkan
Tambahkan https://neboai.com/mcp ke klien MCP apa pun yang mendukung server jarak jauh. Klien akan menemukan server otorisasi, mendaftarkan dirinya, dan memasukkan Anda dengan OAuth dan PKCE. Akun NeboAI apa pun dapat terhubung. Token akses berlaku satu jam dan diperbarui selama 30 hari.
Akun developer
Siapa pun yang memiliki akun NeboAI dapat memublikasikan. Mengirimkan versi dan mengunggah file menggunakan akun developer Anda, yang disiapkan untuk Anda secara gratis saat pertama kali Anda mengirimkan atau meminta token unggah. Tidak ada biaya dan tidak ada langkah persetujuan.
Untuk memublikasikan atas nama tim, bukan diri Anda sendiri, pilih akun tim untuk sesi tersebut. Anda harus menjadi anggota tim itu.
developer(resource: "account", action: "list") developer(resource: "account", action: "select", slug: "example-team")
developer juga dapat menyiapkan akun Anda lebih awal (action: "create", opsional) serta menampilkan dan memilih namespace (resource: "namespace"). Namespace yang dipilih menjadi bagian dari setiap nama lengkap yang Anda publikasikan.
Alat
Alat skill, agent, dan plugin berbagi satu kumpulan action. Aplikasi dipublikasikan dengan alat agent.
| Action | Akun developer | Fungsi |
|---|---|---|
create | tidak diperlukan | Membuat artefak dan kode pemasangannya. |
update | tidak diperlukan | Mengubah field, konten, versi, atau visibilitas. |
get, list, delete | tidak diperlukan | Membaca atau menghapus artefak Anda. |
install | tidak diperlukan | Memasang di salah satu bot Anda: id, botId, dan cascade untuk menyertakan dependensi. |
bundle-token | disiapkan otomatis | Token untuk mengunggah zip berisi file teks. |
binary-token | disiapkan otomatis | Token untuk mengunggah biner, plugin.json, agent.json, dan UI aplikasi. |
list-binaries, delete-binary | disiapkan otomatis | Mengelola biner yang diunggah. |
submit | disiapkan otomatis | Mengirimkan versi untuk ditinjau. |
| Field | Arti |
|---|---|
name | Nama tampilan. Slug dibuat darinya. |
description | Satu baris, 10 hingga 500 karakter untuk dikirimkan. |
manifestContent | File utama artefak: SKILL.md, AGENT.md, atau PLUGIN.md. |
version | Versi semantik. Default 0.1.0. |
visibility | private (default), loop (dibagikan ke Kanal Anda), atau public. |
category | Kategori marketplace. |
longDescription | Teks “Apa fungsinya” di marketplace (hanya update). |
sourceUrl, manifestUrl | Tautan opsional. |
dependencies | Hanya karyawan. Lihat Dependensi. |
Alat marketplace mencari di marketplace dan menampilkan kategori. Alat pricing menetapkan harga pada artefak; artefak berbayar memerlukan penyelesaian onboarding pencairan dana.
Publikasikan skill
Buat skill dengan SKILL.md-nya sebagai konten.
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>") Beri nama skill dengan name di frontmatter-nya. Nama lengkapnya adalah @<namespace>/skills/<slug>, dengan slug yang dibuat dari nama tampilan, dan bot mencocokkan nama lengkap dengan name di frontmatter, jadi keduanya harus sama.
Jika skill memiliki file lain, unggah folder tersebut sebagai zip. Satu folder tingkat teratas di dalam zip dihapus secara otomatis, dan folder build serta version control dilewati.
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
| Aturan bundel | Batas |
|---|---|
| Ukuran zip | 50 MB |
| Setiap file | 10 MB |
| Semua file | 50 MB |
| Tipe file | Teks, kode, data, gambar, PDF, dan font, seperti .md, .py, .js, .ts, .json, .yaml, .csv, .html. Apa pun di bawah scripts/, bin/, atau dist/ diterima. |
| Path | Tanpa .. dan tanpa path absolut. |
Jadikan skill publik dan kirimkan sebuah versi.
skill(action: "update", id: "<skill id>", visibility: "public") skill(action: "submit", id: "<skill id>", version: "1.0.0")
Publikasikan karyawan
Buat karyawan dengan AGENT.md-nya sebagai konten beserta dependensi marketplace-nya.
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" } ] }) Unggah agent.json dengan token biner. Karyawan tidak memerlukan biner; config sudah cukup. Untuk menyertakan folder skills/ milik karyawan, unggah paketnya sebagai bundel: 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 dependensi di agent.json. agent.json yang diunggah menggantikan konfigurasi yang tersimpan, termasuk dependensi yang diatur dengan create atau update, dan update dengan dependencies menggantikan agent.json yang tersimpan. Jika Anda menggunakan keduanya, letakkan objek dependencies yang sama di dalam agent.json.
Dependensi
dependencies memiliki daftar skills, agents, dan connectors. Setiap entri berbentuk {qualifiedName, id, name}; NeboAI memeriksa nama lengkap terlebih dahulu, lalu id-nya. Plugin dicantumkan di bawah skills. Plugin yang dibutuhkan oleh skill yang disebut di agent.json ditambahkan secara otomatis. Saat pemilik menginstal karyawan Anda dari marketplace atau dengan kodenya, bot menginstal dependensi skill, plugin, dan karyawannya sekaligus.
Publikasikan plugin atau aplikasi
Plugin mengunggah satu biner per platform beserta plugin.json dan skill plugin tersebut; lihat Merilis Plugin. Aplikasi yang hanya berupa halaman tidak memerlukan biner: unggah satu bundel dengan bundle-token yang berisi AGENT.md (dengan artifact_type: app), agent.json, manifest.json, ui/, dan skills/ apa pun. Aplikasi dengan sidecar menggunakan unggahan biner yang sama dengan alat agent: biner sidecar sebagai file dengan platform-nya, dan halaman sebagai ui, berupa .tar.gz dari folder ui/. Lihat Aplikasi.
Peninjauan
submit memerlukan konten file utama dan deskripsi sepanjang 10 hingga 500 karakter. Setiap pengiriman dipindai. Hasil pindaian yang bersih dapat disetujui secara otomatis; apa pun yang ditandai akan ditinjau manual. Persetujuan menandatangani biner apa pun dan mengaktifkan versi tersebut. Versi yang ditolak kembali menjadi draf.
| Status artefak | Arti |
|---|---|
draft | Belum dikirim, atau ditolak. |
pending_review, review | Menunggu peninjauan. |
active | Disetujui. Dicantumkan di marketplace jika visibilitasnya public. |
revoked | Ditarik. |
Kode pemasangan
Setiap artefak mendapat kode pemasangannya saat dibuat: SKIL-, AGNT-, PLUG-, APPS-, CONN-, atau COLL- diikuti delapan karakter. Mengetik kode itu sebagai pesan di obrolan Nebo akan memasang artefaknya; lihat Konsep Inti.