Balík
Aplikácia je balík zamestnanca s manifest.json, ktorý ho označuje ako aplikáciu, a s priečinkom ui/ so 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". Urobí zo zamestnanca aplikáciu. Nebo číta aj staršie artifact_type. |
id | UUID vytvorené pri vzniku aplikácie. Stránka sa poskytuje na /apps/<id>/ui/. |
name, version | Meno zamestnanca a verzia balíka. |
window | title, width, height, resizable, fullscreen, orientation. Predvolené: 1024 × 768, meniteľná veľkosť, nie na celú obrazovku, na výšku, s názvom podľa zamestnanca. |
permissions | Čo stránka smie robiť. Predvolene ["storage:readwrite"]. |
Oprávnenia
| Oprávnenie | Udeľuje |
|---|---|
storage:readwrite | Úložisko kľúč-hodnota aplikácie. |
subagent:<employee-id> | Pýtanie sa iného zamestnanca zo stránky. Vlastný zamestnanec aplikácie nepotrebuje žiadne oprávnenie. |
network:<host> alebo network:* | Požiadavky na vonkajšie hostiteľské servery cez proxy Nebo. |
device:motion | Gyroskop a akcelerometer len pre túto stránku. Na iPhone stránka navyše volá DeviceMotionEvent.requestPermission() po ťuknutí. |
Každé oprávnenie má tvar prefix:scope. Žiadajte len minimum, ktoré aplikácia potrebuje.
Celá obrazovka, orientácia a náklon
Hry a filmy môžu zaberať celú obrazovku. Nastavte fullscreen a pre mobilnú aplikáciu orientation: portrait (predvolené), landscape alebo any. Akákoľvek iná orientácia sa pri zápise manifestu odmietne.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Na počítači sa aplikácia otvorí v okne na celú obrazovku.
- V mobilnej aplikácii nie je lišta aplikácie, systémové lišty sú skryté, obrazovka nezhasína a potiahnutie na obnovenie je vypnuté. V ľavom hornom rohu je malé tlačidlo Zavrieť, ktoré po pár sekundách zmizne; dotyk pri hornom okraji ho vráti. Potiahnutie od okraja v iOS je vypnuté a tlačidlo Späť v Androide pred zatvorením prechádza históriou stránky.
- Odsaďte stránku pomocou
env(safe-area-inset-*)aviewport-fit=covera ovládacie prvky držte mimo ľavého horného rohu.
Hlasové ovládanie
Každá aplikácia otvorená v počítačovej aplikácii Nebo alebo v mobilnej aplikácii zobrazuje v pravom dolnom rohu malé hlasové ovládanie, aby sa vlastník mohol rozprávať so zamestnancom aplikácie, kým pracuje na stránke. Ovládanie je mimo vašej stránky, takže opätovné načítanie stránky nikdy neukončí hovor.
- Na počítači je to lišta s rozmermi asi 300 × 48 pixelov, 16 pixelov od pravého dolného rohu okna.
- V mobilnej aplikácii je to okrúhle tlačidlo s veľkosťou 48 bodov v bezpečnej oblasti, ktoré môže vlastník presunúť na ktorúkoľvek stranu. V aplikácii na celú obrazovku sa pár sekúnd po začatí hovoru zbalí späť do tohto tlačidla.
- Dôležité ovládacie prvky držte mimo pravého dolného rohu.
- Počas dlhej úlohy pri hovore zamestnanec hovorí krátke informácie, napríklad „Teraz upravujem.“, a nikdy nečíta nahlas názvy súborov ani príkazy.
Vytvorenie aplikácie
Zamestnanec môže vytvoriť aplikáciu dvoma spôsobmi a vyberie si podľa toho, čo vlastník povie. „Vytvor mi aplikáciu na moje objednávky“ vytvorí nového zamestnanca aplikácie. „Ty si tá aplikácia“ alebo „vytvor si hru“ premení zamestnanca, s ktorým vlastník hovorí, na aplikáciu: ponechá si svoj chat, pamäť aj personu a jeho stránka sa znova načíta, kým s ním vlastník hovorí. Funguje to aj pre zamestnanca prijatého v konverzácii. Keď nie je jasné, čo vlastník myslí, zamestnanec sa raz opýta.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Bežné nástroje (sledovač, formulár, malý dashboard) sa vytvárajú pomocou vstavanej zručnosti Nebo na aplikácie. Stránka, ktorá má pôsobiť navrhnuto, a nie vygenerovane, napríklad filmová úvodná stránka, film riadený posúvaním, generované umenie alebo hra, sa vytvára pomocou zručnosti App Studio z obchodu.
Pri novej aplikácii je najjednoduchšie požiadať zamestnanca. Nebo obsahuje vstavanú zručnosť na tvorbu aplikácií a zamestnanec použije create_employee, ktorý jedným volaním zapíše priečinok, manifest, personu aj stránku. Aplikácia sa do niekoľkých sekúnd objaví medzi pracovníkmi vlastníka.
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 prijíma tie isté argumenty ui, app a agent_md. Cesta v ui nahradí ten jeden súbor. Stránka sa číta z disku pri každej požiadavke, takže opätovné načítanie okna zmenu ukáže.
Minimálna stránka
Táto stránka načíta SDK, opýta sa, kto je jej zamestnanec, a vypíše odpoveď. Ak zobrazí ID a meno zamestnanca, prepojenie je v poriadku.
<!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 zistí ID aplikácie z adresy stránky. Stránka poskytovaná odinakiaľ potrebuje <meta name="nebo-app-id" content="<id>">. Stav uchovávajte v úložisku aplikácie, nie na stránke: okno sa zatvorí, úložisko zostane.
Ako sa stránka poskytuje
- Nebo poskytuje
ui/na/apps/<id>/ui/a otvára ju vo vlastnom okne. - Cesta bez zodpovedajúceho súboru sa presmeruje na
index.html, takže smerovanie na strane klienta funguje. - Stránky HTML dostanú meta značky
nebo-app-idanebo-base-url. - Každý súbor sa odosiela so skutočným typom obsahu vrátane videa, zvuku, písiem,
wasma 3D modelov (glb,gltf). Súbor s neznámou príponou sa pošle akoapplication/octet-streama prehliadač ho nepoužije. - Súbory odpovedajú na požiadavky na rozsah (
206, alebo416pre rozsah za koncom), takže video a zvuk sa dajú posúvať. V mobilnej aplikácii sa video prehrá priamo na mieste bez ťuknutia:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Súbor, ktorého názov obsahuje hash obsahu, napríklad
main-0a8ksftt.js, sa ukladá do vyrovnávacej pamäte na rok. Všetko ostatné, vrátaneindex.html, sa kontroluje pri každom otvorení a ak sa nezmenilo, odpovie304. Zostavujte s hashovanými názvami namiesto ručného premenovávania súborov. - Každý súbor stránky môže mať najviac 10 MB.
- Odstránením priečinka sa zamestnanec deaktivuje;
delete_employeeho odstráni úplne.
Pridanie sidecaru
Keď stránka potrebuje serverovú logiku, vlastné dáta alebo nástroje, ktoré môže zamestnanec volať, pridajte sidecar: binárny súbor, ktorý Nebo spúšťa vedľa aplikácie. Stránka sa k nemu dostane pomocou neboFetch a relatívnej cesty. Pozri Sidecar aplikácie.
Publikovanie z Nebo
Aplikácia, ktorú vlastník vytvoril, sa môže publikovať sama. Vlastník povie „publikuj sa“ alebo ťukne na Publikovať v chate aplikácie, na obrazovke aplikácie v mobilnej aplikácii (v hornej lište alebo ako tlačidlo vedľa Zavrieť pri aplikácii na celú obrazovku), alebo v ponuke na počítači zvolí Publikovať túto aplikáciu… (na macOS v ponuke Súbor, keď je okno aplikácie v popredí; vo Windows a Linuxe v ponuke Aplikácia okna aplikácie). Zamestnanec pripraví zápis v obchode z aplikácie, urobí 3 až 5 snímok obrazovky a ukáže zápis v chate, kde ho môžete dotvárať rozhovorom. Nič sa neodošle, kým vlastník na karte neodpovie Odoslať na kontrolu, ťuknutím alebo hlasom.
Aplikácia, ktorú vlastník vytvoril, má pre seba vždy vývojárske nástroje: opätovné načítanie, stav, konzolu, snímky obrazovky a publikovanie. Režim vývojára aplikácií (Nastavenia bota, Vývojár) umožňuje iným zamestnancom pracovať na ktorejkoľvek aplikácii vlastníka, pridá na stránku plávajúcu konzolu a vypne vyrovnávaciu pamäť. Aplikácie nainštalované z obchodu nikdy nedostanú vývojárske nástroje ani tlačidlo Publikovať.
Publikovanie aplikácie vlastnými silami
Aplikácia len so stránkou sa publikuje ako jeden balík pomocou nástroja agent. Frontmatter AGENT.md musí obsahovať artifact_type: app, inak obchod vytvorí obyčajného zamestnanca bez stránky. Každú hodnotu, ktorá obsahuje dvojbodku nasledovanú medzerou, dajte do úvodzoviek; bez nich sa frontmatter nedá prečítať a z aplikácie sa potichu stane obyčajný zamestnanec.
--- 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 zipe | Čo sa stane |
|---|---|
AGENT.md | Persona a manifest zápisu v obchode. |
agent.json | Konfigurácia zamestnanca. {} stačí. |
manifest.json | Zachová sa ako manifest aplikácie: okno a oprávnenia sa prenesú do nainštalovanej aplikácie. Musí to byť platný JSON. |
ui/ | Stránka. Povolené: 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. Súbory začínajúce bodkou a node_modules/ sa vynechajú. |
skills/<name>/ | Vlastné zručnosti zamestnanca, kontrolované ako samostatne nahratá zručnosť: SKILL.md sa zachová, scripts/ a bin/ ľubovoľného typu, všetko ostatné podľa zoznamu povolených pre zručnosti. |
- Limity: 10 MB na súbor a 50 MB na balík. Súbor nad 10 MB sa preskočí (skontrolujte
filesSkippedauiFilesStoredvo výsledku); balík nad 50 MB sa odmietne. - Token na nahrávanie platí 5 minút. Jediný priečinok na najvyššej úrovni v zipe sa odstráni.
- Pri súkromnej aplikácii alebo aplikácii len pre kanály každé nahratie okamžite znova zostaví inštalovateľný balík a Nebo o tom informuje boty, ktoré si aplikáciu nainštalovali. Bot, ktorý je online, nasadí znova zostavený balík hneď; bot, ktorý je offline, to urobí pri najbližšom pripojení. Kvôli tomu netreba zvyšovať verziu a nastavenia, plány a dáta vlastníka pre aplikáciu sa zachovajú. Verejné, neuvedené a len na pozvánku dostupné aplikácie si ponechajú schválený balík, kým nová verzia neprejde kontrolou.
- Nová verzia sa riadi nastavením automatických aktualizácií, ktoré má pre aplikáciu každý vlastník. Je vypnuté, kým ho vlastník nezapne, takže bot predvolene zobrazí „K dispozícii je aktualizácia“ a vlastník ju použije v Nastaveniach v časti Aktualizácie alebo z Doručených. Aktualizácia nikdy neudelí nové oprávnenia; o oprávnenie, ktoré nová verzia pridá, sa požiada, keď ho aplikácia prvýkrát potrebuje.
- Ak NeboAI stiahne aplikáciu z obchodu, každý bot, ktorý ju nainštaloval, ju vypne a informuje vlastníka. Nič sa neodstráni: všetko, čo aplikácia uložila, sa zachová.
- Aplikácia so sidecarom namiesto toho nahráva binárny súbor každej platformy pomocou
binary-tokena stránku ako archívui. Pozri Sidecar aplikácie a Publikovanie.