Paketnya
Aplikasi adalah paket karyawan dengan manifest.json yang menandainya sebagai aplikasi dan folder ui/ berisi halamannya.
<data>/user/agents/deal-board/
├── manifest.json # marks the employee as an app
├── AGENT.md # the employee behind the page
├── agent.json # optional: sidecar tools, workflows
└── ui/
├── index.html
└── app.js {
"id": "<minted UUID>",
"name": "deal-board",
"version": "1.0.0",
"type": "app",
"window": { "title": "Deal Board", "width": 900, "height": 700, "resizable": true },
"permissions": ["storage:readwrite"]
} | Field | Arti |
|---|---|
type | "app". Menjadikan karyawan sebuah aplikasi. Nebo juga membaca artifact_type versi lama. |
id | UUID yang dibuat saat aplikasi dibuat. Halaman disajikan di /apps/<id>/ui/. |
name, version | Nama karyawan dan versi paket. |
window | title, width, height, resizable, fullscreen, orientation. Default: 1024 × 768, dapat diubah ukurannya, tidak layar penuh, potret, berjudul sesuai nama karyawan. |
permissions | Apa yang boleh dilakukan halaman. Default ["storage:readwrite"]. |
Izin
| Izin | Memberikan |
|---|---|
storage:readwrite | Penyimpanan key-value aplikasi. |
subagent:<employee-id> | Bertanya kepada karyawan lain dari halaman. Karyawan aplikasi itu sendiri tidak memerlukan izin. |
network:<host> atau network:* | Permintaan ke host luar melalui proxy Nebo. |
device:motion | Giroskop dan akselerometer hanya untuk halaman ini. Di iPhone, halaman juga memanggil DeviceMotionEvent.requestPermission() dari sebuah ketukan. |
Setiap izin berbentuk prefix:scope. Minta seminimal yang dibutuhkan aplikasi.
Layar penuh, orientasi, dan kemiringan
Game dan film dapat menggunakan seluruh layar. Atur fullscreen dan, untuk aplikasi seluler, orientation: portrait (default), landscape, atau any. Orientasi lain ditolak saat manifes ditulis.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Di desktop, aplikasi terbuka di jendela layar penuh.
- Di aplikasi seluler tidak ada bilah aplikasi, bilah sistem disembunyikan, layar tetap menyala, dan tarik untuk menyegarkan dinonaktifkan. Tombol Tutup kecil berada di sudut kiri atas dan memudar setelah beberapa detik; sentuhan di dekat bagian atas memunculkannya kembali. Usap tepi iOS dinonaktifkan, dan tombol kembali Android menelusuri riwayat halaman sebelum menutup.
- Beri padding pada halaman dengan
env(safe-area-inset-*)danviewport-fit=cover, dan jauhkan kontrol dari sudut kiri atas.
Kontrol suara
Setiap aplikasi yang dibuka di aplikasi desktop Nebo atau di aplikasi seluler menampilkan kontrol suara kecil di sudut kanan bawahnya, sehingga pemilik dapat berbicara dengan karyawan aplikasi selama karyawan itu bekerja di halaman. Kontrol ini berada di luar halaman Anda, jadi memuat ulang halaman tidak pernah memutus panggilan.
- Di desktop, kontrol ini berupa bilah berukuran sekitar 300 kali 48 piksel, 16 piksel dari sudut kanan bawah jendela.
- Di aplikasi seluler, kontrol ini berupa tombol bulat 48 poin di dalam area aman yang dapat diseret pemilik ke kedua sisi. Di aplikasi layar penuh, kontrol ini kembali menjadi tombol itu beberapa detik setelah panggilan dimulai.
- Jauhkan kontrol penting dari sudut kanan bawah.
- Selama tugas panjang dalam panggilan, karyawan menyampaikan kabar singkat seperti “Sedang mengedit.” dan tidak pernah membacakan nama file atau perintah.
Buat aplikasi
Karyawan dapat membangun aplikasi dengan dua cara, dan memilih berdasarkan apa yang dikatakan pemilik. “Buatkan aplikasi untuk pesanan saya” membuat karyawan aplikasi baru. “Kamu adalah aplikasinya” atau “buat dirimu menjadi game” mengubah karyawan yang sedang diajak bicara pemilik menjadi aplikasi: obrolan, memori, dan personanya tetap ada, dan halamannya dimuat ulang selama pemilik berbicara dengannya. Ini juga berlaku untuk karyawan yang direkrut dalam percakapan. Jika tidak jelas mana yang dimaksud pemilik, karyawan bertanya sekali.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Alat sehari-hari (pelacak, formulir, dasbor kecil) dibangun dengan skill aplikasi bawaan Nebo. Halaman yang seharusnya terlihat didesain, bukan dihasilkan otomatis, seperti landing page sinematik, film berbasis scroll, seni generatif, atau game, dibangun dengan skill App Studio dari marketplace.
Untuk aplikasi baru, cara paling sederhana adalah meminta karyawan. Nebo menyertakan skill bawaan untuk membangun aplikasi, dan karyawan menggunakan create_employee, yang menulis folder, manifes, persona, dan halaman dalam satu panggilan. Aplikasi muncul di tenaga kerja pemilik dalam hitungan detik.
create_employee(
name: "deal-board",
description: "A board of open deals, sorted by close date.",
app: {
window: { title: "Deal Board", width: 900, height: 700, resizable: true },
permissions: ["storage:readwrite"]
},
ui: { "index.html": "<!doctype html>..." }
) update_employee menerima argumen ui, app, dan agent_md yang sama. Sebuah path di ui menggantikan satu file itu. Halaman dibaca dari disk pada setiap permintaan, jadi memuat ulang jendela akan menampilkan perubahannya.
Halaman minimal
Halaman ini memuat SDK, menanyakan siapa karyawannya, dan mencetak jawabannya. Jika halaman menampilkan id dan nama karyawan, sambungannya sudah benar.
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>Deal Board</title>
</head>
<body>
<h1>Deal Board</h1>
<pre id="who">loading...</pre>
<script src="/sdk/nebo.global.js"></script>
<script>
NeboAppSDK.nebo.identity.get()
.then(me => { document.getElementById('who').textContent = JSON.stringify(me, null, 2); })
.catch(err => { document.getElementById('who').textContent = String(err); });
</script>
</body>
</html> SDK menemukan id aplikasi dari alamat halaman. Halaman yang disajikan dari tempat lain memerlukan <meta name="nebo-app-id" content="<id>">. Simpan state di storage aplikasi, bukan di halaman: jendela bisa tertutup, tetapi storage tetap ada.
Cara halaman disajikan
- Nebo menyajikan
ui/di/apps/<id>/ui/dan membukanya di jendelanya sendiri. - Path tanpa file yang cocok akan kembali ke
index.html, sehingga routing sisi klien berfungsi. - Halaman HTML mendapat meta tag
nebo-app-iddannebo-base-url. - Setiap file dikirim dengan content type aslinya, termasuk video, suara, font,
wasm, dan model 3D (glb,gltf). File dengan ekstensi yang tidak dikenal dikirim sebagaiapplication/octet-streamdan browser tidak akan menggunakannya. - File mendukung permintaan rentang (
206, atau416untuk rentang yang melewati akhir), sehingga video dan suara bisa dilompati ke bagian mana pun. Di aplikasi seluler, video langsung diputar di tempat tanpa perlu diketuk:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - File yang namanya memuat hash konten, seperti
main-0a8ksftt.js, di-cache selama setahun. Semua file lain, termasukindex.html, diperiksa setiap kali dibuka dan menjawab304jika tidak berubah. Lakukan build dengan nama ber-hash, bukan mengganti nama file secara manual. - Setiap file halaman paling besar 10 MB.
- Menghapus folder akan menonaktifkan karyawan;
delete_employeemenghapusnya sepenuhnya.
Tambahkan sidecar
Saat halaman membutuhkan logika server, datanya sendiri, atau alat yang dapat dipanggil karyawan, tambahkan sidecar: biner yang dijalankan Nebo di samping aplikasi. Halaman menjangkaunya dengan neboFetch dan path relatif. Lihat Sidecar Aplikasi.
Publikasikan dari Nebo
Aplikasi buatan pemilik dapat memublikasikan dirinya sendiri. Pemilik berkata “publikasikan dirimu”, atau mengetuk Publikasikan di obrolan aplikasi, di layar aplikasi di aplikasi seluler (di bilah atas, atau sebagai tombol di samping Tutup untuk aplikasi layar penuh), atau memilih Publikasikan Aplikasi Ini… dari menu desktop (menu File di macOS saat jendela aplikasi berada di depan; menu App di jendela aplikasi di Windows dan Linux). Karyawan menyusun draf listing dari aplikasi, mengambil 3 hingga 5 tangkapan layar, dan menampilkan listing di obrolan untuk disempurnakan lewat percakapan. Tidak ada yang dikirim sampai pemilik menjawab Kirim untuk ditinjau di kartu, dengan ketukan atau suara.
Aplikasi buatan pemilik selalu memiliki alat developer untuk dirinya sendiri: muat ulang, status, konsol, tangkapan layar, dan publikasi. Mode App Developer (Pengaturan bot, Developer) memungkinkan karyawan lain mengerjakan aplikasi mana pun milik pemilik, menambahkan konsol mengambang ke halaman, dan menonaktifkan cache. Aplikasi yang dipasang dari marketplace tidak pernah mendapat alat developer atau tombol Publikasikan.
Publikasikan aplikasi sendiri
Aplikasi yang hanya berupa halaman dipublikasikan sebagai satu bundel dengan alat agent. Frontmatter AGENT.md harus menyatakan artifact_type: app, atau marketplace akan membuat karyawan biasa tanpa halaman. Beri tanda kutip pada nilai apa pun yang berisi titik dua diikuti spasi; tanpa tanda kutip, frontmatter tidak dapat dibaca dan aplikasi diam-diam menjadi karyawan biasa.
--- name: deal-board description: "A board of open deals: sorted by close date, with a chat that knows each deal." artifact_type: app metadata: version: "1.0.0" --- # Deal Board You work beside the Deal Board app. ...
agent(action: "create", name: "deal-board", version: "1.0.0",
description: "A board of open deals, sorted by close date.",
manifestContent: "<contents of AGENT.md>")
agent(action: "bundle-token", id: "<app id>")
zip -r deal-board.zip deal-board -x '*/.git/*' '*/node_modules/*' '*/src/*'
curl -X POST "https://neboai.com/api/v1/skills/<app id>/bundle" \
-H "Authorization: Bearer <token>" \
-F file=@deal-board.zip
agent(action: "submit", id: "<app id>", version: "1.0.0") | Di dalam zip | Apa yang terjadi |
|---|---|
AGENT.md | Persona dan manifes listing. |
agent.json | Konfigurasi karyawan. {} sudah cukup. |
manifest.json | Disimpan sebagai manifes aplikasi: pengaturan jendela dan izin sampai ke aplikasi yang terpasang. Harus berupa JSON yang valid. |
ui/ | Halamannya. Diizinkan: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, gambar (png, jpg, gif, svg, webp, avif, ico, bmp), font (woff, woff2, ttf, otf), suara (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. File berawalan titik dan node_modules/ dibuang. |
skills/<name>/ | Skill milik karyawan, diperiksa seperti skill yang diunggah tersendiri: SKILL.md disimpan, scripts/ dan bin/ tipe apa pun, selebihnya sesuai daftar izin skill. |
- Batas: 10 MB per file dan 50 MB per bundel. File di atas 10 MB dilewati (periksa
filesSkippeddanuiFilesStoreddi hasilnya); bundel di atas 50 MB ditolak. - Token unggah berlaku 5 menit. Satu folder teratas di dalam zip akan dihilangkan.
- Untuk aplikasi privat atau khusus kanal, setiap unggahan langsung membangun ulang paket yang dapat dipasang dan Nebo memberi tahu bot yang telah memasang aplikasi tersebut. Bot yang sedang daring langsung memasang paket yang telah dibangun ulang; bot yang luring melakukannya saat tersambung berikutnya. Anda tidak perlu menaikkan versi untuk ini, dan pengaturan, jadwal, serta data pemilik untuk aplikasi tetap disimpan. Aplikasi publik, tidak tercantum, dan khusus undangan tetap memakai paket yang telah disetujui sampai versi baru lolos peninjauan.
- Versi baru mengikuti pengaturan pembaruan otomatis setiap pemilik untuk aplikasi itu. Pengaturan ini nonaktif kecuali pemilik mengaktifkannya, jadi secara default bot menampilkan "Pembaruan tersedia" dan pemilik menerapkannya dari Pengaturan, lalu Pembaruan, atau dari Kotak Masuk. Pembaruan tidak pernah memberikan izin baru; izin yang ditambahkan versi baru akan diminta saat aplikasi pertama kali membutuhkannya.
- Jika NeboAI menarik aplikasi dari marketplace, setiap bot yang memasangnya akan menonaktifkannya dan memberi tahu pemilik. Tidak ada yang dihapus: semua yang disimpan aplikasi tetap ada.
- Aplikasi dengan sidecar mengunggah biner setiap platform dengan
binary-token, dan halamannya sebagai arsipui. Lihat Sidecar Aplikasi dan Publikasi.