NeboAI
NeboAI
Magsimula

Mga App

Ang app ay isang empleyadong may pahina. Binubuksan ito ng mga may-ari sa sarili nitong window para direktang makita at magamit ang isang bagay: isang board, tracker, o form. Simpleng HTML at JavaScript ang pahina, at nakikipag-usap ito sa Nebo at sa empleyado nito sa pamamagitan ng iisang script, ang App SDK.

Ang package

Ang app ay isang employee package na may manifest.json na nagmamarka rito bilang app at isang ui/ folder na may pahina.

<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"]
}
FieldKahulugan
type"app". Ginagawang app ang empleyado. Binabasa rin ng Nebo ang mas lumang artifact_type.
idIsang UUID na ginagawa kapag nilikha ang app. Inihahain ang pahina sa /apps/<id>/ui/.
name, versionAng pangalan ng empleyado at ang bersyon ng package.
windowtitle, width, height, resizable, fullscreen, orientation. Mga default: 1024 × 768, resizable, hindi full screen, portrait, may pamagat na pangalan ng empleyado.
permissionsAng puwedeng gawin ng pahina. Default ["storage:readwrite"].

Mga Pahintulot

PahintulotIbinibigay
storage:readwriteAng key-value store ng app.
subagent:<employee-id>Pagtatanong sa ibang empleyado mula sa pahina. Walang kailangang pahintulot ang sariling empleyado ng app.
network:<host> o network:*Mga request sa panlabas na host sa pamamagitan ng proxy ng Nebo.
device:motionAng gyroscope at accelerometer para sa pahinang ito lang. Sa iPhone, tinatawag din ng pahina ang DeviceMotionEvent.requestPermission() mula sa isang tap.

Bawat pahintulot ay prefix:scope. Hingin ang pinakakaunting kailangan ng app.

Full screen, orientation at pagkiling

Puwedeng sakupin ng mga laro at pelikula ang buong screen. Itakda ang fullscreen at, para sa mobile app, isang orientation: portrait (ang default), landscape o any. Tinatanggihan ang anumang ibang orientation kapag isinusulat ang manifest.

{
  "type": "app",
  "permissions": ["storage:readwrite", "device:motion"],
  "window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
}
  • Sa desktop, bumubukas ang app sa isang full-screen na window.
  • Sa mobile app, walang app bar, nakatago ang mga system bar, nananatiling gising ang screen at naka-off ang pull to refresh. May maliit na Close pill sa kaliwang itaas na sulok na naglalaho pagkalipas ng ilang segundo; ibinabalik ito ng isang pindot malapit sa itaas. Naka-off ang edge swipe sa iOS, at binabaybay muna ng back button ng Android ang history ng pahina bago magsara.
  • Lagyan ng padding ang pahina gamit ang env(safe-area-inset-*) at viewport-fit=cover, at ilayo ang mga kontrol sa kaliwang itaas na sulok.

Ang voice control

Bawat app na binuksan sa Nebo desktop app o sa mobile app ay nagpapakita ng maliit na voice control sa kanang ibabang sulok nito, para makausap ng may-ari ang empleyado ng app habang nagtatrabaho ito sa pahina. Nasa labas ng pahina mo ang kontrol, kaya hindi kailanman napuputol ang tawag kapag ni-reload ang pahina.

  • Sa desktop, isa itong bar na mga 300 por 48 pixel, 16 pixel papasok mula sa kanang ibabang sulok ng window.
  • Sa mobile app, isa itong bilog na 48-point na button sa loob ng safe area na puwedeng i-drag ng may-ari sa alinmang gilid. Sa isang full-screen na app, bumabalik ito sa button na iyon ilang segundo pagkasimula ng tawag.
  • Ilayo ang mahahalagang kontrol sa kanang ibabang sulok.
  • Sa mahabang task habang may tawag, nagsasabi ang empleyado ng maiikling update gaya ng “Nag-e-edit na.” at hindi kailanman binabasa nang malakas ang mga pangalan ng file o command.

Gumawa ng app

Dalawang paraan ang pagbuo ng empleyado ng app, at pumipili ito batay sa sinasabi ng may-ari. Ang “Gawan mo ako ng app para sa mga order ko” ay gumagawa ng bagong app employee. Ang “Ikaw ang app” o “gumawa ka ng laro para sa sarili mo” ay ginagawang app ang empleyadong kausap ng may-ari: pinapanatili nito ang chat, memory at persona nito, at nire-reload ang pahina nito habang kinakausap ito ng may-ari. Gumagana rin ito para sa empleyadong na-hire sa usapan. Kapag hindi malinaw kung alin ang ibig sabihin ng may-ari, isang beses nagtatanong ang empleyado.

update_employee(
  name: "<the employee's own name>",
  app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
  ui: { "index.html": "<!doctype html>..." }
)

Ang mga pang-araw-araw na tool (isang tracker, form, maliit na dashboard) ay binubuo gamit ang built-in na app skill ng Nebo. Ang pahinang dapat magmukhang dinisenyo sa halip na ginawa lang, gaya ng cinematic na landing page, pelikulang pinapatakbo ng scroll, generated art o laro, ay binubuo gamit ang App Studio skill mula sa marketplace.

Para sa bagong app, ang pinakasimpleng paraan ay hilingin ito sa isang empleyado. May built-in na skill ang Nebo para sa pagbuo ng mga app, at ginagamit ng empleyado ang create_employee, na sumusulat sa folder, manifest, persona at pahina sa iisang tawag. Lalabas ang app sa workforce ng may-ari sa loob ng ilang segundo.

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>..." }
)

Tumatanggap ang update_employee ng parehong ui, app at agent_md na argument. Pinapalitan ng isang path sa ui ang iisang file na iyon. Binabasa mula sa disk ang pahina sa bawat request, kaya ipinapakita ang pagbabago kapag ni-reload ang window.

Isang minimal na pahina

Nilo-load ng pahinang ito ang SDK, tinatanong kung sino ang empleyado nito, at ipini-print ang sagot. Kung ipinapakita nito ang id at pangalan ng empleyado, tama ang pagkakakabit.

<!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>

Hinahanap ng SDK ang app id mula sa address ng pahina. Kailangan ng pahinang inihahain mula saanman ng <meta name="nebo-app-id" content="<id>">. Itago ang state sa storage ng app, hindi sa pahina: nagsasara ang window, at nananatili ang storage.

Paano inihahain ang pahina

  • Inihahain ng Nebo ang ui/ sa /apps/<id>/ui/ at binubuksan ito sa sarili nitong window.
  • Bumabalik sa index.html ang path na walang katugmang file, kaya gumagana ang client-side routing.
  • Nakakakuha ang mga HTML page ng mga meta tag na nebo-app-id at nebo-base-url.
  • Ipinapadala ang bawat file kasama ang totoong content type nito, kabilang ang video, tunog, font, wasm at mga 3D model (glb, gltf). Ipinapadala bilang application/octet-stream ang file na may hindi kilalang extension at hindi ito gagamitin ng browser.
  • Sumasagot ang mga file sa mga range request (206, o 416 para sa range na lampas sa dulo), kaya puwedeng mag-seek ang video at tunog. Sa mobile app, nagpe-play ang video sa mismong lugar nang hindi kailangang i-tap: <video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video>
  • Naka-cache nang isang taon ang file na may content hash sa pangalan, gaya ng main-0a8ksftt.js. Ang lahat ng iba pa, kasama ang index.html, ay sinusuri sa bawat pagbukas at sumasagot ng 304 kapag walang nagbago. Mag-build gamit ang mga naka-hash na pangalan sa halip na mano-manong palitan ang pangalan ng mga file.
  • Hanggang 10 MB lang ang bawat file ng pahina.
  • Dina-deactivate ng pag-delete ng folder ang empleyado; tuluyan itong inaalis ng delete_employee.

Magdagdag ng sidecar

Kapag kailangan ng pahina ng server logic, sarili nitong data, o mga tool na matatawag ng empleyado, magdagdag ng sidecar: isang binary na pinapatakbo ng Nebo sa tabi ng app. Naaabot ito ng pahina gamit ang neboFetch at isang relative path. Tingnan ang App Sidecar.

Mag-publish mula sa Nebo

Kayang i-publish ng app na ginawa ng may-ari ang sarili nito. Sinasabi ng may-ari ang “i-publish mo ang sarili mo”, o tina-tap ang Publish sa chat ng app, sa screen ng app sa mobile app (sa top bar, o bilang pill sa tabi ng Close para sa full-screen na app), o pinipili ang Publish This App… mula sa desktop menu (ang File menu sa macOS habang nasa harap ang isang app window; ang App menu ng app window sa Windows at Linux). Gumagawa ang empleyado ng draft ng listing mula sa app, kumukuha ng 3 hanggang 5 screenshot, at ipinapakita ang listing sa chat para hubugin sa pamamagitan ng pag-uusap. Walang ipinapadala hangga’t hindi sumasagot ang may-ari ng Submit for review sa card, sa tap man o sa boses.

Laging may developer tools para sa sarili nito ang app na ginawa ng may-ari: reload, status, console, screenshot at pag-publish. Pinapayagan ng App Developer mode (Bot settings, Developer) ang ibang empleyado na magtrabaho sa alinman sa mga app ng may-ari, nagdadagdag ng lumulutang na console sa pahina, at pinapatay ang caching. Hindi kailanman nagkakaroon ng developer tools o Publish button ang mga app na in-install mula sa marketplace.

Mag-publish ng app nang mag-isa

Ang app na pahina lang ay nagpa-publish bilang iisang bundle gamit ang agent tool. Dapat nakasaad sa frontmatter ng AGENT.md ang artifact_type: app, kung hindi ay gagawa ang marketplace ng simpleng empleyado na walang pahina. Lagyan ng quote ang anumang value na may colon na sinusundan ng space; kapag walang quote, hindi mababasa ang frontmatter at tahimik na magiging simpleng empleyado ang app.

---
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")
Sa zipAno ang nangyayari
AGENT.mdAng persona at ang manifest ng listing.
agent.jsonAng configuration ng empleyado. Ayos lang ang {}.
manifest.jsonPinapanatili bilang manifest ng app: nakakarating sa naka-install na app ang window at mga pahintulot. Dapat balidong JSON.
ui/Ang pahina. Pinapayagan: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, mga larawan (png, jpg, gif, svg, webp, avif, ico, bmp), mga font (woff, woff2, ttf, otf), tunog (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Inaalis ang mga dot file at node_modules/.
skills/<name>/Ang sariling mga skill ng empleyado, sinusuri gaya ng skill na in-upload nang mag-isa: pinapanatili ang SKILL.md, kahit anong uri sa scripts/ at bin/, at lahat ng iba pa ay nasa skill allowlist.
  • Mga limitasyon: 10 MB bawat file at 50 MB bawat bundle. Nilalaktawan ang file na lampas sa 10 MB (tingnan ang filesSkipped at uiFilesStored sa resulta); tinatanggihan ang bundle na lampas sa 50 MB.
  • Tumatagal nang 5 minuto ang upload token. Inaalis ang iisang top folder sa zip.
  • Para sa pribado o pang-channel lang na app, binubuo ulit agad ng bawat upload ang package na mai-install at sinasabihan ng Nebo ang mga bot na nag-install ng app. Agad na inilalagay ng online na bot ang binuong package; ginagawa ito ng offline na bot sa susunod na pagkonekta nito. Hindi mo kailangang itaas ang bersyon para dito, at pinapanatili ang settings, mga iskedyul at data ng may-ari para sa app. Pinapanatili ng mga public, unlisted at invite-only na app ang naaprubahan nilang package hanggang pumasa sa review ang bagong bersyon.
  • Sinusunod ng bagong bersyon ang setting ng bawat may-ari para sa awtomatikong update ng app. Naka-off ito maliban kung i-on ng may-ari, kaya bilang default ay ipinapakita ng bot ang "Update available" at ina-apply ito ng may-ari mula sa Settings, pagkatapos Updates, o mula sa Inbox. Hindi kailanman nagbibigay ng bagong pahintulot ang isang update; hinihingi ang pahintulot na idinagdag ng bagong bersyon kapag unang kailanganin ito ng app.
  • Kung bawiin ng NeboAI ang isang app mula sa marketplace, pinapatay ito ng bawat bot na nag-install nito at sinasabihan ang may-ari. Walang dine-delete: pinapanatili ang lahat ng na-save ng app.
  • Ang app na may sidecar ay nag-a-upload ng binary ng bawat platform gamit ang binary-token sa halip, at ang pahina bilang ui archive. Tingnan ang App Sidecar at Pag-publish.