Pakken
En app er en ansattpakke med en manifest.json som merker 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". Gjør den ansatte til en app. Nebo leser også den eldre artifact_type. |
id | En UUID som lages når appen opprettes. Siden serveres på /apps/<id>/ui/. |
name, version | Den ansattes navn og pakkeversjonen. |
window | title, width, height, resizable, fullscreen, orientation. Standard: 1024 × 768, kan endre størrelse, ikke fullskjerm, stående, med tittel etter den ansatte. |
permissions | Hva siden kan gjøre. Standard ["storage:readwrite"]. |
Tillatelser
| Tillatelse | Gir |
|---|---|
storage:readwrite | Appens nøkkel-verdi-lager. |
subagent:<employee-id> | Spørre en annen ansatt fra siden. Appens egen ansatt trenger ingen tillatelse. |
network:<host> eller network:* | Forespørsler til eksterne verter gjennom Nebos proxy. |
device:motion | Gyroskopet og akselerometeret, bare for denne siden. På iPhone kaller siden også DeviceMotionEvent.requestPermission() fra et trykk. |
Hver tillatelse er prefix:scope. Be om det minste appen trenger.
Fullskjerm, retning og helning
Spill og filmer kan ta hele skjermen. Sett fullscreen og, for mobilappen, en orientation: portrait (standard), landscape eller any. Enhver annen retning avvises når manifestet skrives.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - På datamaskinen åpnes appen i et fullskjermvindu.
- I mobilappen er det ingen appfelt, systemfeltene er skjult, skjermen holdes våken og dra for å oppdatere er av. En liten Lukk-knapp sitter øverst i venstre hjørne og tones ut etter noen sekunder; et trykk nær toppen henter den tilbake. Kantsveipet i iOS er av, og tilbakeknappen på Android går gjennom sidens historikk før den lukker.
- Legg til marg på siden med
env(safe-area-inset-*)ogviewport-fit=cover, og hold kontrollene unna øverste venstre hjørne.
Talekontrollen
Hver app som åpnes i Nebo-appen på datamaskinen eller i mobilappen, viser en liten talekontroll nederst i høyre hjørne, så eieren kan snakke med appens ansatt mens den jobber på siden. Kontrollen ligger utenfor siden din, så å laste siden på nytt bryter aldri samtalen.
- På datamaskinen er det et felt på omtrent 300 ganger 48 piksler, 16 piksler inn fra vinduets nederste høyre hjørne.
- I mobilappen er det en rund knapp på 48 punkter innenfor det trygge området, som eieren kan dra til begge sider. I en fullskjermapp foldes den tilbake til den knappen noen sekunder ut i en samtale.
- Hold viktige kontroller unna nederste høyre hjørne.
- Under en lang oppgave i en samtale sier den ansatte korte oppdateringer som «Redigerer nå.» og leser aldri opp filnavn eller kommandoer.
Opprett en app
En ansatt kan bygge en app på to måter, og velger ut fra hva eieren sier. «Lag en app for bestillingene mine» lager en ny appansatt. «Du er appen» eller «lag deg et spill» gjør den ansatte eieren snakker med, om til appen: den beholder chatten, minnet og personaen, og siden lastes inn på nytt mens eieren snakker med den. Dette fungerer også for en ansatt som er ansatt i en samtale. Når det ikke er klart hva eieren mener, spør den ansatte én gang.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Hverdagsverktøy (en oversikt, et skjema, et lite dashbord) bygges med Nebos innebygde appferdighet. En side som skal se designet ut i stedet for generert, som en filmatisk landingsside, en scrollstyrt film, generert kunst eller et spill, bygges med App Studio-ferdigheten fra markedsplassen.
For en ny app er det enkleste å spørre en ansatt. Nebo har en innebygd ferdighet for å bygge apper, og den ansatte bruker create_employee, som skriver mappen, manifestet, personaen og siden i ett kall. Appen vises i eierens arbeidsstyrke i løpet av 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 tar de samme argumentene ui, app og agent_md. En sti i ui erstatter den ene filen. Siden leses fra disken ved hver forespørsel, så å laste vinduet på nytt viser endringen.
En minimal side
Denne siden laster SDK-en, spør hvem den ansatte er, og skriver ut svaret. Hvis den viser den ansattes ID og navn, er koblingen riktig.
<!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-en finner app-ID-en fra sidens adresse. En side som serveres fra et annet sted, trenger <meta name="nebo-app-id" content="<id>">. Hold tilstanden i appens lagring, ikke på siden: vinduet lukkes, og lagringen overlever.
Slik serveres siden
- Nebo serverer
ui/på/apps/<id>/ui/og åpner den i sitt eget vindu. - En sti uten samsvarende fil faller tilbake til
index.html, så ruting på klientsiden fungerer. - HTML-sider får metataggene
nebo-app-idognebo-base-url. - Hver fil sendes med sin faktiske innholdstype, inkludert video, lyd, skrifter,
wasmog 3D-modeller (glb,gltf). En fil med ukjent filendelse sendes somapplication/octet-stream, og nettleseren vil ikke bruke den. - Filer svarer på områdeforespørsler (
206, eller416for et område forbi slutten), så det går an å spole i video og lyd. I mobilappen spilles video av på stedet uten et trykk:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - En fil der navnet har en innholdshash, som
main-0a8ksftt.js, hurtigbufres i et år. Alt annet, ogsåindex.html, sjekkes ved hver åpning og svarer304når det er uendret. Bygg med hashede navn i stedet for å gi filer nye navn for hånd. - Hver sidefil kan være maks 10 MB.
- Sletter du mappen, deaktiveres den ansatte;
delete_employeefjerner den helt.
Legg til en sidecar
Når siden trenger serverlogikk, egne data eller verktøy den ansatte kan kalle, legger du til en sidecar: en binærfil Nebo kjører ved siden av appen. Siden når den med neboFetch og en relativ sti. Se App-sidecar.
Publiser fra Nebo
En app eieren har laget, kan publisere seg selv. Eieren sier «publiser deg selv», eller trykker på Publiser i appens chat, på appens skjerm i mobilappen (i toppfeltet, eller som en knapp ved siden av Lukk for en fullskjermapp), eller velger Publiser denne appen … fra menyen på datamaskinen (Fil-menyen på macOS mens et appvindu er foran; App-menyen i appvinduet på Windows og Linux). Den ansatte lager et utkast til oppføringen fra appen, tar 3 til 5 skjermbilder og viser oppføringen i chatten, så den kan formes ved å snakke. Ingenting sendes før eieren svarer Send inn til gjennomgang på kortet, med et trykk eller med stemmen.
En app eieren har laget, har alltid utviklerverktøyene sine for seg selv: last på nytt, status, konsoll, skjermbilder og publisering. Apputviklermodus (Botinnstillinger, Utvikler) lar andre ansatte jobbe med alle eierens apper, legger til en flytende konsoll på siden og slår av hurtigbufring. Apper installert fra markedsplassen får aldri utviklerverktøy eller en Publiser-knapp.
Publiser en app selv
En app som bare er en side, publiseres som én pakke med verktøyet agent. Frontmatter i AGENT.md må si artifact_type: app, ellers oppretter markedsplassen en vanlig ansatt uten side. Sett anførselstegn rundt alle verdier som inneholder et kolon etterfulgt av et mellomrom; uten anførselstegn kan ikke frontmatter leses, og appen blir i stillhet en vanlig ansatt.
--- 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 | Hva som skjer |
|---|---|
AGENT.md | Personaen og oppføringens manifest. |
agent.json | Den ansattes konfigurasjon. {} er greit. |
manifest.json | Beholdes som appens manifest: vindu og tillatelser når den installerte appen. Må være gyldig JSON. |
ui/ | Siden. Tillatt: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, bilder (png, jpg, gif, svg, webp, avif, ico, bmp), skrifter (woff, woff2, ttf, otf), lyd (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Punktfiler og node_modules/ utelates. |
skills/<name>/ | Den ansattes egne ferdigheter, sjekket som en ferdighet lastet opp alene: SKILL.md beholdes, scripts/ og bin/ alle typer, alt annet etter ferdighetens tillatelsesliste. |
- Grenser: 10 MB per fil og 50 MB per pakke. En fil over 10 MB hoppes over (sjekk
filesSkippedoguiFilesStoredi resultatet); en pakke over 50 MB avvises. - Opplastingstokenet varer i 5 minutter. En enkelt toppmappe i zip-filen fjernes.
- For en privat app eller en app bare for kanaler bygger hver opplasting den installerbare pakken på nytt med en gang, og Nebo varsler botene som har installert appen. En bot som er tilkoblet, tar i bruk den nye pakken med en gang; en som er frakoblet, gjør det neste gang den kobler til. Du trenger ikke øke versjonen for dette, og eierens innstillinger, tidsplaner og data for appen beholdes. Offentlige, ulistede og apper kun for inviterte beholder den godkjente pakken til en ny versjon består gjennomgangen.
- En ny versjon følger hver eiers innstilling for automatiske oppdateringer for appen. Den er av med mindre eieren slår den på, så som standard viser boten «Oppdatering tilgjengelig», og eieren tar den i bruk fra Innstillinger, deretter Oppdateringer, eller fra innboksen. En oppdatering gir aldri nye tillatelser; en tillatelse den nye versjonen legger til, blir spurt om når appen først trenger den.
- Hvis NeboAI trekker en app fra markedsplassen, slår hver bot som har installert den, den av og varsler eieren. Ingenting slettes: alt appen har lagret, beholdes.
- En app med en sidecar laster i stedet opp hver plattforms binærfil med
binary-token, og siden som etui-arkiv. Se App-sidecar og Publisering.