Kifurushi
Programu ni kifurushi cha mfanyakazi chenye manifest.json inayokiwekea alama kama programu na folda ya ui/ yenye ukurasa.
<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"]
} | Sehemu | Maana |
|---|---|
type | "app". Humfanya mfanyakazi kuwa programu. Nebo pia husoma artifact_type ya zamani. |
id | UUID inayotengenezwa programu inapoundwa. Ukurasa hutolewa kwenye /apps/<id>/ui/. |
name, version | Jina la mfanyakazi na toleo la kifurushi. |
window | title, width, height, resizable, fullscreen, orientation. Chaguo-msingi: 1024 × 768, inabadilishika ukubwa, si skrini nzima, wima, yenye kichwa kwa jina la mfanyakazi. |
permissions | Kile ukurasa unaruhusiwa kufanya. Chaguo-msingi ["storage:readwrite"]. |
Ruhusa
| Ruhusa | Hutoa |
|---|---|
storage:readwrite | Hifadhi ya key-value ya programu. |
subagent:<employee-id> | Kumuuliza mfanyakazi mwingine kutoka kwenye ukurasa. Mfanyakazi wa programu mwenyewe hahitaji ruhusa. |
network:<host> au network:* | Maombi kwa hosts za nje kupitia proxy ya Nebo. |
device:motion | Gyroscope na accelerometer kwa ukurasa huu pekee. Kwenye iPhone ukurasa pia huita DeviceMotionEvent.requestPermission() kutokana na mguso. |
Kila ruhusa ni prefix:scope. Omba kidogo kabisa ambacho programu inahitaji.
Skrini nzima, mwelekeo na kuinamisha
Michezo na filamu zinaweza kuchukua skrini nzima. Weka fullscreen na, kwa programu ya simu, orientation: portrait (chaguo-msingi), landscape au any. Mwelekeo mwingine wowote hukataliwa manifest inapoandikwa.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Kwenye kompyuta programu hufunguka katika dirisha la skrini nzima.
- Katika programu ya simu hakuna upau wa programu, pau za mfumo zimefichwa, skrini inabaki macho na kuvuta ili kuonyesha upya kumezimwa. Kitufe kidogo cha Funga kiko kona ya juu kushoto na hufifia baada ya sekunde chache; kugusa karibu na juu hukirudisha. Kutelezesha ukingoni kwa iOS kumezimwa, na kitufe cha nyuma cha Android hupitia historia ya ukurasa kabla ya kufunga.
- Weka nafasi kwenye ukurasa kwa
env(safe-area-inset-*)naviewport-fit=cover, na uweke vidhibiti mbali na kona ya juu kushoto.
Kidhibiti cha sauti
Kila programu inayofunguliwa katika programu ya kompyuta ya Nebo au katika programu ya simu huonyesha kidhibiti kidogo cha sauti katika kona yake ya chini kulia, ili mmiliki aweze kuzungumza na mfanyakazi wa programu wakati anafanya kazi kwenye ukurasa. Kidhibiti kiko nje ya ukurasa wako, kwa hiyo kupakia upya ukurasa hakukati simu kamwe.
- Kwenye kompyuta ni upau wa takriban pikseli 300 kwa 48, pikseli 16 ndani kutoka kona ya chini kulia ya dirisha.
- Katika programu ya simu ni kitufe cha duara cha pointi 48 ndani ya eneo salama ambacho mmiliki anaweza kukiburuta upande wowote. Katika programu ya skrini nzima hujikunja kurudi kuwa kitufe hicho sekunde chache baada ya simu kuanza.
- Weka vidhibiti muhimu mbali na kona ya chini kulia.
- Wakati wa kazi ndefu kwenye simu, mfanyakazi husema taarifa fupi kama “Sasa ninahariri.” na kamwe hasomi kwa sauti majina ya faili wala amri.
Unda programu
Mfanyakazi anaweza kujenga programu kwa njia mbili, na huchagua kulingana na anachosema mmiliki. “Nijengee programu ya maagizo yangu” huunda mfanyakazi mpya wa programu. “Wewe ndiye programu” au “jijengee mchezo” humgeuza mfanyakazi ambaye mmiliki anazungumza naye kuwa programu: anabaki na gumzo, kumbukumbu na haiba yake, na ukurasa wake hupakiwa upya wakati mmiliki anazungumza naye. Hii inafanya kazi pia kwa mfanyakazi aliyeajiriwa kwenye mazungumzo. Isipokuwa wazi mmiliki anamaanisha ipi, mfanyakazi huuliza mara moja.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Zana za kila siku (kifuatiliaji, fomu, dashibodi ndogo) hujengwa kwa ujuzi wa programu uliojengwa ndani ya Nebo. Ukurasa unaopaswa kuonekana umebuniwa badala ya kuzalishwa, kama ukurasa wa kutua wa kisinema, filamu inayoendeshwa kwa kusogeza, sanaa iliyozalishwa au mchezo, hujengwa kwa ujuzi wa App Studio kutoka sokoni.
Kwa programu mpya, njia rahisi zaidi ni kumuuliza mfanyakazi. Nebo inajumuisha ujuzi uliojengwa ndani wa kujenga programu, na mfanyakazi hutumia create_employee, ambayo huandika folda, manifest, haiba na ukurasa kwa wito mmoja. Programu huonekana kwenye wafanyakazi wa mmiliki ndani ya sekunde chache.
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 hupokea hoja zile zile za ui, app na agent_md. Njia katika ui huchukua nafasi ya faili hiyo moja. Ukurasa husomwa kutoka kwenye diski kwa kila ombi, kwa hiyo kupakia upya dirisha huonyesha mabadiliko.
Ukurasa wa msingi
Ukurasa huu hupakia SDK, huuliza mfanyakazi wake ni nani, na huchapisha jibu. Ikionyesha id na jina la mfanyakazi, uunganishaji uko sawa.
<!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 hupata id ya programu kutoka kwenye anwani ya ukurasa. Ukurasa unaotolewa kutoka mahali pengine popote unahitaji <meta name="nebo-app-id" content="<id>">. Hifadhi hali kwenye storage ya programu, si kwenye ukurasa: dirisha hufungwa, na storage hudumu.
Jinsi ukurasa unavyotolewa
- Nebo hutoa
ui/kwenye/apps/<id>/ui/na huifungua katika dirisha lake. - Njia isiyo na faili inayolingana hurudi kwa
index.html, kwa hiyo uelekezaji wa upande wa mteja hufanya kazi. - Kurasa za HTML hupata meta tags za
nebo-app-idnanebo-base-url. - Kila faili hutumwa na aina yake halisi ya maudhui, ikiwa ni pamoja na video, sauti, fonti,
wasmna miundo ya 3D (glb,gltf). Faili yenye kiendelezi kisichojulikana hutumwa kamaapplication/octet-streamna kivinjari hakitaitumia. - Faili hujibu maombi ya sehemu (
206, au416kwa sehemu inayopita mwisho), ili video na sauti viweze kurukwa mbele na nyuma. Kwenye programu ya simu, video huchezwa papo hapo bila kugonga:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Faili ambayo jina lake lina hash ya maudhui, kama
main-0a8ksftt.js, huwekwa kwenye cache kwa mwaka mmoja. Kila kitu kingine, ikiwa ni pamoja naindex.html, hukaguliwa kila inapofunguliwa na hujibu304isipobadilika. Jenga kwa majina yenye hash badala ya kubadilisha majina ya faili kwa mkono. - Kila faili ya ukurasa inaweza kuwa upeo wa 10 MB.
- Kufuta folda humzima mfanyakazi;
delete_employeehumuondoa kabisa.
Ongeza sidecar
Ukurasa unapohitaji mantiki ya seva, data yake mwenyewe, au zana ambazo mfanyakazi anaweza kuita, ongeza sidecar: binary ambayo Nebo huiendesha kando ya programu. Ukurasa huifikia kwa neboFetch na njia ya jamaa. Tazama Sidecar ya Programu.
Chapisha kutoka Nebo
Programu ambayo mmiliki aliitengeneza inaweza kujichapisha yenyewe. Mmiliki husema “jichapishe”, au hugusa Chapisha kwenye gumzo la programu, kwenye skrini ya programu katika programu ya simu (kwenye upau wa juu, au kama kitufe kando ya Funga kwa programu ya skrini nzima), au huchagua Chapisha Programu Hii… kutoka menyu ya kompyuta (menyu ya File kwenye macOS wakati dirisha la programu liko mbele; menyu ya App ya dirisha la programu kwenye Windows na Linux). Mfanyakazi huandaa rasimu ya tangazo kutoka kwenye programu, huchukua picha 3 hadi 5 za skrini, na huonyesha tangazo kwenye gumzo ili kuliboresha kwa kuzungumza. Hakuna kinachotumwa hadi mmiliki ajibu Wasilisha kwa ukaguzi kwenye kadi, kwa kugusa au kwa sauti.
Programu ambayo mmiliki aliitengeneza daima ina zana zake za msanidi programu kwa ajili yake yenyewe: kupakia upya, hali, console, picha za skrini na kuchapisha. Hali ya Msanidi Programu wa App (mipangilio ya Boti, Msanidi Programu) huwaruhusu wafanyakazi wengine kufanya kazi kwenye programu yoyote ya mmiliki, huongeza console inayoelea kwenye ukurasa, na huzima cache. Programu zilizosakinishwa kutoka sokoni kamwe hazipati zana za msanidi programu wala kitufe cha Chapisha.
Chapisha programu mwenyewe
Programu ya ukurasa pekee huchapishwa kama kifurushi kimoja kwa zana ya agent. Frontmatter ya AGENT.md lazima iseme artifact_type: app, la sivyo soko huunda mfanyakazi wa kawaida bila ukurasa. Weka katika alama za nukuu thamani yoyote yenye nukta mbili ikifuatiwa na nafasi; bila nukuu, frontmatter haiwezi kusomwa na programu inakuwa kimya kimya mfanyakazi wa kawaida.
--- 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") | Ndani ya zip | Kinachotokea |
|---|---|
AGENT.md | Haiba na manifest ya tangazo. |
agent.json | Usanidi wa mfanyakazi. {} inatosha. |
manifest.json | Huhifadhiwa kama manifest ya programu: dirisha na ruhusa hufika kwenye programu iliyosakinishwa. Lazima iwe JSON halali. |
ui/ | Ukurasa. Zinazoruhusiwa: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, picha (png, jpg, gif, svg, webp, avif, ico, bmp), fonti (woff, woff2, ttf, otf), sauti (mp3, wav, ogg, m4a, aac, flac, opus), video (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Faili zinazoanza na nukta na node_modules/ huondolewa. |
skills/<name>/ | Ujuzi wa mfanyakazi mwenyewe, unaokaguliwa kama ujuzi uliopakiwa peke yake: SKILL.md huhifadhiwa, scripts/ na bin/ aina yoyote, kila kitu kingine kwenye orodha ya ujuzi inayoruhusiwa. |
- Mipaka: 10 MB kwa kila faili na 50 MB kwa kila kifurushi. Faili inayozidi 10 MB hurukwa (angalia
filesSkippednauiFilesStoredkatika tokeo); kifurushi kinachozidi 50 MB hukataliwa. - Tokeni ya kupakia hudumu dakika 5. Folda moja ya juu ndani ya zip huondolewa.
- Kwa programu ya faragha au ya chaneli pekee, kila upakiaji hujenga upya kifurushi kinachosakinishwa mara moja na Nebo huziarifu boti zilizosakinisha programu hiyo. Boti iliyo mtandaoni huweka kifurushi kilichojengwa upya mara moja; iliyo nje ya mtandao hufanya hivyo itakapounganishwa tena. Huhitaji kupandisha toleo kwa hili, na mipangilio, ratiba na data ya mmiliki kwa programu huhifadhiwa. Programu za umma, zisizoorodheshwa na za mwaliko pekee huhifadhi kifurushi chao kilichoidhinishwa hadi toleo jipya lipite ukaguzi.
- Toleo jipya hufuata mpangilio wa masasisho ya kiotomatiki wa kila mmiliki kwa programu hiyo. Umezimwa isipokuwa mmiliki auwashe, kwa hiyo kwa chaguo-msingi boti huonyesha "Sasisho linapatikana" na mmiliki hulitumia kutoka Mipangilio, kisha Masasisho, au kutoka Kikasha. Sasisho kamwe halitoi ruhusa mpya; ruhusa ambayo toleo jipya linaongeza huombwa programu itakapoihitaji kwa mara ya kwanza.
- NeboAI ikiondoa programu sokoni, kila boti iliyoisakinisha huizima na humjulisha mmiliki. Hakuna kinachofutwa: kila kitu ambacho programu ilihifadhi kinabaki.
- Programu yenye sidecar hupakia binary ya kila jukwaa kwa
binary-tokenbadala yake, na ukurasa kama kumbukumbu yaui. Tazama Sidecar ya Programu na Kuchapisha.