Balíček
Aplikace je balíček zaměstnance s manifest.json, který ho označuje jako aplikaci, a se složkou ui/ se stránkou.
<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"]
} | Pole | Význam |
|---|---|
type | "app". Udělá ze zaměstnance aplikaci. Nebo čte i starší artifact_type. |
id | UUID vytvořené při vzniku aplikace. Stránka se obsluhuje na /apps/<id>/ui/. |
name, version | Jméno zaměstnance a verze balíčku. |
window | title, width, height, resizable, fullscreen, orientation. Výchozí: 1024 × 768, měnitelná velikost, ne přes celou obrazovku, na výšku, s názvem podle zaměstnance. |
permissions | Co stránka smí dělat. Výchozí ["storage:readwrite"]. |
Oprávnění
| Oprávnění | Uděluje |
|---|---|
storage:readwrite | Úložiště klíč-hodnota aplikace. |
subagent:<employee-id> | Dotazy na jiného zaměstnance ze stránky. Vlastní zaměstnanec aplikace žádné oprávnění nepotřebuje. |
network:<host> nebo network:* | Požadavky na externí hostitele přes proxy Nebo. |
device:motion | Gyroskop a akcelerometr jen pro tuto stránku. Na iPhonu stránka navíc volá DeviceMotionEvent.requestPermission() po klepnutí. |
Každé oprávnění má tvar prefix:scope. Žádejte jen o to nejnutnější, co aplikace potřebuje.
Celá obrazovka, orientace a náklon
Hry a filmy mohou zabrat celou obrazovku. Nastavte fullscreen a pro mobilní aplikaci orientation: portrait (výchozí), landscape nebo any. Jakákoli jiná orientace se při zápisu manifestu odmítne.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Na počítači se aplikace otevře v okně přes celou obrazovku.
- V mobilní aplikaci není lišta aplikace, systémové lišty jsou skryté, obrazovka nezhasíná a obnovení stažením dolů je vypnuté. V levém horním rohu je malé tlačítko Zavřít, které po několika sekundách zmizí; dotyk u horního okraje ho vrátí. Přejetí od okraje v iOS je vypnuté a tlačítko Zpět v Androidu před zavřením prochází historii stránky.
- Odsaďte stránku pomocí
env(safe-area-inset-*)aviewport-fit=covera ovládací prvky držte mimo levý horní roh.
Hlasové ovládání
Každá aplikace otevřená v desktopové aplikaci Nebo nebo v mobilní aplikaci zobrazuje v pravém dolním rohu malé hlasové ovládání, aby vlastník mohl mluvit se zaměstnancem aplikace, zatímco ten pracuje na stránce. Ovládání je mimo vaši stránku, takže znovunačtení stránky hovor nikdy nepřeruší.
- Na počítači je to lišta asi 300 × 48 pixelů, 16 pixelů od pravého dolního rohu okna.
- V mobilní aplikaci je to kulaté tlačítko o velikosti 48 bodů uvnitř bezpečné oblasti, které může vlastník přetáhnout na kteroukoli stranu. V aplikaci přes celou obrazovku se po několika sekundách hovoru složí zpět do tohoto tlačítka.
- Důležité ovládací prvky držte mimo pravý dolní roh.
- Během dlouhého úkolu při hovoru zaměstnanec říká krátké novinky, například „Teď upravuji.“, a nikdy nečte nahlas názvy souborů ani příkazy.
Vytvoření aplikace
Zaměstnanec může vytvořit aplikaci dvěma způsoby a vybere podle toho, co vlastník řekne. „Vytvoř mi aplikaci na objednávky“ vytvoří nového zaměstnance aplikace. „Ty jsi ta aplikace“ nebo „vytvoř si hru“ promění zaměstnance, se kterým vlastník mluví, v aplikaci: ponechá si chat, paměť a personu a jeho stránka se znovu načítá, zatímco s ním vlastník mluví. Funguje to i u zaměstnance přijatého v konverzaci. Když není jasné, co vlastník myslí, zaměstnanec se jednou zeptá.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Běžné nástroje (sledovač, formulář, malá nástěnka) se vytvářejí vestavěnou dovedností Nebo pro aplikace. Stránka, která má vypadat navržená, ne vygenerovaná, například filmová úvodní stránka, film řízený posouváním, generované umění nebo hra, se vytváří dovedností App Studio z obchodu.
U nové aplikace je nejjednodušší požádat zaměstnance. Nebo obsahuje vestavěnou dovednost pro tvorbu aplikací a zaměstnanec použije create_employee, které jedním voláním zapíše složku, manifest, personu i stránku. Aplikace se v pracovním týmu vlastníka objeví během několika sekund.
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 přijímá stejné argumenty ui, app a agent_md. Cesta v ui nahradí ten jeden soubor. Stránka se čte z disku při každém požadavku, takže znovunačtení okna změnu ukáže.
Minimální stránka
Tato stránka načte SDK, zeptá se, kdo je její zaměstnanec, a vypíše odpověď. Pokud zobrazí ID a jméno zaměstnance, propojení je v pořádku.
<!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 zjistí ID aplikace z adresy stránky. Stránka obsluhovaná odjinud potřebuje <meta name="nebo-app-id" content="<id>">. Stav držte v úložišti aplikace, ne ve stránce: okno se zavře, úložiště zůstane.
Jak se stránka obsluhuje
- Nebo obsluhuje
ui/na/apps/<id>/ui/a otevírá ji ve vlastním okně. - Cesta bez odpovídajícího souboru se vrátí na
index.html, takže funguje směrování na straně klienta. - Stránky HTML dostávají meta značky
nebo-app-idanebo-base-url. - Každý soubor se odesílá se svým skutečným typem obsahu, včetně videa, zvuku, písem,
wasma 3D modelů (glb,gltf). Soubor s neznámou příponou se odešle jakoapplication/octet-streama prohlížeč ho nepoužije. - Soubory odpovídají na požadavky na rozsah (
206, nebo416pro rozsah za koncem), takže video a zvuk lze posouvat. V mobilní aplikaci se video přehraje na místě bez klepnutí:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Soubor, jehož název nese hash obsahu, například
main-0a8ksftt.js, se ukládá do mezipaměti na rok. Vše ostatní, včetněindex.html, se kontroluje při každém otevření a při nezměněném obsahu odpoví304. Sestavujte s hashovanými názvy, místo abyste soubory přejmenovávali ručně. - Každý soubor stránky může mít nejvýše 10 MB.
- Smazáním složky se zaměstnanec deaktivuje;
delete_employeeho odstraní úplně.
Přidání sidecaru
Když stránka potřebuje serverovou logiku, vlastní data nebo nástroje, které může zaměstnanec volat, přidejte sidecar: binární soubor, který Nebo spouští vedle aplikace. Stránka se k němu dostane pomocí neboFetch a relativní cesty. Viz Sidecar aplikace.
Publikování z Nebo
Aplikace, kterou vlastník vytvořil, se může publikovat sama. Vlastník řekne „publikuj se“, nebo klepne na Publish v chatu aplikace či na obrazovce aplikace v mobilní aplikaci (v horní liště, nebo u aplikace přes celou obrazovku jako tlačítko vedle Zavřít), nebo zvolí Publish This App… v nabídce na počítači (v nabídce File na macOS, když je okno aplikace vpředu; v nabídce App okna aplikace ve Windows a Linuxu). Zaměstnanec z aplikace připraví popis položky, pořídí 3 až 5 snímků obrazovky a ukáže popis v chatu, kde ho lze upravovat mluvením. Nic se neodešle, dokud vlastník na kartě neodpoví Submit for review, klepnutím nebo hlasem.
Aplikace, kterou vlastník vytvořil, má vždy své vývojářské nástroje pro sebe: znovunačtení, stav, konzoli, snímky obrazovky a publikování. Režim App Developer (Nastavení bota, Vývojář) umožňuje ostatním zaměstnancům pracovat na kterékoli aplikaci vlastníka, přidá na stránku plovoucí konzoli a vypne ukládání do mezipaměti. Aplikace nainstalované z obchodu nikdy nedostanou vývojářské nástroje ani tlačítko Publish.
Publikujte aplikaci sami
Aplikace jen se stránkou se publikuje jako jeden balík pomocí nástroje agent. Úvodní blok AGENT.md musí uvádět artifact_type: app, jinak obchod vytvoří obyčejného zaměstnance bez stránky. Každou hodnotu, která obsahuje dvojtečku následovanou mezerou, uzavřete do uvozovek; bez uvozovek nelze úvodní blok přečíst a aplikace se tiše stane obyčejným zaměstnancem.
--- 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") | V souboru zip | Co se stane |
|---|---|
AGENT.md | Persona a manifest položky. |
agent.json | Konfigurace zaměstnance. {} stačí. |
manifest.json | Ponechá se jako manifest aplikace: okno a oprávnění se dostanou do nainstalované aplikace. Musí být platný JSON. |
ui/ | Stránka. Povoleno: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, obrázky (png, jpg, gif, svg, webp, avif, ico, bmp), písma (woff, woff2, ttf, otf), zvuk (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Soubory začínající tečkou a node_modules/ se zahodí. |
skills/<name>/ | Vlastní dovednosti zaměstnance, kontrolované jako samostatně nahraná dovednost: SKILL.md se ponechá, scripts/ a bin/ mohou obsahovat jakýkoli typ, vše ostatní musí být na seznamu povolených pro dovednosti. |
- Limity: 10 MB na soubor a 50 MB na balík. Soubor nad 10 MB se přeskočí (zkontrolujte
filesSkippedauiFilesStoredve výsledku); balík nad 50 MB se odmítne. - Token pro nahrání platí 5 minut. Jediná složka nejvyšší úrovně v zipu se odstraní.
- U soukromé aplikace nebo aplikace jen pro kanály každé nahrání okamžitě znovu sestaví instalační balíček a Nebo o tom informuje boty, kteří aplikaci nainstalovali. Bot, který je online, nový balíček nasadí hned; bot, který je offline, to udělá při příštím připojení. Kvůli tomu nemusíte zvyšovat verzi a nastavení, plány a data vlastníka pro aplikaci se zachovají. Veřejné, neveřejné aplikace a aplikace jen na pozvánku si ponechávají schválený balíček, dokud nová verze neprojde kontrolou.
- Nová verze se řídí nastavením automatických aktualizací, které má každý vlastník pro danou aplikaci. To je vypnuté, dokud ho vlastník nezapne, takže ve výchozím stavu bot zobrazí „Update available“ a vlastník aktualizaci použije v Nastavení, části Aktualizace, nebo z Doručených. Aktualizace nikdy neuděluje nová oprávnění; o oprávnění, které nová verze přidá, se požádá, až ho aplikace poprvé bude potřebovat.
- Pokud NeboAI aplikaci z obchodu stáhne, každý bot, který ji nainstaloval, ji vypne a informuje vlastníka. Nic se nesmaže: vše, co aplikace uložila, zůstane zachováno.
- Aplikace se sidecarem místo toho nahrává binární soubor pro každou platformu pomocí
binary-tokena stránku jako archivui. Viz Sidecar aplikace a Publikování.