Paket
Uygulama, onu uygulama olarak işaretleyen bir manifest.json ve sayfayı içeren bir ui/ klasörü olan bir çalışan paketidir.
<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"]
} | Alan | Anlamı |
|---|---|
type | "app". Çalışanı bir uygulama yapar. Nebo eski artifact_type alanını da okur. |
id | Uygulama oluşturulduğunda üretilen bir UUID. Sayfa /apps/<id>/ui/ adresinde sunulur. |
name, version | Çalışanın adı ve paket sürümü. |
window | title, width, height, resizable, fullscreen, orientation. Varsayılanlar: 1024 × 768, yeniden boyutlandırılabilir, tam ekran değil, dikey, başlığı çalışanın adı. |
permissions | Sayfanın neler yapabileceği. Varsayılan ["storage:readwrite"]. |
İzinler
| İzin | Verdiği |
|---|---|
storage:readwrite | Uygulamanın anahtar-değer deposu. |
subagent:<employee-id> | Sayfadan başka bir çalışana soru sorma. Uygulamanın kendi çalışanı için izin gerekmez. |
network:<host> veya network:* | Nebo'nun proxy'si üzerinden harici sunuculara istekler. |
device:motion | Yalnızca bu sayfa için jiroskop ve ivmeölçer. iPhone'da sayfa ayrıca bir dokunuşla DeviceMotionEvent.requestPermission() çağırır. |
Her izin prefix:scope biçimindedir. Uygulamanın ihtiyaç duyduğu en azını isteyin.
Tam ekran, yön ve eğim
Oyunlar ve filmler tüm ekranı kaplayabilir. fullscreen ayarlayın ve mobil uygulama için bir orientation belirleyin: portrait (varsayılan), landscape veya any. Başka herhangi bir yön, manifesto yazılırken reddedilir.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Masaüstünde uygulama tam ekran bir pencerede açılır.
- Mobil uygulamada uygulama çubuğu yoktur, sistem çubukları gizlenir, ekran açık kalır ve yenilemek için çekme kapalıdır. Sol üst köşede küçük bir Kapat düğmesi bulunur ve birkaç saniye sonra kaybolur; üst kısma yakın bir dokunuş onu geri getirir. iOS kenar kaydırması kapalıdır ve Android'in geri düğmesi kapatmadan önce sayfanın geçmişinde geri gider.
- Sayfaya
env(safe-area-inset-*)veviewport-fit=coverile boşluk verin ve denetimleri sol üst köşeden uzak tutun.
Ses denetimi
Nebo masaüstü uygulamasında veya mobil uygulamada açılan her uygulama, sağ alt köşesinde küçük bir ses denetimi gösterir; böylece sahip, uygulamanın çalışanı sayfa üzerinde çalışırken onunla konuşabilir. Denetim sayfanızın dışında durur, bu yüzden sayfayı yeniden yüklemek görüşmeyi asla kesmez.
- Masaüstünde yaklaşık 300 x 48 piksel boyutunda, pencerenin sağ alt köşesinden 16 piksel içeride bir çubuktur.
- Mobil uygulamada, güvenli alanın içinde, sahibin iki yana sürükleyebileceği 48 noktalık yuvarlak bir düğmedir. Tam ekran bir uygulamada, görüşme başladıktan birkaç saniye sonra yeniden bu düğmeye dönüşür.
- Önemli denetimleri sağ alt köşeden uzak tutun.
- Bir görüşme sırasında uzun bir görev yürütülürken çalışan "Şimdi düzenliyorum." gibi kısa güncellemeler söyler ve dosya adlarını veya komutları asla sesli okumaz.
Bir uygulama oluşturun
Bir çalışan iki şekilde uygulama oluşturabilir ve sahibinin söylediğine göre seçer. "Siparişlerim için bir uygulama yap" yeni bir uygulama çalışanı oluşturur. "Uygulama sensin" veya "kendine bir oyun yap" ise sahibinin konuştuğu çalışanı uygulamaya dönüştürür: sohbetini, belleğini ve kişiliğini korur ve sahip onunla konuşurken sayfası yeniden yüklenir. Bu, sohbet içinde işe alınan bir çalışan için de geçerlidir. Sahibinin hangisini kastettiği net değilse çalışan bir kez sorar.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Gündelik araçlar (bir takipçi, bir form, küçük bir pano) Nebo'nun yerleşik uygulama becerisiyle oluşturulur. Sinematik bir açılış sayfası, kaydırmayla ilerleyen bir film, üretilmiş sanat ya da bir oyun gibi, üretilmiş değil tasarlanmış görünmesi gereken bir sayfa ise pazar yerindeki App Studio becerisiyle oluşturulur.
Yeni bir uygulama için en basit yol bir çalışandan istemektir. Nebo, uygulama oluşturmak için yerleşik bir beceri içerir ve çalışan, klasörü, manifestoyu, kişiliği ve sayfayı tek bir çağrıda yazan create_employee aracını kullanır. Uygulama saniyeler içinde sahibinin iş gücünde görünür.
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 aynı ui, app ve agent_md argümanlarını alır. ui içindeki bir yol yalnızca o dosyanın yerini alır. Sayfa her istekte diskten okunur, bu yüzden pencereyi yeniden yüklemek değişikliği gösterir.
Minimal bir sayfa
Bu sayfa SDK'yı yükler, çalışanının kim olduğunu sorar ve yanıtı yazdırır. Çalışanın kimliğini ve adını gösteriyorsa bağlantılar doğrudur.
<!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, uygulama kimliğini sayfanın adresinden bulur. Başka bir yerden sunulan bir sayfanın <meta name="nebo-app-id" content="<id>"> etiketine ihtiyacı vardır. Durumu sayfada değil, uygulamanın depolamasında tutun: pencere kapanır, depolama kalır.
Sayfa nasıl sunulur
- Nebo
ui/klasörünü/apps/<id>/ui/adresinde sunar ve onu kendi penceresinde açar. - Eşleşen dosyası olmayan bir yol
index.htmldosyasına düşer, böylece istemci tarafı yönlendirme çalışır. - HTML sayfaları
nebo-app-idvenebo-base-urlmeta etiketlerini alır. - Video, ses, yazı tipleri,
wasmve 3B modeller (glb,gltf) dahil her dosya gerçek içerik türüyle gönderilir. Bilinmeyen uzantılı bir dosyaapplication/octet-streamolarak gönderilir ve tarayıcı onu kullanmaz. - Dosyalar aralık isteklerine yanıt verir (
206veya sonun ötesindeki bir aralık için416), böylece video ve seste ileri geri sarılabilir. Mobil uygulamada video, dokunmaya gerek kalmadan yerinde oynatılır:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Adında içerik özeti bulunan bir dosya, örneğin
main-0a8ksftt.js, bir yıl boyunca önbelleğe alınır.index.htmldahil diğer her şey her açılışta kontrol edilir ve değişmemişse304ile yanıt verir. Dosyaları elle yeniden adlandırmak yerine özetli adlarla derleyin. - Her sayfa dosyası en fazla 10 MB olabilir.
- Klasörü silmek çalışanı devre dışı bırakır;
delete_employeeonu tamamen kaldırır.
Sidecar ekleyin
Sayfa sunucu mantığına, kendi verilerine ya da çalışanın çağırabileceği araçlara ihtiyaç duyduğunda bir sidecar ekleyin: Nebo'nun uygulamanın yanında çalıştırdığı bir ikili dosya. Sayfa ona neboFetch ve göreli bir yolla ulaşır. Bkz. Uygulama Sidecar'ı.
Nebo'dan yayımlayın
Sahibinin yaptığı bir uygulama kendini yayımlayabilir. Sahip "kendini yayımla" der ya da uygulamanın sohbetinde, mobil uygulamadaki uygulama ekranında (üst çubukta veya tam ekran bir uygulamada Kapat'ın yanındaki düğme olarak) Publish düğmesine dokunur ya da masaüstü menüsünden Publish This App… seçeneğini seçer (macOS'ta bir uygulama penceresi öndeyken Dosya menüsü; Windows ve Linux'ta uygulama penceresinin App menüsü). Çalışan listeyi uygulamadan hazırlar, 3 ila 5 ekran görüntüsü alır ve listeyi konuşarak şekillendirmek için sohbette gösterir. Sahip karttaki Submit for review seçeneğine dokunarak veya sesle yanıt verene kadar hiçbir şey gönderilmez.
Sahibinin yaptığı bir uygulamanın kendi geliştirici araçları her zaman vardır: yeniden yükleme, durum, konsol, ekran görüntüleri ve yayımlama. App Developer modu (Bot ayarları, Geliştirici) diğer çalışanların sahibinin herhangi bir uygulaması üzerinde çalışmasına izin verir, sayfaya kayan bir konsol ekler ve önbelleği kapatır. Pazar yerinden yüklenen uygulamalar hiçbir zaman geliştirici araçlarına veya Publish düğmesine sahip olmaz.
Bir uygulamayı kendiniz yayımlayın
Yalnızca sayfadan oluşan bir uygulama, agent aracıyla tek bir paket olarak yayımlanır. AGENT.md ön bilgisinde artifact_type: app yazmalıdır; aksi hâlde pazar yeri sayfası olmayan düz bir çalışan oluşturur. İki nokta üst üste ve ardından boşluk içeren her değeri tırnak içine alın; tırnaksız olursa ön bilgi okunamaz ve uygulama sessizce düz bir çalışana dönüşür.
--- 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") | Zip içinde | Ne olur |
|---|---|
AGENT.md | Kişilik ve listenin manifestosu. |
agent.json | Çalışanın yapılandırması. {} yeterlidir. |
manifest.json | Uygulamanın manifestosu olarak korunur: pencere ve izinler yüklenen uygulamaya ulaşır. Geçerli JSON olmalıdır. |
ui/ | Sayfa. İzin verilenler: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, görseller (png, jpg, gif, svg, webp, avif, ico, bmp), yazı tipleri (woff, woff2, ttf, otf), ses (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Nokta ile başlayan dosyalar ve node_modules/ çıkarılır. |
skills/<name>/ | Çalışanın kendi becerileri, tek başına yüklenen bir beceri gibi denetlenir: SKILL.md korunur, scripts/ ve bin/ her türden olabilir, geri kalan her şey beceri izin listesine tabidir. |
- Sınırlar: dosya başına 10 MB ve paket başına 50 MB. 10 MB'ı aşan bir dosya atlanır (sonuçtaki
filesSkippedveuiFilesStoreddeğerlerini kontrol edin); 50 MB'ı aşan bir paket reddedilir. - Yükleme belirteci 5 dakika geçerlidir. Zip içindeki tek bir üst klasör kaldırılır.
- Gizli veya yalnızca kanallara açık bir uygulamada her yükleme, kurulabilir paketi hemen yeniden oluşturur ve Nebo, uygulamayı yükleyen botlara haber verir. Çevrimiçi bir bot yeniden oluşturulan paketi hemen yerine koyar; çevrimdışı olan bir bot bunu bir sonraki bağlantısında yapar. Bunun için sürümü yükseltmeniz gerekmez ve sahibinin uygulamaya ait ayarları, zamanlamaları ve verileri korunur. Herkese açık, listelenmemiş ve yalnızca davetle erişilen uygulamalar, yeni bir sürüm incelemeden geçene kadar onaylanmış paketlerini korur.
- Yeni bir sürüm, her sahibin o uygulama için belirlediği otomatik güncelleme ayarına uyar. Sahip açmadıkça bu ayar kapalıdır; bu yüzden varsayılan olarak bot "Güncelleme mevcut" gösterir ve sahip bunu Ayarlar, ardından Güncellemeler bölümünden ya da Gelen Kutusu'ndan uygular. Bir güncelleme asla yeni izin vermez; yeni sürümün eklediği bir izin, uygulama ona ilk ihtiyaç duyduğunda istenir.
- NeboAI bir uygulamayı pazar yerinden çekerse, onu yükleyen her bot uygulamayı kapatır ve sahibine bildirir. Hiçbir şey silinmez: uygulamanın kaydettiği her şey korunur.
- Sidecar'ı olan bir uygulama ise her platformun ikili dosyasını
binary-tokenile, sayfayı da biruiarşivi olarak yükler. Bkz. Uygulama Sidecar'ı ve Yayımlama.