Pakej
Aplikasi ialah pakej pekerja dengan manifest.json yang menandakannya sebagai aplikasi dan folder ui/ dengan halaman.
<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"]
} | Medan | Maksud |
|---|---|
type | "app". Menjadikan pekerja sebagai aplikasi. Nebo juga membaca artifact_type yang lebih lama. |
id | UUID yang dijana apabila aplikasi dicipta. Halaman disajikan di /apps/<id>/ui/. |
name, version | Nama pekerja dan versi pakej. |
window | title, width, height, resizable, fullscreen, orientation. Lalai: 1024 × 768, boleh diubah saiz, bukan skrin penuh, potret, bertajuk mengikut nama pekerja. |
permissions | Apa yang boleh dilakukan oleh halaman. Lalai ["storage:readwrite"]. |
Kebenaran
| Kebenaran | Memberikan |
|---|---|
storage:readwrite | Stor kunci-nilai aplikasi. |
subagent:<employee-id> | Bertanya kepada pekerja lain daripada halaman. Pekerja aplikasi itu sendiri tidak memerlukan kebenaran. |
network:<host> atau network:* | Permintaan kepada hos luar melalui proksi Nebo. |
device:motion | Giroskop dan pecutan meter untuk halaman ini sahaja. Pada iPhone halaman juga memanggil DeviceMotionEvent.requestPermission() daripada ketikan. |
Setiap kebenaran ialah prefix:scope. Minta yang paling sedikit diperlukan oleh aplikasi.
Skrin penuh, orientasi dan kecondongan
Permainan dan filem boleh mengambil seluruh skrin. Tetapkan fullscreen dan, untuk aplikasi mudah alih, orientation: portrait (lalai), landscape atau any. Sebarang orientasi lain ditolak apabila manifes ditulis.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Pada desktop aplikasi dibuka dalam tetingkap skrin penuh.
- Dalam aplikasi mudah alih tiada bar aplikasi, bar sistem disembunyikan, skrin kekal menyala dan tarik untuk segar semula dimatikan. Butang Tutup kecil berada di penjuru kiri atas dan pudar selepas beberapa saat; sentuhan berhampiran bahagian atas memaparkannya semula. Leretan tepi iOS dimatikan, dan butang kembali Android menelusuri sejarah halaman sebelum menutup.
- Beri ruang pada halaman dengan
env(safe-area-inset-*)danviewport-fit=cover, dan jauhkan kawalan daripada penjuru kiri atas.
Kawalan suara
Setiap aplikasi yang dibuka dalam aplikasi desktop Nebo atau dalam aplikasi mudah alih menunjukkan kawalan suara kecil di penjuru kanan bawahnya, supaya pemilik boleh bercakap dengan pekerja aplikasi semasa ia bekerja pada halaman. Kawalan itu berada di luar halaman anda, jadi memuat semula halaman tidak sekali-kali memutuskan panggilan.
- Pada desktop ia ialah bar lebih kurang 300 kali 48 piksel, 16 piksel ke dalam dari penjuru kanan bawah tetingkap.
- Dalam aplikasi mudah alih ia ialah butang bulat 48 mata di dalam kawasan selamat yang boleh diseret oleh pemilik ke mana-mana sisi. Dalam aplikasi skrin penuh ia berlipat kembali menjadi butang itu beberapa saat selepas panggilan bermula.
- Jauhkan kawalan penting daripada penjuru kanan bawah.
- Semasa tugas panjang dalam panggilan, pekerja menyebut kemas kini ringkas seperti “Sedang mengedit.” dan tidak sekali-kali membacakan nama fail atau arahan.
Cipta aplikasi
Pekerja boleh membina aplikasi dengan dua cara, dan memilih berdasarkan apa yang dikatakan pemilik. “Bina saya aplikasi untuk pesanan saya” mencipta pekerja aplikasi baharu. “Awaklah aplikasinya” atau “bina permainan untuk diri awak” menjadikan pekerja yang sedang bercakap dengan pemilik sebagai aplikasi: ia mengekalkan sembang, memori dan personanya, dan halamannya dimuat semula semasa pemilik bercakap dengannya. Ini juga berfungsi untuk pekerja yang diambil dalam perbualan. Apabila tidak jelas yang mana dimaksudkan pemilik, pekerja bertanya sekali.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Alat harian (penjejak, borang, papan pemuka kecil) dibina dengan kemahiran aplikasi terbina dalam Nebo. Halaman yang sepatutnya kelihatan direka dan bukannya dijana, seperti halaman pendaratan sinematik, filem dipacu tatal, seni yang dijana atau permainan, dibina dengan kemahiran App Studio dari pasaran.
Untuk aplikasi baharu, cara paling mudah ialah meminta pekerja. Nebo menyertakan kemahiran terbina dalam untuk membina aplikasi, dan pekerja menggunakan create_employee, yang menulis folder, manifes, persona dan halaman dalam satu panggilan. Aplikasi muncul dalam tenaga kerja pemilik dalam beberapa saat.
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. Laluan dalam ui menggantikan fail itu sahaja. Halaman dibaca daripada cakera pada setiap permintaan, jadi memuat semula tetingkap menunjukkan perubahan.
Halaman minimum
Halaman ini memuatkan SDK, bertanya siapa pekerjanya dan mencetak jawapannya. Jika ia menunjukkan id dan nama pekerja, sambungannya betul.
<!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 mencari id aplikasi daripada alamat halaman. Halaman yang disajikan dari tempat lain memerlukan <meta name="nebo-app-id" content="<id>">. Simpan keadaan dalam storan aplikasi, bukan dalam halaman: tetingkap akan ditutup, tetapi storan kekal.
Cara halaman disajikan
- Nebo menyajikan
ui/di/apps/<id>/ui/dan membukanya dalam tetingkapnya sendiri. - Laluan tanpa fail yang sepadan kembali kepada
index.html, jadi penghalaan sisi klien berfungsi. - Halaman HTML mendapat tag meta
nebo-app-iddannebo-base-url. - Setiap fail dihantar dengan jenis kandungannya yang sebenar, termasuk video, bunyi, fon,
wasmdan model 3D (glb,gltf). Fail dengan sambungan yang tidak dikenali dihantar sebagaiapplication/octet-streamdan pelayar tidak akan menggunakannya. - Fail menjawab permintaan julat (
206, atau416bagi julat melepasi penghujung), supaya video dan bunyi boleh dicari kedudukannya. Dalam aplikasi mudah alih, video dimainkan di tempatnya tanpa perlu diketik:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Fail yang namanya membawa cincangan kandungan, seperti
main-0a8ksftt.js, dicache selama setahun. Semua yang lain, termasukindex.html, disemak pada setiap pembukaan dan menjawab304apabila tidak berubah. Bina dengan nama bercincang dan bukannya menamakan semula fail secara manual. - Setiap fail halaman boleh bersaiz paling besar 10 MB.
- Memadam folder menyahaktifkan pekerja;
delete_employeemembuangnya sepenuhnya.
Tambah sidecar
Apabila halaman memerlukan logik pelayan, datanya sendiri, atau alat yang boleh dipanggil oleh pekerja, tambah sidecar: binari yang dijalankan Nebo di sebelah aplikasi. Halaman mencapainya dengan neboFetch dan laluan relatif. Lihat Sidecar Aplikasi.
Terbitkan dari Nebo
Aplikasi yang dibuat oleh pemilik boleh menerbitkan dirinya sendiri. Pemilik berkata “terbitkan diri awak”, atau mengetik Publish dalam sembang aplikasi, pada skrin aplikasi dalam aplikasi mudah alih (di bar atas, atau sebagai butang di sebelah Tutup untuk aplikasi skrin penuh), atau memilih Publish This App… daripada menu desktop (menu File pada macOS semasa tetingkap aplikasi berada di hadapan; menu App tetingkap aplikasi pada Windows dan Linux). Pekerja mendrafkan senarai daripada aplikasi, mengambil 3 hingga 5 tangkapan skrin dan menunjukkan senarai itu dalam sembang untuk dibentuk dengan bercakap. Tiada apa yang dihantar sehingga pemilik menjawab Submit for review pada kad, dengan ketikan atau suara.
Aplikasi yang dibuat oleh pemilik sentiasa mempunyai alat pembangunnya sendiri: muat semula, status, konsol, tangkapan skrin dan penerbitan. Mod Pembangun Aplikasi (tetapan Bot, Pembangun) membolehkan pekerja lain bekerja pada mana-mana aplikasi pemilik, menambah konsol terapung pada halaman dan mematikan cache. Aplikasi yang dipasang dari pasaran tidak sekali-kali mendapat alat pembangun atau butang Publish.
Terbitkan aplikasi sendiri
Aplikasi halaman sahaja diterbitkan sebagai satu himpunan dengan alat agent. Frontmatter AGENT.md mesti menyatakan artifact_type: app, jika tidak pasaran akan mencipta pekerja biasa tanpa halaman. Letakkan tanda petikan pada sebarang nilai yang mengandungi titik bertindih diikuti ruang; tanpa tanda petikan, frontmatter tidak dapat dibaca dan aplikasi itu senyap-senyap menjadi pekerja 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") | Dalam zip | Apa yang berlaku |
|---|---|
AGENT.md | Persona dan manifes senarai. |
agent.json | Konfigurasi pekerja. {} sudah memadai. |
manifest.json | Disimpan sebagai manifes aplikasi: tetingkap dan kebenaran sampai ke aplikasi yang dipasang. Mesti JSON yang sah. |
ui/ | Halaman. Dibenarkan: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, imej (png, jpg, gif, svg, webp, avif, ico, bmp), fon (woff, woff2, ttf, otf), bunyi (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Fail bertitik dan node_modules/ dibuang. |
skills/<name>/ | Kemahiran pekerja itu sendiri, disemak seperti kemahiran yang dimuat naik secara berasingan: SKILL.md dikekalkan, scripts/ dan bin/ sebarang jenis, yang lain mengikut senarai dibenarkan kemahiran. |
- Had: 10 MB bagi setiap fail dan 50 MB bagi setiap himpunan. Fail melebihi 10 MB dilangkau (semak
filesSkippeddanuiFilesStoreddalam hasilnya); himpunan melebihi 50 MB ditolak. - Token muat naik bertahan 5 minit. Satu folder teratas dalam zip akan dibuang.
- Untuk aplikasi peribadi atau saluran sahaja, setiap muat naik membina semula pakej boleh pasang serta-merta dan Nebo memberitahu bot yang memasang aplikasi itu. Bot yang dalam talian meletakkan pakej yang dibina semula dengan segera; bot yang di luar talian melakukannya apabila ia menyambung semula. Anda tidak perlu menaikkan versi untuk ini, dan tetapan, jadual dan data pemilik untuk aplikasi itu dikekalkan. Aplikasi awam, tidak tersenarai dan jemputan sahaja mengekalkan pakej yang diluluskan sehingga versi baharu lulus semakan.
- Versi baharu mengikut tetapan kemas kini automatik setiap pemilik untuk aplikasi itu. Ia dimatikan melainkan pemilik menghidupkannya, jadi secara lalai bot menunjukkan "Kemas kini tersedia" dan pemilik menggunakannya daripada Tetapan, kemudian Kemas Kini, atau daripada Peti Masuk. Kemas kini tidak sekali-kali memberikan kebenaran baharu; kebenaran yang ditambah oleh versi baharu akan diminta apabila aplikasi pertama kali memerlukannya.
- Jika NeboAI menarik balik aplikasi dari pasaran, setiap bot yang memasangnya akan mematikannya dan memberitahu pemilik. Tiada apa yang dipadam: semua yang disimpan oleh aplikasi dikekalkan.
- Aplikasi dengan sidecar memuat naik binari setiap platform dengan
binary-tokensebaliknya, dan halaman sebagai arkibui. Lihat Sidecar Aplikasi dan Penerbitan.