Pakken
En app er en medarbejderpakke med en manifest.json, der markerer den som en app, og en ui/-mappe med siden.
<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"]
} | Felt | Betydning |
|---|---|
type | "app". Gør medarbejderen til en app. Nebo læser også det ældre artifact_type. |
id | Et UUID, der dannes, når appen oprettes. Siden serveres på /apps/<id>/ui/. |
name, version | Medarbejderens navn og pakkens version. |
window | title, width, height, resizable, fullscreen, orientation. Standarder: 1024 × 768, kan ændre størrelse, ikke fuld skærm, stående, med titel efter medarbejderen. |
permissions | Hvad siden må gøre. Standard ["storage:readwrite"]. |
Tilladelser
| Tilladelse | Giver |
|---|---|
storage:readwrite | Appens nøgle-værdi-lager. |
subagent:<employee-id> | At spørge en anden medarbejder fra siden. Appens egen medarbejder kræver ingen tilladelse. |
network:<host> eller network:* | Anmodninger til eksterne værter gennem Nebos proxy. |
device:motion | Gyroskopet og accelerometeret kun for denne side. På iPhone kalder siden også DeviceMotionEvent.requestPermission() fra et tryk. |
Hver tilladelse er prefix:scope. Bed om det mindste, appen har brug for.
Fuld skærm, retning og hældning
Spil og film kan fylde hele skærmen. Angiv fullscreen og, til mobilappen, en orientation: portrait (standard), landscape eller any. Enhver anden retning afvises, når manifestet skrives.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - På computeren åbner appen i et vindue i fuld skærm.
- I mobilappen er der ingen appbjælke, systembjælkerne er skjult, skærmen forbliver tændt, og træk for at opdatere er slået fra. En lille Luk-knap sidder i øverste venstre hjørne og toner ud efter et par sekunder; et tryk nær toppen henter den tilbage. Kantswipe på iOS er slået fra, og Androids tilbage-knap går gennem sidens historik, før den lukker.
- Giv siden polstring med
env(safe-area-inset-*)ogviewport-fit=cover, og hold knapper væk fra øverste venstre hjørne.
Stemmeknappen
Hver app, der åbnes i Nebos computerapp eller i mobilappen, viser en lille stemmeknap i nederste højre hjørne, så ejeren kan tale med appens medarbejder, mens den arbejder på siden. Knappen sidder uden for din side, så genindlæsning af siden afbryder aldrig opkaldet.
- På computeren er det en bjælke på cirka 300 gange 48 pixels, 16 pixels inde fra vinduets nederste højre hjørne.
- I mobilappen er det en rund knap på 48 punkter inden for det sikre område, som ejeren kan trække til begge sider. I en app i fuld skærm folder den sig tilbage til den knap et par sekunder inde i et opkald.
- Hold vigtige knapper væk fra nederste højre hjørne.
- Under en lang opgave i et opkald siger medarbejderen korte opdateringer som “Redigerer nu.” og læser aldrig filnavne eller kommandoer op.
Opret en app
En medarbejder kan bygge en app på to måder og vælger ud fra, hvad ejeren siger. “Byg mig en app til mine ordrer” laver en ny appmedarbejder. “Du er appen” eller “byg dig selv et spil” gør den medarbejder, ejeren taler med, til appen: den beholder sin chat, hukommelse og persona, og dens side genindlæses, mens ejeren taler med den. Det virker også for en medarbejder, der er ansat i samtalen. Når det ikke er klart, hvad ejeren mener, spørger medarbejderen én gang.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Hverdagsværktøjer (en tracker, en formular, et lille dashboard) bygges med Nebos indbyggede app-færdighed. En side, der skal se designet ud frem for genereret, f.eks. en filmisk landingsside, en scrolldrevet film, genereret kunst eller et spil, bygges med App Studio-færdigheden fra markedspladsen.
For en ny app er den enkleste måde at spørge en medarbejder. Nebo har en indbygget færdighed til at bygge apps, og medarbejderen bruger create_employee, som skriver mappen, manifestet, personaen og siden i ét kald. Appen vises i ejerens arbejdsstyrke inden for få sekunder.
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 tager de samme argumenter ui, app og agent_md. En sti i ui erstatter netop den fil. Siden læses fra disken ved hver anmodning, så når vinduet genindlæses, vises ændringen.
En minimal side
Denne side indlæser SDK'et, spørger, hvem dens medarbejder er, og skriver svaret ud. Hvis den viser medarbejderens id og navn, er forbindelsen i orden.
<!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'et finder app-id'et ud fra sidens adresse. En side, der serveres fra et andet sted, kræver <meta name="nebo-app-id" content="<id>">. Gem tilstand i appens storage, ikke på siden: vinduet lukker, og storage overlever.
Sådan serveres siden
- Nebo serverer
ui/på/apps/<id>/ui/og åbner den i sit eget vindue. - En sti uden en matchende fil falder tilbage til
index.html, så routing på klientsiden virker. - HTML-sider får metatags med
nebo-app-idognebo-base-url. - Hver fil sendes med sin rigtige indholdstype, herunder video, lyd, skrifttyper,
wasmog 3D-modeller (glb,gltf). En fil med en ukendt filendelse sendes somapplication/octet-stream, og browseren vil ikke bruge den. - Filer besvarer range-forespørgsler (
206, eller416for et interval forbi slutningen), så video og lyd kan spoles. I mobilappen afspilles video på stedet uden et tryk:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - En fil, hvis navn indeholder et indholdshash, f.eks.
main-0a8ksftt.js, caches i et år. Alt andet, ogsåindex.html, tjekkes ved hver åbning og svarer304, når det er uændret. Byg med hashede navne frem for at omdøbe filer i hånden. - Hver sidefil må højst være 10 MB.
- Hvis du sletter mappen, deaktiveres medarbejderen;
delete_employeefjerner den helt.
Tilføj en sidecar
Når siden har brug for serverlogik, egne data eller værktøjer, medarbejderen kan kalde, så tilføj en sidecar: en binær, som Nebo kører ved siden af appen. Siden når den med neboFetch og en relativ sti. Se App-sidecar.
Udgiv fra Nebo
En app, som ejeren har lavet, kan udgive sig selv. Ejeren siger “udgiv dig selv”, eller trykker på Udgiv i appens chat, på appens skærm i mobilappen (i den øverste bjælke, eller som en knap ved siden af Luk i en app i fuld skærm), eller vælger Udgiv denne app… i computerens menu (menuen Arkiv på macOS, mens et appvindue er forrest; appvinduets menu App på Windows og Linux). Medarbejderen skriver et udkast til oversigten ud fra appen, tager 3 til 5 skærmbilleder og viser oversigten i chatten, så den kan formes ved at tale. Intet sendes, før ejeren svarer Indsend til gennemgang på kortet, med et tryk eller med stemmen.
En app, som ejeren har lavet, har altid sine udviklerværktøjer til sig selv: genindlæsning, status, konsol, skærmbilleder og udgivelse. Tilstanden App-udvikler (Botindstillinger, Udvikler) lader andre medarbejdere arbejde på alle ejerens apps, tilføjer en flydende konsol til siden og slår caching fra. Apps, der er installeret fra markedspladsen, får aldrig udviklerværktøjer eller en Udgiv-knap.
Udgiv en app selv
En app, der kun består af en side, udgives som én pakke med værktøjet agent. Frontmatter i AGENT.md skal sige artifact_type: app, ellers opretter markedspladsen en almindelig medarbejder uden side. Sæt anførselstegn om enhver værdi, der indeholder et kolon efterfulgt af et mellemrum; uden anførselstegn kan frontmatter ikke læses, og appen bliver i al stilhed en almindelig medarbejder.
--- 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") | I zip-filen | Hvad der sker |
|---|---|
AGENT.md | Personaen og oversigtens manifest. |
agent.json | Medarbejderens konfiguration. {} er fint. |
manifest.json | Bevares som appens manifest: vindue og tilladelser når frem til den installerede app. Skal være gyldig JSON. |
ui/ | Siden. Tilladt: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, billeder (png, jpg, gif, svg, webp, avif, ico, bmp), skrifttyper (woff, woff2, ttf, otf), lyd (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Punktumfiler og node_modules/ udelades. |
skills/<name>/ | Medarbejderens egne færdigheder, tjekket som en færdighed, der uploades for sig selv: SKILL.md bevares, scripts/ og bin/ enhver type, alt andet efter færdighedernes godkendte liste. |
- Grænser: 10 MB pr. fil og 50 MB pr. pakke. En fil over 10 MB springes over (tjek
filesSkippedoguiFilesStoredi resultatet); en pakke over 50 MB afvises. - Upload-tokenet varer 5 minutter. En enkelt øverste mappe i zip-filen fjernes.
- For en privat app eller en app kun til kanaler genopbygger hver upload den installérbare pakke med det samme, og Nebo giver besked til de bots, der har installeret appen. En bot, der er online, sætter den genopbyggede pakke på plads med det samme; en, der er offline, gør det, næste gang den forbinder. Du behøver ikke at hæve versionen for det, og ejerens indstillinger, tidsplaner og data for appen bevares. Offentlige, ikke listede og apps kun for inviterede beholder deres godkendte pakke, indtil en ny version består gennemgangen.
- En ny version følger hver ejers indstilling for automatiske opdateringer af appen. Den er slået fra, medmindre ejeren slår den til, så som standard viser botten "Opdatering tilgængelig", og ejeren installerer den fra Indstillinger og derefter Opdateringer, eller fra Indbakken. En opdatering giver aldrig nye tilladelser; en tilladelse, som den nye version tilføjer, bliver der spurgt om, første gang appen har brug for den.
- Hvis NeboAI trækker en app tilbage fra markedspladsen, slår hver bot, der har installeret den, den fra og giver ejeren besked. Intet slettes: alt, hvad appen har gemt, bevares.
- En app med en sidecar uploader i stedet hver platforms binær med
binary-tokenog siden som etui-arkiv. Se App-sidecar og Udgivelse.