Pake a
Yon aplikasyon se yon pake anplwaye ak yon manifest.json ki make l kòm yon aplikasyon ak yon dosye ui/ ki gen paj la.
<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"]
} | Chan | Sans |
|---|---|
type | "app". Fè anplwaye a tounen yon aplikasyon. Nebo li ansyen artifact_type la tou. |
id | Yon UUID ki kreye lè aplikasyon an kreye. Paj la sèvi nan /apps/<id>/ui/. |
name, version | Non anplwaye a ak vèsyon pake a. |
window | title, width, height, resizable, fullscreen, orientation. Pa defo: 1024 × 768, ka chanje gwosè, pa plen ekran, vètikal, tit dapre non anplwaye a. |
permissions | Sa paj la gen dwa fè. Pa defo ["storage:readwrite"]. |
Pèmisyon
| Pèmisyon | Bay |
|---|---|
storage:readwrite | Depo kle-valè aplikasyon an. |
subagent:<employee-id> | Mande yon lòt anplwaye apati paj la. Pwòp anplwaye aplikasyon an pa bezwen pèmisyon. |
network:<host> oswa network:* | Demann bay lòt sèvè deyò atravè proxy Nebo a. |
device:motion | Jiwoskòp ak akseleromèt pou paj sa a sèlman. Sou iPhone paj la rele tou DeviceMotionEvent.requestPermission() apati yon tap. |
Chak pèmisyon se prefix:scope. Mande pi piti sa aplikasyon an bezwen.
Plen ekran, oryantasyon ak enklinezon
Jwèt ak fim ka pran tout ekran an. Mete fullscreen epi, pou aplikasyon mobil lan, yon orientation: portrait (pa defo), landscape oswa any. Nenpòt lòt oryantasyon refize lè manifès la ekri.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Sou òdinatè aplikasyon an louvri nan yon fenèt plen ekran.
- Nan aplikasyon mobil lan pa gen ba aplikasyon, ba sistèm yo kache, ekran an rete limen epi rale pou rafrechi dezaktive. Yon ti bouton Fèmen chita nan kwen anwo agoch la epi li disparèt apre kèk segonn; yon touche toupre anwo a fè l tounen. Glise sou bò iOS la dezaktive, epi bouton retou Android lan ale dèyè nan istwa paj la anvan l fèmen.
- Mete espas sou paj la ak
env(safe-area-inset-*)akviewport-fit=cover, epi kenbe kontwòl yo lwen kwen anwo agoch la.
Kontwòl vwa a
Chak aplikasyon ki louvri nan aplikasyon Nebo sou òdinatè oswa nan aplikasyon mobil lan montre yon ti kontwòl vwa nan kwen anba adwat li, pou pwopriyetè a ka pale ak anplwaye aplikasyon an pandan l ap travay sou paj la. Kontwòl la chita deyò paj ou a, kidonk rechaje paj la pa janm koupe apèl la.
- Sou òdinatè se yon ba apeprè 300 sou 48 piksèl, 16 piksèl anndan kwen anba adwat fenèt la.
- Nan aplikasyon mobil lan se yon bouton won 48 pwen anndan zòn sekirite a pwopriyetè a ka trennen sou nenpòt bò. Nan yon aplikasyon plen ekran li retounen tounen bouton sa a kèk segonn apre apèl la kòmanse.
- Kenbe kontwòl enpòtan yo lwen kwen anba adwat la.
- Pandan yon tach ki long sou yon apèl, anplwaye a di ti nouvèl kout tankou “Kounye a m ap modifye.” epi li pa janm li non fichye ni kòmand awotvwa.
Kreye yon aplikasyon
Yon anplwaye ka konstwi yon aplikasyon de fason, epi li chwazi selon sa pwopriyetè a di. “Konstwi yon aplikasyon pou kòmand mwen yo” kreye yon nouvo anplwaye aplikasyon. “Se ou ki aplikasyon an” oswa “konstwi yon jwèt pou tèt ou” fè anplwaye pwopriyetè a ap pale avè l la tounen aplikasyon an: li kenbe chat li, memwa li ak pèsonalite li, epi paj li rechaje pandan pwopriyetè a ap pale avè l. Sa mache tou pou yon anplwaye yo anboche nan konvèsasyon. Lè li pa klè kisa pwopriyetè a vle di, anplwaye a mande yon sèl fwa.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Zouti chak jou (yon swivi, yon fòmilè, yon ti tablo) konstwi ak konpetans aplikasyon entegre Nebo a. Yon paj ki ta dwe sanble li te desine olye jenere, tankou yon paj akèy sinematik, yon fim ki mache ak defile, atizay jenere oswa yon jwèt, konstwi ak konpetans App Studio ki nan mache a.
Pou yon nouvo aplikasyon, fason ki pi senp lan se mande yon anplwaye. Nebo gen yon konpetans entegre pou konstwi aplikasyon, epi anplwaye a itilize create_employee, ki ekri dosye a, manifès la, pèsonalite a ak paj la nan yon sèl apèl. Aplikasyon an parèt nan ekip anplwaye pwopriyetè a nan kèk segonn.
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 pran menm agiman ui, app ak agent_md yo. Yon chemen nan ui ranplase fichye sa a sèlman. Paj la li sou disk la nan chak demann, kidonk rechaje fenèt la montre chanjman an.
Yon paj minimòm
Paj sa a chaje SDK a, mande kiyès anplwaye li ye, epi li afiche repons lan. Si li montre id ak non anplwaye a, branchman an bon.
<!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 a jwenn id aplikasyon an nan adrès paj la. Yon paj ki sèvi depi nenpòt lòt kote bezwen <meta name="nebo-app-id" content="<id>">. Kenbe eta a nan storage aplikasyon an, pa nan paj la: fenèt la fèmen, men storage la rete.
Kijan paj la sèvi
- Nebo sèvi
ui/nan/apps/<id>/ui/epi li louvri l nan pwòp fenèt li. - Yon chemen ki pa gen fichye ki koresponn retounen sou
index.html, kidonk routaj bò kliyan mache. - Paj HTML yo jwenn meta tag
nebo-app-idaknebo-base-url. - Chak fichye soti ak vrè kalite kontni li, enkli videyo, son, polis,
wasmak modèl 3D (glb,gltf). Yon fichye ak yon ekstansyon enkoni voye kòmapplication/octet-streamepi navigatè a p ap itilize l. - Fichye yo reponn demann ranje (
206, oswa416pou yon ranje ki depase fen an), kidonk videyo ak son ka avanse oswa rekile. Nan aplikasyon mobil la, videyo jwe sou plas san ou pa bezwen tape:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Yon fichye ki gen yon hash kontni nan non li, tankou
main-0a8ksftt.js, kenbe nan kach pou yon ane. Tout lòt bagay, enkliindex.html, tcheke chak fwa l louvri epi li reponn304lè l pa chanje. Konstwi ak non ki gen hash olye w chanje non fichye alamen. - Chak fichye paj ka gen maksimòm 10 MB.
- Efase dosye a dezaktive anplwaye a;
delete_employeeretire l nèt.
Ajoute yon sidecar
Lè paj la bezwen lojik sèvè, pwòp done pa l, oswa zouti anplwaye a ka rele, ajoute yon sidecar: yon binè Nebo fè fonksyone bò kote aplikasyon an. Paj la jwenn li ak neboFetch ak yon chemen relatif. Gade Sidecar aplikasyon.
Pibliye apati Nebo
Yon aplikasyon pwopriyetè a fè ka pibliye tèt li. Pwopriyetè a di “pibliye tèt ou”, oswa li tape Publish nan chat aplikasyon an, sou ekran aplikasyon an nan aplikasyon mobil lan (nan ba anwo a, oswa kòm yon ti bouton bò kote Fèmen pou yon aplikasyon plen ekran), oswa li chwazi Publish This App… nan meni òdinatè a (meni File sou macOS pandan yon fenèt aplikasyon devan; meni App fenèt aplikasyon an sou Windows ak Linux). Anplwaye a prepare fich la apati aplikasyon an, li pran 3 a 5 kapti ekran, epi li montre fich la nan chat la pou w fòme l lè w pale. Anyen pa voye jiskaske pwopriyetè a reponn Submit for review sou kat la, pa tap oswa pa vwa.
Yon aplikasyon pwopriyetè a fè toujou gen zouti devlopè li pou tèt li: rechaje, estati, konsòl, kapti ekran ak piblikasyon. Mòd Devlopè Aplikasyon (Paramèt bot, Devlopè) pèmèt lòt anplwaye travay sou nenpòt aplikasyon pwopriyetè a, li ajoute yon konsòl k ap flote sou paj la, epi li dezaktive kach la. Aplikasyon ki enstale nan mache a pa janm jwenn zouti devlopè ni yon bouton Publish.
Pibliye yon aplikasyon poukont ou
Yon aplikasyon ki gen paj sèlman pibliye kòm yon sèl pake ak zouti agent la. Frontmatter AGENT.md la dwe di artifact_type: app, sinon mache a kreye yon anplwaye senp san paj. Mete ant gimè nenpòt valè ki gen yon de pwen ki swiv pa yon espas; san gimè, frontmatter la pa ka li epi aplikasyon an vin yon anplwaye senp san okenn avètisman.
--- 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") | Nan zip la | Sa k ap pase |
|---|---|
AGENT.md | Pèsonalite a ak manifès fich la. |
agent.json | Konfigirasyon anplwaye a. {} bon. |
manifest.json | Kenbe kòm manifès aplikasyon an: fenèt ak pèmisyon rive nan aplikasyon ki enstale a. Dwe JSON valab. |
ui/ | Paj la. Otorize: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, imaj (png, jpg, gif, svg, webp, avif, ico, bmp), polis (woff, woff2, ttf, otf), son (mp3, wav, ogg, m4a, aac, flac, opus), videyo (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Fichye ki kòmanse ak pwen ak node_modules/ retire. |
skills/<name>/ | Pwòp konpetans anplwaye a, tcheke tankou yon konpetans yo telechaje poukont li: SKILL.md kenbe, scripts/ ak bin/ nenpòt kalite, tout lòt bagay nan lis otorize konpetans lan. |
- Limit: 10 MB pou chak fichye ak 50 MB pou chak pake. Yon fichye ki depase 10 MB sote (tcheke
filesSkippedakuiFilesStorednan rezilta a); yon pake ki depase 50 MB refize. - Token telechajman an dire 5 minit. Si zip la gen yon sèl dosye anwo, li retire.
- Pou yon aplikasyon prive oswa sèlman pou kanal, chak telechajman rekonstwi pake enstalasyon an touswit epi Nebo avèti bot ki te enstale aplikasyon an. Yon bot ki konekte mete nouvo pake a an plas touswit; youn ki dekonekte fè l lè l konekte ankò. Ou pa bezwen monte vèsyon an pou sa, epi paramèt, orè ak done pwopriyetè a pou aplikasyon an kenbe. Aplikasyon piblik, pa nan lis ak sou envitasyon sèlman kenbe pake yo apwouve a jiskaske yon nouvo vèsyon pase revizyon.
- Yon nouvo vèsyon swiv paramèt mizajou otomatik chak pwopriyetè pou aplikasyon an. Li dezaktive sòf si pwopriyetè a aktive l, kidonk pa defo bot la montre "Mizajou disponib" epi pwopriyetè a aplike l nan Paramèt, apre sa Mizajou, oswa nan Bwat resepsyon an. Yon mizajou pa janm bay nouvo pèmisyon; yon pèmisyon nouvo vèsyon an ajoute mande lè aplikasyon an bezwen l pou premye fwa.
- Si NeboAI retire yon aplikasyon nan mache a, chak bot ki te enstale l dezaktive l epi avèti pwopriyetè a. Anyen pa efase: tout sa aplikasyon an te sere kenbe.
- Yon aplikasyon ki gen yon sidecar telechaje binè chak platfòm ak
binary-tokenolye, ak paj la kòm yon achivui. Gade Sidecar aplikasyon ak Piblikasyon.