NeboAI
NeboAI
Qallariy

Appkuna

Appqa paginayuq llamk'aqmi. Dueñokunaqa kikinpa ventananpim kichanku imatapas chiqallanta rikunankupaq, llamk'anankupaqpas: tablero, qatiq, formulario. Paginaqa sencillo HTML, JavaScriptmi, Nebowan, llamk'aqninwanpas huk scriptwanmi riman, App SDK.

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"]
}
CampoIma ninan
type"app". Llamk'aqta appman tikran. Neboqa mawk'a artifact_typetapas ñawinchanmi.
idApp kamasqa kaptin ruwasqa UUID. Paginaqa /apps/<id>/ui/pim qusqa.
name, versionLlamk'aqpa sutin, paquete versiónpas.
windowtitle, width, height, resizable, fullscreen, orientation. Ñawpaqmanta kaqkuna: 1024 × 768, hatunyachina, mana llapan pantalla, sayaq, llamk'aqpa sutinwan sutichasqa.
permissionsPagina imatachus ruwayta atin. Ñawpaqmanta ["storage:readwrite"].

Permisokuna

PermisoQun
storage:readwriteAppq 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:motionGiroscopio, 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-url meta tagkunatam hap'inku.
  • Sapa archivom chiqap contenido layanwan lluqsin, video, uyarina, fuentekuna, wasm, 3D modelokunapas (glb, gltf). Mana riqsisqa extensionniyuq archivoqa application/octet-stream hinam kachasqa, navegadortaq manam llamk'achinqachu.
  • Archivokunaqa range mañakuykunatam kutichinku (206, utaq tukukuyninmanta karupi rangepaq 416), 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.js hina, huk watapaqmi cachesqa. Hukkunaqa llapan, index.htmlpas, sapa kichaypim qhawasqa, mana tikrasqa kaptintaq 304wan 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 ukhupiIma pasakun
AGENT.mdPersona, listapa manifiestonpas.
agent.jsonLlamk'aqpa configuracionnin. {} allinmi.
manifest.jsonAppq 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, paginatataq ui archivo hina. App Sidecar, Uyarichiypas qhaway.