Pachetul
O aplicație este un pachet de angajat cu un manifest.json care o marchează ca aplicație și cu un folder ui/ care conține 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"]
} | Câmp | Semnificație |
|---|---|
type | "app". Face din angajat o aplicație. Nebo citește și mai vechiul artifact_type. |
id | Un UUID generat când e creată aplicația. Pagina e servită la /apps/<id>/ui/. |
name, version | Numele angajatului și versiunea pachetului. |
window | title, width, height, resizable, fullscreen, orientation. Valori implicite: 1024 × 768, redimensionabilă, nu pe tot ecranul, portret, cu titlul după numele angajatului. |
permissions | Ce are voie să facă pagina. Implicit ["storage:readwrite"]. |
Permisiuni
| Permisiune | Acordă |
|---|---|
storage:readwrite | Depozitul cheie-valoare al aplicației. |
subagent:<employee-id> | Întrebarea unui alt angajat din pagină. Angajatul propriu al aplicației nu are nevoie de permisiune. |
network:<host> sau network:* | Cereri către gazde externe prin proxyul lui Nebo. |
device:motion | Giroscopul și accelerometrul, doar pentru această pagină. Pe iPhone, pagina apelează și DeviceMotionEvent.requestPermission() la o atingere. |
Fiecare permisiune are forma prefix:scope. Cere minimul de care are nevoie aplicația.
Ecran complet, orientare și înclinare
Jocurile și filmele pot ocupa tot ecranul. Setează fullscreen și, pentru aplicația mobilă, o orientation: portrait (implicit), landscape sau any. Orice altă orientare e refuzată când se scrie manifestul.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Pe desktop, aplicația se deschide într-o fereastră pe tot ecranul.
- În aplicația mobilă nu există bară a aplicației, barele de sistem sunt ascunse, ecranul rămâne aprins și tragerea pentru reîmprospătare e dezactivată. O mică pastilă Închide stă în colțul din stânga sus și dispare după câteva secunde; o atingere lângă partea de sus o aduce înapoi. Glisarea de la margine din iOS e dezactivată, iar butonul Înapoi din Android parcurge istoricul paginii înainte să închidă.
- Adaugă spațiere paginii cu
env(safe-area-inset-*)șiviewport-fit=coverși ține comenzile departe de colțul din stânga sus.
Controlul vocal
Fiecare aplicație deschisă în aplicația Nebo pentru desktop sau în aplicația mobilă afișează un mic control vocal în colțul din dreapta jos, ca proprietarul să poată vorbi cu angajatul aplicației în timp ce acesta lucrează la pagină. Controlul stă în afara paginii tale, așa că reîncărcarea paginii nu întrerupe niciodată apelul.
- Pe desktop este o bară de aproximativ 300 pe 48 de pixeli, la 16 pixeli de colțul din dreapta jos al ferestrei.
- În aplicația mobilă este un buton rotund de 48 de puncte, în zona sigură, pe care proprietarul îl poate trage în oricare parte. Într-o aplicație pe tot ecranul, se strânge înapoi în acel buton la câteva secunde după începerea apelului.
- Ține comenzile importante departe de colțul din dreapta jos.
- În timpul unei sarcini lungi, într-un apel, angajatul spune scurte actualizări precum „Acum editez.” și nu citește niciodată cu voce tare nume de fișiere sau comenzi.
Creează o aplicație
Un angajat poate construi o aplicație în două feluri și alege după ce spune proprietarul. „Construiește-mi o aplicație pentru comenzi” creează un nou angajat de tip aplicație. „Tu ești aplicația” sau „construiește-ți un joc” îl transformă în aplicație pe angajatul cu care vorbește proprietarul: își păstrează chatul, memoria și persona, iar pagina lui se reîncarcă în timp ce proprietarul vorbește cu el. Asta funcționează și pentru un angajat angajat în conversație. Când nu e clar ce vrea proprietarul, angajatul întreabă o dată.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Instrumentele de zi cu zi (un tracker, un formular, un mic tablou de bord) se construiesc cu abilitatea integrată a lui Nebo pentru aplicații. O pagină care ar trebui să arate proiectată, nu generată, cum ar fi o pagină de prezentare cinematografică, un film condus de derulare, artă generată sau un joc, se construiește cu abilitatea App Studio din magazin.
Pentru o aplicație nouă, cel mai simplu e să-i ceri unui angajat. Nebo include o abilitate integrată pentru construirea aplicațiilor, iar angajatul folosește create_employee, care scrie folderul, manifestul, persona și pagina într-un singur apel. Aplicația apare în forța de muncă a proprietarului în câteva secunde.
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 primește aceleași argumente ui, app și agent_md. O cale din ui înlocuiește doar acel fișier. Pagina e citită de pe disc la fiecare cerere, așa că reîncărcarea ferestrei arată modificarea.
O pagină minimă
Această pagină încarcă SDK-ul, întreabă cine e angajatul ei și afișează răspunsul. Dacă arată id-ul și numele angajatului, conexiunile sunt corecte.
<!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-ul află id-ul aplicației din adresa paginii. O pagină servită din altă parte are nevoie de <meta name="nebo-app-id" content="<id>">. Păstrează starea în stocarea aplicației, nu în pagină: fereastra se închide, stocarea rămâne.
Cum e servită pagina
- Nebo servește
ui/la/apps/<id>/ui/și o deschide în propria fereastră. - O cale fără fișier corespunzător revine la
index.html, așa că rutarea pe partea de client funcționează. - Paginile HTML primesc metaetichetele
nebo-app-idșinebo-base-url. - Fiecare fișier e trimis cu tipul real de conținut, inclusiv video, sunet, fonturi,
wasmși modele 3D (glb,gltf). Un fișier cu o extensie necunoscută e trimis caapplication/octet-stream, iar browserul nu îl va folosi. - Fișierele răspund la cereri de interval (
206sau416pentru un interval dincolo de sfârșit), așa că videoclipurile și sunetul pot fi derulate. În aplicația mobilă, videoclipurile se redau pe loc, fără atingere:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Un fișier al cărui nume conține un hash al conținutului, de exemplu
main-0a8ksftt.js, e păstrat în cache un an. Tot restul, inclusivindex.html, e verificat la fiecare deschidere și răspunde cu304când nu s-a schimbat. Construiește cu nume care conțin hashuri în loc să redenumești fișierele manual. - Fiecare fișier al paginii poate avea cel mult 10 MB.
- Ștergerea folderului dezactivează angajatul;
delete_employeeîl elimină complet.
Adaugă un sidecar
Când pagina are nevoie de logică de server, de date proprii sau de instrumente pe care angajatul le poate apela, adaugă un sidecar: un binar pe care Nebo îl rulează lângă aplicație. Pagina ajunge la el cu neboFetch și o cale relativă. Vezi Sidecar pentru aplicații.
Publică din Nebo
O aplicație creată de proprietar se poate publica singură. Proprietarul spune „publică-te” sau atinge Publică în chatul aplicației, pe ecranul aplicației din aplicația mobilă (în bara de sus sau ca pastilă lângă Închide, pentru o aplicație pe tot ecranul), ori alege Publică această aplicație… din meniul aplicației pentru desktop (meniul File pe macOS, cât timp o fereastră de aplicație e în față; meniul App al ferestrei aplicației pe Windows și Linux). Angajatul redactează listarea pornind de la aplicație, face 3 până la 5 capturi de ecran și arată listarea în chat, ca s-o ajustezi vorbind. Nu se trimite nimic până când proprietarul nu răspunde Trimite la verificare pe card, prin atingere sau cu vocea.
O aplicație creată de proprietar are întotdeauna instrumentele de dezvoltator pentru ea însăși: reîncărcare, stare, consolă, capturi de ecran și publicare. Modul Dezvoltator de aplicații (setările botului, Dezvoltator) le permite altor angajați să lucreze la oricare dintre aplicațiile proprietarului, adaugă pe pagină o consolă flotantă și dezactivează memoria cache. Aplicațiile instalate din magazin nu primesc niciodată instrumente de dezvoltator sau un buton Publică.
Publică singur o aplicație
O aplicație care are doar pagină se publică ca un singur pachet cu instrumentul agent. Frontmatterul din AGENT.md trebuie să conțină artifact_type: app, altfel magazinul creează un angajat simplu, fără pagină. Pune între ghilimele orice valoare care conține două puncte urmate de un spațiu; fără ghilimele, frontmatterul nu poate fi citit, iar aplicația devine pe tăcute un angajat simplu.
--- 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") | În arhiva zip | Ce se întâmplă |
|---|---|
AGENT.md | Persona și manifestul listării. |
agent.json | Configurația angajatului. {} e în regulă. |
manifest.json | Păstrat ca manifest al aplicației: fereastra și permisiunile ajung în aplicația instalată. Trebuie să fie JSON valid. |
ui/ | Pagina. Permise: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, imagini (png, jpg, gif, svg, webp, avif, ico, bmp), fonturi (woff, woff2, ttf, otf), sunet (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Fișierele care încep cu punct și node_modules/ sunt eliminate. |
skills/<name>/ | Abilitățile proprii ale angajatului, verificate ca o abilitate încărcată separat: SKILL.md e păstrat, scripts/ și bin/ de orice tip, tot restul conform listei de fișiere permise pentru abilități. |
- Limite: 10 MB pe fișier și 50 MB pe pachet. Un fișier de peste 10 MB e omis (verifică
filesSkippedșiuiFilesStoredîn rezultat); un pachet de peste 50 MB e refuzat. - Tokenul de încărcare durează 5 minute. Un singur folder de nivel superior din arhiva zip e eliminat.
- Pentru o aplicație privată sau doar pentru canale, fiecare încărcare reconstruiește imediat pachetul instalabil, iar Nebo anunță boții care au instalat aplicația. Un bot online pune imediat în funcțiune pachetul reconstruit; unul offline o face la următoarea conectare. Nu trebuie să crești versiunea pentru asta, iar setările, programările și datele proprietarului pentru aplicație sunt păstrate. Aplicațiile publice, nelistate și cele doar pe bază de invitație își păstrează pachetul aprobat până când o versiune nouă trece de verificare.
- O versiune nouă urmează setarea de actualizări automate a fiecărui proprietar pentru aplicație. E dezactivată dacă proprietarul nu o activează, așa că implicit botul afișează „Actualizare disponibilă”, iar proprietarul o aplică din Setări, apoi Actualizări, sau din Inbox. O actualizare nu acordă niciodată permisiuni noi; o permisiune adăugată de versiunea nouă e cerută când aplicația are nevoie de ea prima dată.
- Dacă NeboAI retrage o aplicație din magazin, fiecare bot care a instalat-o o dezactivează și îl anunță pe proprietar. Nu se șterge nimic: tot ce a salvat aplicația e păstrat.
- O aplicație cu sidecar încarcă în schimb binarul fiecărei platforme cu
binary-token, iar pagina ca arhivăui. Vezi Sidecar pentru aplicații și Publicare.