Пакет
Қолданба — оны қолданба ретінде белгілейтін manifest.json және беті бар ui/ қалтасы бар қызметкер пакеті.
<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"]
} | Өріс | Мағынасы |
|---|---|
type | "app". Қызметкерді қолданбаға айналдырады. Nebo ескі artifact_type өрісін де оқиды. |
id | Қолданба жасалғанда берілетін UUID. Бет /apps/<id>/ui/ мекенжайында ұсынылады. |
name, version | Қызметкердің аты және пакет нұсқасы. |
window | title, width, height, resizable, fullscreen, orientation. Әдепкі мәндер: 1024 × 768, өлшемі өзгертіледі, толық экран емес, тік бағдар, атауы қызметкердің атымен. |
permissions | Бет не істей алады. Әдепкі ["storage:readwrite"]. |
Рұқсаттар
| Рұқсат | Береді |
|---|---|
storage:readwrite | Қолданбаның кілт-мән қоймасы. |
subagent:<employee-id> | Беттен басқа қызметкерден сұрау. Қолданбаның өз қызметкеріне рұқсат қажет емес. |
network:<host> немесе network:* | Nebo проксиі арқылы сыртқы хосттарға сұраулар. |
device:motion | Тек осы бетке арналған гироскоп пен акселерометр. iPhone-да бет сондай-ақ түрту арқылы DeviceMotionEvent.requestPermission() шақырады. |
Әр рұқсат — prefix:scope. Қолданбаға қажеттің ең азын сұраңыз.
Толық экран, бағдар және еңкейту
Ойындар мен фильмдер бүкіл экранды ала алады. fullscreen орнатыңыз, ал мобильді қолданба үшін orientation: portrait (әдепкі), landscape немесе any. Кез келген басқа бағдар манифест жазылған кезде қабылданбайды.
{
"type": "app",
"permissions": ["storage:readwrite", "device:motion"],
"window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
} - Компьютерде қолданба толық экранды терезеде ашылады.
- Мобильді қолданбада қолданба жолағы жоқ, жүйелік жолақтар жасырылады, экран сөнбейді және жаңарту үшін тарту өшіріледі. Жоғарғы сол жақ бұрышта шағын «Жабу» түймесі тұрады және бірнеше секундтан кейін көмескіленеді; жоғарғы жаққа жақын түрту оны қайтарады. iOS жиектен сырғыту өшірулі, ал Android-тың артқа түймесі жабудан бұрын беттің тарихы бойынша артқа жүреді.
- Бетке
env(safe-area-inset-*)жәнеviewport-fit=coverарқылы шегініс беріңіз және басқару элементтерін жоғарғы сол жақ бұрыштан алыс ұстаңыз.
Дауыспен басқару
Nebo компьютер қолданбасында немесе мобильді қолданбада ашылған әр қолданба төменгі оң жақ бұрышында шағын дауыспен басқару элементін көрсетеді, сонда иесі қолданба қызметкері бетте жұмыс істеп жатқанда онымен сөйлесе алады. Бұл элемент бетіңізден тыс орналасқан, сондықтан бетті қайта жүктеу қоңырауды ешқашан үзбейді.
- Компьютерде бұл — терезенің төменгі оң жақ бұрышынан 16 пиксель ішкері тұрған, шамамен 300-ге 48 пиксельдік жолақ.
- Мобильді қолданбада бұл — қауіпсіз аймақ ішіндегі, иесі кез келген жаққа сүйрей алатын дөңгелек 48 нүктелік түйме. Толық экранды қолданбада қоңырау басталғаннан бірнеше секундтан кейін ол сол түймеге қайта жиналады.
- Маңызды басқару элементтерін төменгі оң жақ бұрыштан алыс ұстаңыз.
- Қоңырау кезіндегі ұзақ тапсырмада қызметкер «Қазір өңдеп жатырмын» сияқты қысқа хабарлар айтады және файл атауларын немесе командаларды ешқашан дауыстап оқымайды.
Қолданба жасау
Қызметкер қолданбаны екі жолмен жасай алады және иесінің айтқанына қарай таңдайды. «Тапсырыстарым үшін қолданба жаса» десе, жаңа қолданба қызметкері жасалады. «Сен қолданбасың» немесе «өзіңе ойын жаса» десе, иесі сөйлесіп отырған қызметкер қолданбаға айналады: ол чатын, жадын және тұлғасын сақтайды, ал иесі онымен сөйлесіп отырғанда оның беті қайта жүктеледі. Бұл әңгіме барысында жұмысқа алынған қызметкерге де жарайды. Иесі қайсысын меңзеп тұрғаны түсініксіз болса, қызметкер бір рет сұрайды.
update_employee(
name: "<the employee's own name>",
app: { window: { title: "Solitaire", fullscreen: true, orientation: "landscape" } },
ui: { "index.html": "<!doctype html>..." }
) Күнделікті құралдар (бақылау құралы, форма, шағын бақылау тақтасы) Nebo-ның кіріктірілген қолданба дағдысымен жасалады. Генерацияланған емес, дизайнмен жасалғандай көрінуі тиіс бет, мысалы, кинематографиялық басты бет, айналдыру арқылы жүретін фильм, генерацияланған өнер туындысы немесе ойын маркетплейстегі App Studio дағдысымен жасалады.
Жаңа қолданба үшін ең оңай жолы — қызметкерден сұрау. Nebo-да қолданбалар жасауға арналған кіріктірілген дағды бар, ал қызметкер қалтаны, манифестті, тұлғаны және бетті бір шақыруда жазатын create_employee құралын пайдаланады. Қолданба иесінің қызметкерлер тізімінде бірнеше секундта пайда болады.
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 сол ui, app және agent_md аргументтерін қабылдайды. ui ішіндегі жол тек сол бір файлды алмастырады. Бет әр сұрау кезінде дискіден оқылады, сондықтан терезені қайта жүктесеңіз, өзгеріс көрінеді.
Ең қарапайым бет
Бұл бет SDK-ны жүктейді, өз қызметкерінің кім екенін сұрайды және жауапты шығарады. Егер ол қызметкердің id-і мен атын көрсетсе, байланыс дұрыс.
<!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 қолданба id-ін беттің мекенжайынан табады. Басқа кез келген жерден ұсынылатын бетке <meta name="nebo-app-id" content="<id>"> қажет. Күйді бетте емес, қолданбаның storage-ында сақтаңыз: терезе жабылады, ал storage сақталады.
Бет қалай ұсынылады
- Nebo
ui/қалтасын/apps/<id>/ui/мекенжайында ұсынады және оны жеке терезеде ашады. - Сәйкес файлы жоқ жол
index.htmlфайлына қайтарылады, сондықтан клиент жағындағы маршруттау жұмыс істейді. - HTML беттер
nebo-app-idжәнеnebo-base-urlмета тегтерін алады. - Әр файл өзінің нақты мазмұн түрімен жіберіледі, соның ішінде бейне, дыбыс, қаріптер,
wasmжәне 3D модельдер (glb,gltf). Кеңейтімі белгісіз файлapplication/octet-streamретінде жіберіледі және браузер оны пайдаланбайды. - Файлдар ауқым сұрауларына жауап береді (
206, немесе соңынан асатын ауқым үшін416), сондықтан бейне мен дыбысты кез келген жерден ойнатуға болады. Мобильді қолданбада бейне басусыз өз орнында ойнатылады:<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - Атауында мазмұн хэші бар файл, мысалы,
main-0a8ksftt.js, бір жылға кэштеледі. Қалғанының бәрі, соның ішіндеindex.html, әр ашылған сайын тексеріледі және өзгермеген болса,304деп жауап береді. Файлдарды қолмен қайта атаудың орнына хэштелген атаулармен жинаңыз. - Әр бет файлы ең көбі 10 MB болуы мүмкін.
- Қалтаны жою қызметкерді өшіреді;
delete_employeeоны толығымен жояды.
Sidecar қосу
Бетке сервер логикасы, өз деректері немесе қызметкер шақыра алатын құралдар керек болғанда, sidecar қосыңыз: Nebo қолданбаның жанында іске қосатын бинарлық файл. Бет оған neboFetch және салыстырмалы жол арқылы жетеді. App Sidecar бөлімін қараңыз.
Nebo-дан жариялау
Иесі жасаған қолданба өзін өзі жариялай алады. Иесі «өзіңді жарияла» дейді немесе қолданба чатында, мобильді қолданбадағы қолданба экранында (жоғарғы жолақта немесе толық экранды қолданбада «Жабу» түймесінің жанында) Жариялау түймесін түртеді, немесе компьютер мәзірінен Бұл қолданбаны жариялау… тармағын таңдайды (macOS-та қолданба терезесі алдыңғы жоспарда тұрғанда File мәзірі; Windows пен Linux-та қолданба терезесінің App мәзірі). Қызметкер қолданбадан тізімдеменің жобасын жасайды, 3-тен 5-ке дейін скриншот түсіреді және тізімдемені сөйлесу арқылы пішіндеу үшін чатта көрсетеді. Иесі картадағы Тексеруге жіберу сұрағына түрту немесе дауыс арқылы жауап бермейінше ештеңе жіберілмейді.
Иесі жасаған қолданбаның өзіне арналған әзірлеуші құралдары әрдайым болады: қайта жүктеу, күй, консоль, скриншоттар және жариялау. Қолданба әзірлеушісі режимі (Бот баптаулары, Әзірлеуші) басқа қызметкерлерге иесінің кез келген қолданбасымен жұмыс істеуге мүмкіндік береді, бетке қалқымалы консоль қосады және кэштеуді өшіреді. Маркетплейстен орнатылған қолданбалар ешқашан әзірлеуші құралдарын немесе «Жариялау» түймесін алмайды.
Қолданбаны өзіңіз жариялау
Тек беттен тұратын қолданба agent құралымен бір жиынтық ретінде жарияланады. AGENT.md frontmatter-інде artifact_type: app жазылуы тиіс, әйтпесе маркетплейс беті жоқ қарапайым қызметкер жасайды. Қос нүкте мен одан кейін бос орын бар кез келген мәнді тырнақшаға алыңыз; тырнақшасыз frontmatter оқылмайды да, қолданба үнсіз түрде қарапайым қызметкерге айналады.
--- 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") | Zip ішінде | Не болады |
|---|---|
AGENT.md | Тұлға және тізімдеменің манифесті. |
agent.json | Қызметкердің конфигурациясы. {} жарайды. |
manifest.json | Қолданбаның манифесті ретінде сақталады: терезе мен рұқсаттар орнатылған қолданбаға жетеді. Жарамды JSON болуы тиіс. |
ui/ | Бет. Рұқсат етілгендер: html, css, js, mjs, ts, jsx, tsx, json, map, txt, md, суреттер (png, jpg, gif, svg, webp, avif, ico, bmp), қаріптер (woff, woff2, ttf, otf), дыбыс (mp3, wav, ogg, m4a, aac, flac, opus), бейне (mp4, webm, mov, m4v), wasm, glb, gltf, pdf. Нүктеден басталатын файлдар мен node_modules/ алынып тасталады. |
skills/<name>/ | Қызметкердің өз дағдылары, жеке жүктелген дағды сияқты тексеріледі: SKILL.md сақталады, scripts/ пен bin/ кез келген түрде, қалғанының бәрі дағдының рұқсат тізімі бойынша. |
- Шектеулер: бір файлға 10 MB және бір жиынтыққа 50 MB. 10 MB-тан асатын файл өткізіліп жіберіледі (нәтижеден
filesSkippedпенuiFilesStoredтексеріңіз); 50 MB-тан асатын жиынтық қабылданбайды. - Жүктеу токені 5 минут жарамды. Zip ішіндегі жалғыз жоғарғы қалта алынып тасталады.
- Жеке немесе тек арналарға арналған қолданба үшін әр жүктеу орнатылатын пакетті бірден қайта жинайды, ал Nebo қолданбаны орнатқан боттарға хабарлайды. Желідегі бот қайта жиналған пакетті бірден орнына қояды; желіден тыс бот мұны келесі қосылғанда істейді. Бұл үшін нұсқаны көтерудің қажеті жоқ, ал иесінің қолданбаға арналған баптаулары, кестелері мен деректері сақталады. Жалпыға ашық, тізімде жоқ және тек шақыру бойынша қолжетімді қолданбалар жаңа нұсқа тексеруден өткенше мақұлданған пакетін сақтайды.
- Жаңа нұсқа әр иенің қолданбаға арналған автоматты жаңарту баптауына сүйенеді. Иесі қоспаса, ол өшірулі тұрады, сондықтан әдепкі бойынша бот «Жаңарту қолжетімді» деп көрсетеді, ал иесі оны «Баптаулар», содан кейін «Жаңартулар» бөлімінен немесе «Кіріс» бөлімінен қолданады. Жаңарту ешқашан жаңа рұқсаттар бермейді; жаңа нұсқа қосқан рұқсат қолданбаға алғаш қажет болғанда сұралады.
- Егер NeboAI қолданбаны маркетплейстен алып тастаса, оны орнатқан әр бот оны өшіріп, иесіне хабарлайды. Ештеңе жойылмайды: қолданба сақтаған нәрсенің бәрі қалады.
- Sidecar-ы бар қолданба оның орнына әр платформаның бинарлық файлын
binary-tokenарқылы, ал беттіuiмұрағаты ретінде жүктейді. App Sidecar және Жариялау бөлімдерін қараңыз.