Paquete
Appqa llamk'aq paquetem app hina marcaq manifest.jsonyuq, paginayuq ui/ carpetayuqpas.
<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"]
} | Campo | Ima ninan |
|---|---|
type | "app". Llamk'aqta appman tikran. Neboqa mawk'a artifact_typetapas ñawinchanmi. |
id | App kamasqa kaptin ruwasqa UUID. Paginaqa /apps/<id>/ui/pim qusqa. |
name, version | Llamk'aqpa sutin, paquete versiónpas. |
window | title, width, height, resizable, fullscreen, orientation. Ñawpaqmanta kaqkuna: 1024 × 768, hatunyachina, mana llapan pantalla, sayaq, llamk'aqpa sutinwan sutichasqa. |
permissions | Pagina imatachus ruwayta atin. Ñawpaqmanta ["storage:readwrite"]. |
Permisokuna
| Permiso | Qun |
|---|---|
storage:readwrite | Appq llave-chanin waqaychanan. |
subagent:<employee-id> | Paginamanta huk llamk'aqta tapuy. Appq kikin llamk'aqninqa mana permisota necesitanchu. |
network:<host> utaq network:* | Neboq proxyninwan hawa hostkunaman mañakuykuna. |
device:motion | Giroscopio, acelerómetropas kay paginapaqlla. iPhonepiqa paginaqa llamiymanta DeviceMotionEvent.requestPermission()tapas waqyan. |
Sapa permisom prefix:scope. App necesitasqan aswan pisillata mañakuy.
Llapan pantalla, orientación, kinrayaypas
Pukllaykuna, películakunapas llapan pantallata hap'iyta atinku. fullscreenta churay, celular apppaqtaq, orientationta: portrait (ñawpaqmanta), landscape utaq any. Huk orientaciónqa manifiesto qillqasqa kaptin mana chaskisqam.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Escritoriopiqa appqa llapan pantalla ventanapim kichakun.
- Celular apppiqa mana app bar kanchu, sistema barkunaqa pakasqam, pantallaqa rikch'asqam qhipakun, aysaspa musuqchaytaq wañusqa. Huch'uy Close pastillam lluq'i hanaq k'uchupi tiyan, wakin segundokuna qhipataq chinkan; hanaqpi llamiyqa kutichimunmi. iOS k'uchu aysayqa wañusqam, Androidpa kutina botontaq paginapa historianta purin manaraq wichq'achkaspa.
- Paginata
env(safe-area-inset-*)wan,viewport-fit=coverwanpas hunt'achiy, controlkunatataq lluq'i hanaq k'uchumanta karupi hap'iy.
Kunka control
Nebo escritorio apppi utaq celular apppi kichasqa sapa appmi paña ura k'uchunpi huch'uy kunka controlta rikuchin, chhaynapi dueño appq llamk'aqninwan rimananpaq paginapi llamk'ashaptin. Controlqa paginaykimanta hawapim tiyan, chayrayku paginata hukmanta cargayqa manapuni waqyakuyta kuchunchu.
- Escritoriopiqa yaqa 300 por 48 pixelkuna barram, ventanapa paña ura k'uchunmanta 16 pixel ukhupi.
- Celular apppiqa muyu 48-punto botonmi safe area ukhupi, dueño mayqin ladomanpas aysayta atisqan. Llapan pantalla apppiqa waqyakuy qallarisqamanta wakin segundokunapim chay botonman kutin.
- Chaniyuq controlkunata paña ura k'uchumanta karupi hap'iy.
- Waqyakuypi unay ruwanapiqa, llamk'aqqa pisi musuqchaykunatam nin “Kunan allichashani.” hina, manapuni archivo sutikunata utaq kamachikuykunata ñawinchanchu.
Appta kamay
Llamk'aqqa iskay ñanpim appta ruwayta atin, dueño nisqanman hinataq akllan. “Pedidoykunapaq appta ruway” nispaqa musuq app llamk'aqtam kaman. “Qanmi app kanki” utaq “kikiykipaq pukllayta ruway” nispaqa dueño rimashasqan llamk'aqtam appman tikran: chatninta, yuyayninta, personantapas waqaychan, paginantaq hukmanta cargakun dueño paywan rimashaptin. Kayqa rimanakuypi contratasqa llamk'aqpaqpas llamk'anmi. Dueño mayqintachus nisqan mana sut'i kaptinqa, llamk'aqqa huk kutilla tapukun.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Sapa p'unchaw herramientakunaqa (qatiq, formulario, huch'uy dashboard) Neboq kikin app atiyninwanmi ruwasqa. Diseñasqa hina rikukunan pagina, mana ruwasqa hinachu, cinematográfico landing pagina, scrollwan puriq película, ruwasqa arte utaq pukllay hina, mercadomanta App Studio atiywanmi ruwasqa.
Musuq apppaqqa, aswan facil ñanmi llamk'aqta mañakuy. Neboqa appkuna ruwanapaq kikin atiytam apan, llamk'aqtaq create_employeeta llamk'achin, carpetata, manifiestota, personata, paginatapas huk waqyaypi qillqaq. Appqa dueñopa llamk'aq huñunpim segundokunapi rikhurin.
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_employeeqa kikin ui, app, agent_md argumentokunatam hap'in. uipi huk ñanqa chay huk archivollatam rantin. Paginaqa sapa mañakuypim diskomanta ñawinchasqa, chayrayku ventanata hukmanta cargayqa tikrakuytam rikuchin.
Pisi pagina
Kay paginaqa SDKta cargan, pichus llamk'aqnin kasqanta tapun, kutichiytataq rikuchin. Llamk'aqpa idninta, sutintapas rikuchiptinqa, t'inkiyqa allinmi.
<!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> SDKqa app idtam paginapa direccionninmanta tarin. Huk maymantapas qusqa paginaqa <meta name="nebo-app-id" content="<id>">tam necesitan. Estadota appq storagenpi hap'iy, manam paginapichu: ventanaqa wichq'akunmi, storagetaq kawsallanmi.
Imaynatam pagina qusqa
- Neboqa
ui/tam/apps/<id>/ui/pi qun, kikinpa ventananpitaq kichan. - Mana tupaq archivoyuq ñanqa
index.htmlmanmi kutin, chhaynapi cliente ladopi routing llamk'an. - HTML paginakunaqa
nebo-app-id,nebo-base-urlmeta tagkunatam hap'inku. - Sapa archivom chiqap contenido layanwan lluqsin, video, uyarina, fuentekuna,
wasm, 3D modelokunapas (glb,gltf). Mana riqsisqa extensionniyuq archivoqaapplication/octet-streamhinam kachasqa, navegadortaq manam llamk'achinqachu. - Archivokunaqa range mañakuykunatam kutichinku (
206, utaq tukukuyninmanta karupi rangepaq416), chhaynapi videopas, ruidopas maymanpas rinman. Celular appipiqa, videoqa kikin cheqasninpim purin mana ñit'ispa:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Sutinpi contenido hashniyuq archivoqa,
main-0a8ksftt.jshina, huk watapaqmi cachesqa. Hukkunaqa llapan,index.htmlpas, sapa kichaypim qhawasqa, mana tikrasqa kaptintaq304wan kutichin. Hashniyuq sutikunawan ruway, ama makiwan archivokunata sutinta tikraspachu. - Sapa pagina archivom aswanqa 10 MB kanman.
- Carpetata qulluchiyqa llamk'aqtam wañuchin;
delete_employeetaq llapanmanta hurqun.
Sidecarta yapay
Paginaqa servidor lógicata, kikinpa willakuyninkunata, utaq llamk'aq waqyanan herramientakunata necesitaptinqa, sidecarta yapay: Nebo appq waqtanpi purichisqan binario. Paginaqa neboFetchwan relativo ñanwanmi chayan. App Sidecar qhaway.
Nebomanta uyarichiy
Dueño ruwasqan appqa kikinmanta uyarichikuyta atin. Dueñoqa “kikiykita uyarichiy” nin, utaq Publishta ñit'in appq chatninpi, celular apppi appq pantallanpi (hanaq barrapi, utaq llapan pantalla apppaq Close waqtanpi pastilla hina), utaq escritorio menúmanta Publish This App…ta akllan (macOSpi File menú app ventana ñawpaqpi kashaptin; Windowspi, Linuxpipas app ventanapa App menún). Llamk'aqqa appmanta listata wakichin, 3manta 5kama pantalla fotokunata hurqun, listatataq chatpi rikuchin rimaspa allichanapaq. Manam imapas kachasqachu dueño tarjetapi Submit for reviewta kutichinankama, llamiywan utaq kunkawan.
Dueño ruwasqan appqa sapa kutim kikinpaq desarrollador herramientankunayuq: hukmanta cargay, estado, consola, pantalla fotokuna, uyarichiypas. App Desarrollador modoqa (Bot ajustekuna, Desarrollador) huk llamk'aqkunata dueñopa mayqin appninpipas llamk'achin, paginaman phawaq consolata yapan, cachetataq wañuchin. Mercadomanta instalasqa appkunaqa manapuni desarrollador herramientakunata nitaq Publish botonta hap'inkuchu.
Kikiyki appta uyarichiy
Paginalla appqa agent herramientawanmi huk paquete hina uyarichikun. AGENT.md frontmatterqa artifact_type: app ninanmi, mana chayqa mercadoqa paginannaq sencillo llamk'aqtam kaman. Dos puntos qhipanpi espacioyuq mayqin chanintapas comillakunapi churay; mana comillawanqa, frontmatterqa manam ñawinchakuyta atinchu, apptaq upallalla sencillo llamk'aqman tikrakun.
--- 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 ukhupi | Ima pasakun |
|---|---|
AGENT.md | Persona, listapa manifiestonpas. |
agent.json | Llamk'aqpa configuracionnin. {} allinmi. |
manifest.json | Appq manifiesto hina waqaychasqa: ventana, permisokunapas instalasqa appmanmi chayanku. Allin JSONmi kanan. |
ui/ | Pagina. Saqisqa: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, rikchakuna (png, jpg, gif, svg, webp, avif, ico, bmp), fuentekuna (woff, woff2, ttf, otf), uyarina (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Punto archivokuna, node_modules/pas hurqusqam. |
skills/<name>/ | Llamk'aqpa kikin atiyninkuna, sapallan upload ruwasqa atiy hina qhawasqa: SKILL.md waqaychasqa, scripts/, bin/pas mayqin layapas, hukkunataq atiy allowlistpi. |
- Saywakuna: sapa archivopaq 10 MB, sapa paquetepaq 50 MB. 10 MBmanta aswan archivoqa saltasqam (resultadopi
filesSkippedta,uiFilesStoredtapas qhaway); 50 MBmanta aswan paqueteqa mana chaskisqam. - Upload tokenqa 5 minutokunam unan. Zippi huk hanaq carpetallaqa hurqusqam.
- Sapallan utaq canalkunallapaq apppaqqa, sapa upload ruwaymi instalana paqueteta chaylla hukmanta ruwan, Nebotaq appta instalaq botkunaman willan. Online kaq botqa hukmanta ruwasqa paqueteta chaylla churan; offline kaqqa qatiq kuti t'inkikuptin ruwan. Kaypaqqa manam versiónta wichachinaykichu, dueñopa apppaq ajustekunan, horarionkunan, willakuyninkunanpas waqaychasqam. Público, mana listasqa, invitacionllapaq appkunaqa aprobasqa paquetentam hap'inku musuq versión qhawariyta pasanankama.
- Musuq versiónqa sapa dueñopa apppaq kikillanmanta musuqchay ajustentam qatin. Wañusqam dueño mana prendeptinqa, chayrayku ñawpaqmantaqa botqa "Update available" nispa rikuchin, dueñotaq Ajustekunamanta, chaymanta Updates, utaq Chaskinamanta churan. Musuqchayqa manapuni musuq permisokunata qunchu; musuq versión yapasqan permisoqa app ñawpaq kuti necesitaptinmi mañakun.
- NeboAI appta mercadomanta hurquptinqa, instalaq sapa botmi wañuchin, dueñomantaq willan. Manam imapas qulluchisqachu: app waqaychasqan llapanmi waqaychasqa.
- Sidecaryuq appqa sapa plataformapa binariontam
binary-tokenwan upload ruwan, paginatataquiarchivo hina. App Sidecar, Uyarichiypas qhaway.