NeboAI
NeboAI
Бастау

Қолданбалар

Қолданба — беті бар қызметкер. Иелер бір нәрсені тікелей көріп, онымен жұмыс істеу үшін оны жеке терезеде ашады: тақта, бақылау құралы, форма. Бет — қарапайым HTML мен JavaScript, ол Nebo-мен және өз қызметкерімен бір скрипт — App SDK арқылы байланысады.

Пакет

Қолданба — оны қолданба ретінде белгілейтін 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Қызметкердің аты және пакет нұсқасы.
windowtitle, 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 және Жариялау бөлімдерін қараңыз.