Ngwugwu ahụ
Ngwa bụ ngwugwu onye ọrụ nwere manifest.json na-aka ya akara dị ka ngwa na folda ui/ nwere ibe ahụ.
<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"]
} | Mpaghara | Ihe ọ pụtara |
|---|---|
type | "app". Na-eme onye ọrụ ahụ ngwa. Nebo na-agụkwa artifact_type ochie. |
id | UUID e mepụtara mgbe e mepụtara ngwa ahụ. A na-enye ibe ahụ na /apps/<id>/ui/. |
name, version | Aha onye ọrụ ahụ na ụdị ngwugwu ahụ. |
window | title, width, height, resizable, fullscreen, orientation. Ndabara: 1024 × 768, a pụrụ ịgbanwe nha ya, ọ bụghị ihuenyo zuru ezu, portrait, aha ya bụ aha onye ọrụ ahụ. |
permissions | Ihe ibe ahụ nwere ike ime. Ndabara ["storage:readwrite"]. |
Ikike
| Ikike | Na-enye |
|---|---|
storage:readwrite | Ebe nchekwa igodo na uru nke ngwa ahụ. |
subagent:<employee-id> | Ịjụ onye ọrụ ọzọ site n'ibe ahụ. Onye ọrụ ngwa ahụ n'onwe ya achọghị ikike. |
network:<host> ma ọ bụ network:* | Arịrịọ gaa na host dị n'èzí site na proxy Nebo. |
device:motion | Gyroscope na accelerometer maka naanị ibe a. Na iPhone, ibe ahụ na-akpọkwa DeviceMotionEvent.requestPermission() site na ịpị. |
Ikike ọ bụla bụ prefix:scope. Rịọ ihe kacha nta ngwa ahụ chọrọ.
Ihuenyo zuru ezu, ntụzi na mkpọda
Egwuregwu na fim nwere ike iwere ihuenyo niile. Setịpụ fullscreen na, maka ngwa ekwentị, orientation: portrait (ndabara), landscape ma ọ bụ any. A na-ajụ ntụzi ọ bụla ọzọ mgbe a na-ede manifest.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Na kọmputa, ngwa ahụ na-emeghe na windo ihuenyo zuru ezu.
- Na ngwa ekwentị, enweghị app bar, e zoro bar sistemụ, ihuenyo na-anọ ọkụ, a gbanyụkwara ịdọta ka emelite. Obere bọtịnụ Mechie na-anọ n'akụkụ aka ekpe n'elu ma na-ala n'iyi mgbe sekọnd ole na ole gasịrị; imetụ n'akụkụ elu na-eweghachi ya. A gbanyụrụ swipe n'akụkụ iOS, bọtịnụ azụ Android na-agazi akụkọ ibe ahụ tupu ọ mechie.
- Tinye oghere n'ibe ahụ site na
env(safe-area-inset-*)naviewport-fit=cover, ma mee ka njikwa ghara ịnọ n'akụkụ aka ekpe n'elu.
Njikwa olu
Ngwa ọ bụla e meghere na ngwa Nebo maka kọmputa ma ọ bụ na ngwa ekwentị na-egosi obere njikwa olu n'akụkụ aka nri n'okpuru ya, ka onye nwe ya nwee ike ịgwa onye ọrụ ngwa ahụ okwu ka ọ na-arụ ọrụ n'ibe ahụ. Njikwa ahụ dị n'èzí ibe gị, ya mere ibudaghachi ibe ahụ anaghị akwụsị oku ahụ.
- Na kọmputa, ọ bụ bar ihe dị ka pixel 300 site na 48, pixel 16 n'ime site n'akụkụ aka nri n'okpuru windo ahụ.
- Na ngwa ekwentị, ọ bụ bọtịnụ gburugburu nke point 48 n'ime safe area nke onye nwe ya nwere ike ịdọkpụ gaa n'akụkụ ọ bụla. Na ngwa ihuenyo zuru ezu, ọ na-alaghachi n'ụdị bọtịnụ ahụ sekọnd ole na ole n'ime oku.
- Mee ka njikwa dị mkpa ghara ịnọ n'akụkụ aka nri n'okpuru.
- N'oge ọrụ dị ogologo n'oku, onye ọrụ ahụ na-ekwu mmelite mkpụmkpụ dị ka “Ana m edezi ugbu a.” ọ dịghịkwa mgbe ọ na-agụpụta aha faịlụ ma ọ bụ iwu.
Mepụta ngwa
Onye ọrụ nwere ike iwu ngwa n'ụzọ abụọ, ọ na-ahọrọkwa dabere n'ihe onye nwe ya kwuru. “Wuoro m ngwa maka ọda m” na-emepụta onye ọrụ ngwa ọhụrụ. “Ị bụ ngwa ahụ” ma ọ bụ “wuoro onwe gị egwuregwu” na-eme onye ọrụ onye nwe ya na-agwa okwu ka ọ bụrụ ngwa ahụ: ọ na-edobe nkata ya, ncheta ya na àgwà ya, ibe ya na-ebudaghachikwa ka onye nwe ya na-agwa ya okwu. Nke a na-arụkwa ọrụ maka onye ọrụ e were na mkparịta ụka. Mgbe o doghị anya nke onye nwe ya pụtara, onye ọrụ ahụ na-ajụ otu ugboro.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) A na-eji nka ngwa dị n'ime Nebo wuo ngwaọrụ kwa ụbọchị (ihe nsochi, fọm, obere dashboard). Ibe kwesịrị ịdị ka e mere ya n'imewe kama e mepụtara ya n'akpaghị aka, dị ka ibe mmalite dị ka fim, fim na-aga site n'ịpịgharị, nka e mepụtara ma ọ bụ egwuregwu, a na-eji nka App Studio sitere n'ahịa wuo ya.
Maka ngwa ọhụrụ, ụzọ kacha mfe bụ ịjụ onye ọrụ. Nebo gụnyere nka dị n'ime maka iwu ngwa, onye ọrụ ahụ na-ejikwa create_employee, nke na-ede folda, manifest, àgwà na ibe ahụ n'otu oku. Ngwa ahụ na-apụta n'etiti ndị ọrụ onye nwe ya n'ime sekọnd ole na ole.
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 na-ewere otu arụmụka ui, app na agent_md ahụ. Ụzọ dị na ui na-anọchi otu faịlụ ahụ. A na-agụ ibe ahụ site na diski n'arịrịọ ọ bụla, ya mere ibudaghachi windo ahụ na-egosi mgbanwe ahụ.
Ibe kacha nta
Ibe a na-ebudata SDK, na-ajụ onye bụ onye ọrụ ya, ma na-ebipụta azịza ya. Ọ bụrụ na o gosiri id na aha onye ọrụ ahụ, njikọ ahụ ziri ezi.
<!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 na-achọta id ngwa site n'adreesị ibe ahụ. Ibe e si n'ebe ọzọ nye chọrọ <meta name="nebo-app-id" content="<id>">. Debe ọnọdụ na storage ngwa ahụ, ọ bụghị n'ibe ahụ: windo ahụ na-emechi, storage na-adịgide.
Otú e si enye ibe ahụ
- Nebo na-enye
ui/na/apps/<id>/ui/ma mepee ya na windo nke ya. - Ụzọ na-enweghị faịlụ dabara na-alaghachi na
index.html, ya mere routing n'akụkụ onye ahịa na-arụ ọrụ. - Ibe HTML na-enweta mkpado meta
nebo-app-idnanebo-base-url. - Faịlụ ọ bụla na-apụ na ezigbo ụdị ọdịnaya ya, gụnyere vidiyo, ụda, mkpụrụedemede,
wasmna ụdị 3D (glb,gltf). A na-eziga faịlụ nwere ndọtị a na-amaghị dị kaapplication/octet-stream, nchọgharị agaghị ejikwa ya. - Faịlụ na-aza arịrịọ range (
206, ma ọ bụ416maka range gafere njedebe), ya mere vidiyo na ụda nwere ike ịwụ gaa n'ebe ọ bụla. Na ngwa ekwentị, vidiyo na-akpọ n'ebe ọ dị n'enweghị ịpị ya:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - A na-echekwa faịlụ nke aha ya nwere hash ọdịnaya, dị ka
main-0a8ksftt.js, ruo otu afọ. A na-enyocha ihe ndị ọzọ niile, gụnyereindex.html, oge ọ bụla e meghere ya, ọ na-azakwa304mgbe ọ gbanweghị. Jiri aha nwere hash wuo kama ịgbanwe aha faịlụ n'aka. - Faịlụ ibe ọ bụla nwere ike ịbụ kacha 10 MB.
- Ihichapụ folda ahụ na-akwụsị onye ọrụ ahụ;
delete_employeena-ewepụ ya kpamkpam.
Gbakwunye sidecar
Mgbe ibe ahụ chọrọ logic sava, data nke ya, ma ọ bụ ngwaọrụ onye ọrụ ahụ nwere ike ịkpọ, gbakwunye sidecar: binary Nebo na-agba n'akụkụ ngwa ahụ. Ibe ahụ na-eru ya site na neboFetch na ụzọ dabere na ya. Lee App Sidecar.
Bipụta site na Nebo
Ngwa onye nwe ya mere nwere ike ibipụta onwe ya. Onye nwe ya na-ekwu “bipụta onwe gị”, ma ọ bụ pịa Publish na nkata ngwa ahụ, n'ihuenyo ngwa ahụ na ngwa ekwentị (na bar elu, ma ọ bụ dị ka bọtịnụ n'akụkụ Mechie maka ngwa ihuenyo zuru ezu), ma ọ bụ họrọ Publish This App… site na menu kọmputa (menu File na macOS mgbe windo ngwa nọ n'ihu; menu App nke windo ngwa ahụ na Windows na Linux). Onye ọrụ ahụ na-ede ndepụta ahụ site na ngwa ahụ, na-ese foto ihuenyo 3 ruo 5, ma na-egosi ndepụta ahụ na nkata ka a hazie ya site n'ikwu okwu. Ọ dịghị ihe a na-eziga ruo mgbe onye nwe ya zara Submit for review na kaadị ahụ, site n'ịpị ma ọ bụ site n'olu.
Ngwa onye nwe ya mere na-enwe ngwaọrụ onye mmepe ya mgbe niile maka onwe ya: ibudaghachi, ọnọdụ, console, foto ihuenyo na mbipụta. Ọnọdụ App Developer (ntọala Bot, Developer) na-enye ndị ọrụ ndị ọzọ ohere ịrụ ọrụ na ngwa ọ bụla onye nwe ya nwere, na-agbakwunye console na-ese n'elu ibe ahụ, ma na-agbanyụ caching. Ngwa e si n'ahịa wụnye anaghị enweta ngwaọrụ onye mmepe ma ọ bụ bọtịnụ Publish.
Bipụta ngwa n'onwe gị
Ngwa nwere naanị ibe na-ebipụta dị ka otu ngwugwu site na ngwaọrụ agent. Frontmatter AGENT.md ga-ekwurịrị artifact_type: app, ma ọ bụghị ya ahịa ga-emepụta onye ọrụ nkịtị na-enweghị ibe. Tinye uru ọ bụla nwere colon na-esote oghere n'ime nkwupụta; ọ bụrụ na e tinyeghị ya, a pụghị ịgụ frontmatter ahụ, ngwa ahụ na-aghọkwa onye ọrụ nkịtị na nkịtị.
--- 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") | Na zip ahụ | Ihe na-eme |
|---|---|
AGENT.md | Àgwà na manifest ndepụta ahụ. |
agent.json | Nhazi onye ọrụ ahụ. {} dị mma. |
manifest.json | A na-edobe ya dị ka manifest ngwa ahụ: windo na ikike na-eru ngwa awụnyere. Ọ ga-abụrịrị JSON ziri ezi. |
ui/ | Ibe ahụ. E kwere: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, foto (png, jpg, gif, svg, webp, avif, ico, bmp), mkpụrụedemede (woff, woff2, ttf, otf), ụda (mp3, wav, ogg, m4a, aac, flac, opus), vidiyo (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. A na-ewepụ faịlụ ntụpọ na node_modules/. |
skills/<name>/ | Nka nke onye ọrụ ahụ n'onwe ya, a na-enyocha ha dị ka nka e bulitere n'onwe ya: a na-edobe SKILL.md, scripts/ na bin/ ụdị ọ bụla, ihe ndị ọzọ niile dị na ndepụta nka e kwere. |
- Oke: 10 MB kwa faịlụ na 50 MB kwa ngwugwu. A na-agafe faịlụ karịrị 10 MB (lelee
filesSkippednauiFilesStoredna nsonaazụ); a na-ajụ ngwugwu karịrị 50 MB. - Token mbulite na-adịru nkeji 5. A na-ewepụ otu folda elu dị na zip ahụ.
- Maka ngwa nzuzo ma ọ bụ nke naanị ọwa, mbulite ọ bụla na-ewughachi ngwugwu a pụrụ ịwụnye ozugbo, Nebo na-agwakwa bot ndị wụnyere ngwa ahụ. Bot nọ n'ịntanetị na-etinye ngwugwu e wughachiri ozugbo; nke anọghị n'ịntanetị na-eme ya mgbe ọ jikọrọ ọzọ. Ị chọghị ịkwalite ụdị maka nke a, a na-edobekwa ntọala, nhazi oge na data onye nwe ya maka ngwa ahụ. Ngwa ọha, ndị a na-edepụtaghị na ndị naanị site n'òkù na-edobe ngwugwu a kwadoro ha ruo mgbe ụdị ọhụrụ gafere nyocha.
- Ụdị ọhụrụ na-agbaso ntọala mmelite akpaghị aka onye nwe ọ bụla maka ngwa ahụ. Ọ na-agbanyụ ma ọ bụrụ na onye nwe ya agbanyeghị ya, ya mere na ndabara bot ahụ na-egosi "Update available" onye nwe ya na-etinyekwa ya site na Ntọala, wee Updates, ma ọ bụ site n'Igbe ozi. Mmelite anaghị enye ikike ọhụrụ; a na-arịọ ikike ụdị ọhụrụ ahụ gbakwunyere mgbe ngwa ahụ buru ụzọ chọọ ya.
- Ọ bụrụ na NeboAI ewepụ ngwa n'ahịa, bot ọ bụla wụnyere ya na-agbanyụ ya ma gwa onye nwe ya. Ọ dịghị ihe a na-ehichapụ: a na-edobe ihe niile ngwa ahụ chekwara.
- Ngwa nwere sidecar na-ebulite binary nke ikpo okwu ọ bụla site na
binary-tokenkama, ibe ahụ dị ka ebe nchekwaui. Lee App Sidecar na Mbipụta.