NeboAI
NeboAI
Aan de slag

Apps

Een app is een medewerker met een pagina. Eigenaren openen hem in een eigen venster om iets direct te zien en ermee te werken: een bord, een tracker, een formulier. De pagina is gewone HTML en JavaScript, en praat met Nebo en met zijn medewerker via één script: de App SDK.

Het pakket

Een app is een medewerkerspakket met een manifest.json die het als app markeert en een map ui/ met de pagina.

<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"]
}
VeldBetekenis
type"app". Maakt van de medewerker een app. Nebo leest ook het oudere artifact_type.
idEen UUID die wordt aangemaakt als de app wordt gemaakt. De pagina wordt geserveerd op /apps/<id>/ui/.
name, versionDe naam van de medewerker en de versie van het pakket.
windowtitle, width, height, resizable, fullscreen, orientation. Standaard: 1024 × 768, aanpasbaar formaat, niet schermvullend, staand, met de naam van de medewerker als titel.
permissionsWat de pagina mag doen. Standaard ["storage:readwrite"].

Machtigingen

MachtigingGeeft toegang tot
storage:readwriteDe key-value-opslag van de app.
subagent:<employee-id>Vanaf de pagina iets vragen aan een andere medewerker. De eigen medewerker van de app heeft geen machtiging nodig.
network:<host> of network:*Verzoeken naar externe hosts via de proxy van Nebo.
device:motionDe gyroscoop en versnellingsmeter, alleen voor deze pagina. Op iPhone roept de pagina ook DeviceMotionEvent.requestPermission() aan na een tik.

Elke machtiging is prefix:scope. Vraag om het minimum dat de app nodig heeft.

Schermvullend, oriëntatie en kantelen

Games en films kunnen het hele scherm gebruiken. Stel fullscreen in en, voor de mobiele app, een orientation: portrait (de standaard), landscape of any. Elke andere oriëntatie wordt geweigerd wanneer het manifest wordt geschreven.

{
  "type": "app",
  "permissions": ["storage:readwrite", "device:motion"],
  "window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
}
  • Op de desktop opent de app in een schermvullend venster.
  • In de mobiele app is er geen app-balk, zijn de systeembalken verborgen, blijft het scherm aan en staat omlaag trekken om te vernieuwen uit. Een kleine Sluiten-knop staat linksboven en vervaagt na een paar seconden; een aanraking bij de bovenkant brengt hem terug. De randveeg van iOS staat uit, en de terugknop van Android loopt eerst door de geschiedenis van de pagina voordat hij sluit.
  • Geef de pagina opvulling met env(safe-area-inset-*) en viewport-fit=cover, en houd bedieningselementen weg uit de linkerbovenhoek.

De spraakbediening

Elke app die wordt geopend in de Nebo-desktopapp of in de mobiele app toont rechtsonder een kleine spraakbediening, zodat de eigenaar met de medewerker van de app kan praten terwijl die aan de pagina werkt. De bediening staat buiten je pagina, dus de pagina opnieuw laden verbreekt het gesprek nooit.

  • Op de desktop is het een balk van ongeveer 300 bij 48 pixels, 16 pixels vanaf de rechteronderhoek van het venster.
  • In de mobiele app is het een ronde knop van 48 punten binnen het veilige gebied, die de eigenaar naar beide kanten kan slepen. In een schermvullende app klapt hij een paar seconden na het begin van een gesprek weer in tot die knop.
  • Houd belangrijke bedieningselementen weg uit de rechteronderhoek.
  • Tijdens een lange taak in een gesprek geeft de medewerker korte updates zoals “Nu aan het bewerken.” en leest hij nooit bestandsnamen of opdrachten voor.

Een app maken

Een medewerker kan op twee manieren een app bouwen en kiest op basis van wat de eigenaar zegt. “Bouw een app voor mijn bestellingen” maakt een nieuwe app-medewerker. “Jij bent de app” of “bouw jezelf een game” maakt van de medewerker met wie de eigenaar praat de app: hij houdt zijn chat, geheugen en persona, en zijn pagina laadt opnieuw terwijl de eigenaar met hem praat. Dit werkt ook voor een medewerker die in een gesprek is aangenomen. Als niet duidelijk is wat de eigenaar bedoelt, vraagt de medewerker het één keer.

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

Alledaagse tools (een tracker, een formulier, een klein dashboard) worden gebouwd met de ingebouwde app-skill van Nebo. Een pagina die ontworpen moet ogen in plaats van gegenereerd, zoals een filmische landingspagina, een film die met scrollen meebeweegt, gegenereerde kunst of een game, wordt gebouwd met de App Studio-skill van de marktplaats.

Voor een nieuwe app is de eenvoudigste manier om het een medewerker te vragen. Nebo heeft een ingebouwde skill voor het bouwen van apps, en de medewerker gebruikt create_employee, dat de map, het manifest, de persona en de pagina in één aanroep schrijft. De app verschijnt binnen enkele seconden in het personeel van de eigenaar.

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 neemt dezelfde argumenten ui, app en agent_md. Een pad in ui vervangt alleen dat ene bestand. De pagina wordt bij elk verzoek van schijf gelezen, dus het venster opnieuw laden toont de wijziging.

Een minimale pagina

Deze pagina laadt de SDK, vraagt wie zijn medewerker is en toont het antwoord. Toont hij de id en naam van de medewerker, dan is alles goed aangesloten.

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

De SDK haalt de app-id uit het adres van de pagina. Een pagina die ergens anders vandaan wordt geserveerd, heeft <meta name="nebo-app-id" content="<id>"> nodig. Bewaar de status in de opslag van de app, niet in de pagina: het venster gaat dicht, maar de opslag blijft.

Hoe de pagina wordt geserveerd

  • Nebo serveert ui/ op /apps/<id>/ui/ en opent die in een eigen venster.
  • Een pad zonder bijpassend bestand valt terug op index.html, zodat routering aan de clientkant werkt.
  • HTML-pagina's krijgen de metatags nebo-app-id en nebo-base-url.
  • Elk bestand gaat de deur uit met zijn echte contenttype, ook video, geluid, lettertypen, wasm en 3D-modellen (glb, gltf). Een bestand met een onbekende extensie wordt verstuurd als application/octet-stream en de browser gebruikt het niet.
  • Bestanden beantwoorden range-verzoeken (206, of 416 voor een bereik voorbij het einde), zodat je in video en geluid kunt spoelen. In de mobiele app speelt video ter plekke af zonder te tikken: <video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video>
  • Een bestand met een content-hash in de naam, zoals main-0a8ksftt.js, wordt een jaar lang gecachet. Al het andere, index.html inbegrepen, wordt bij elke keer openen gecontroleerd en antwoordt 304 als het niet is veranderd. Bouw met gehashte namen in plaats van bestanden met de hand te hernoemen.
  • Elk paginabestand mag maximaal 10 MB zijn.
  • Als je de map verwijdert, wordt de medewerker gedeactiveerd; delete_employee verwijdert hem volledig.

Een sidecar toevoegen

Als de pagina serverlogica, eigen data of tools nodig heeft die de medewerker kan aanroepen, voeg dan een sidecar toe: een binary die Nebo naast de app draait. De pagina bereikt hem met neboFetch en een relatief pad. Zie App-sidecar.

Publiceren vanuit Nebo

Een app die de eigenaar heeft gemaakt, kan zichzelf publiceren. De eigenaar zegt “publiceer jezelf”, of tikt op Publiceren in de chat van de app, op het scherm van de app in de mobiele app (in de bovenbalk, of als knop naast Sluiten bij een schermvullende app), of kiest Deze app publiceren… in het menu van de desktop (het menu Archief op macOS als een app-venster vooraan staat; het menu App van het app-venster op Windows en Linux). De medewerker stelt de vermelding op vanuit de app, maakt 3 tot 5 schermafbeeldingen en toont de vermelding in de chat, zodat je hem pratend kunt bijschaven. Er wordt niets verstuurd totdat de eigenaar op de kaart antwoordt met Indienen ter beoordeling, met een tik of met zijn stem.

Een app die de eigenaar heeft gemaakt, heeft altijd zijn ontwikkelaarstools voor zichzelf: opnieuw laden, status, console, schermafbeeldingen en publiceren. De modus App-ontwikkelaar (Botinstellingen, Ontwikkelaar) laat andere medewerkers aan alle apps van de eigenaar werken, voegt een zwevende console aan de pagina toe en zet caching uit. Apps die van de marktplaats zijn geïnstalleerd, krijgen nooit ontwikkelaarstools of een Publiceren-knop.

Zelf een app publiceren

Een app met alleen een pagina wordt als één bundel gepubliceerd met de tool agent. De frontmatter van AGENT.md moet artifact_type: app bevatten, anders maakt de marktplaats een gewone medewerker zonder pagina. Zet elke waarde met een dubbele punt gevolgd door een spatie tussen aanhalingstekens; zonder aanhalingstekens kan de frontmatter niet worden gelezen en wordt de app stilletjes een gewone medewerker.

---
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")
In de zipWat er gebeurt
AGENT.mdDe persona en het manifest van de vermelding.
agent.jsonDe configuratie van de medewerker. {} is prima.
manifest.jsonBewaard als het manifest van de app: venster en machtigingen komen terecht in de geïnstalleerde app. Moet geldige JSON zijn.
ui/De pagina. Toegestaan: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, afbeeldingen (png, jpg, gif, svg, webp, avif, ico, bmp), lettertypen (woff, woff2, ttf, otf), geluid (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Bestanden die met een punt beginnen en node_modules/ worden weggelaten.
skills/<name>/De eigen skills van de medewerker, gecontroleerd zoals een skill die los wordt geüpload: SKILL.md blijft behouden, scripts/ en bin/ mogen elk type bevatten, al het andere moet op de toegestane lijst voor skills staan.
  • Limieten: 10 MB per bestand en 50 MB per bundel. Een bestand boven 10 MB wordt overgeslagen (controleer filesSkipped en uiFilesStored in het resultaat); een bundel boven 50 MB wordt geweigerd.
  • Het uploadtoken is 5 minuten geldig. Eén enkele bovenste map in de zip wordt verwijderd.
  • Bij een privéapp of een app alleen voor kanalen bouwt elke upload het installeerbare pakket direct opnieuw, en Nebo laat het de bots weten die de app hebben geïnstalleerd. Een bot die online is, zet het nieuwe pakket meteen op zijn plek; een bot die offline is, doet dat bij de volgende verbinding. Je hoeft de versie hiervoor niet te verhogen, en de instellingen, planningen en data van de eigenaar voor de app blijven bewaard. Openbare, niet-vermelde en alleen-op-uitnodiging-apps houden hun goedgekeurde pakket totdat een nieuwe versie door de beoordeling komt.
  • Een nieuwe versie volgt de instelling voor automatische updates die elke eigenaar voor de app heeft. Die staat uit tenzij de eigenaar hem aanzet, dus standaard toont de bot "Update beschikbaar" en installeert de eigenaar hem via Instellingen, dan Updates, of vanuit Postvak IN. Een update geeft nooit nieuwe machtigingen; om een machtiging die de nieuwe versie toevoegt, wordt gevraagd wanneer de app hem voor het eerst nodig heeft.
  • Als NeboAI een app van de marktplaats terugtrekt, zet elke bot die hem heeft geïnstalleerd hem uit en laat het de eigenaar weten. Er wordt niets verwijderd: alles wat de app heeft opgeslagen, blijft bewaard.
  • Een app met een sidecar uploadt in plaats daarvan de binary voor elk platform met binary-token, en de pagina als ui-archief. Zie App-sidecar en Publiceren.