NeboAI
NeboAI
ចាប់ផ្ដើម

កម្មវិធី

កម្មវិធីគឺជាបុគ្គលិកដែលមានទំព័រ។ ម្ចាស់បើកវាក្នុងបង្អួចផ្ទាល់ខ្លួន ដើម្បីមើល និងធ្វើការជាមួយអ្វីមួយដោយផ្ទាល់៖ ក្ដារ កម្មវិធីតាមដាន ទម្រង់។ ទំព័រគឺជា HTML និង JavaScript ធម្មតា ហើយវានិយាយជាមួយ Nebo និងបុគ្គលិករបស់វាតាមរយៈ script តែមួយ គឺ 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 ចាស់ផងដែរ។
idUUID ដែលបង្កើតនៅពេលកម្មវិធីត្រូវបានបង្កើត។ ទំព័រត្រូវបានផ្ដល់នៅ /apps/<id>/ui/។
name, versionឈ្មោះបុគ្គលិក និងកំណែកញ្ចប់។
windowtitle, width, height, resizable, fullscreen, orientation។ លំនាំដើម៖ 1024 × 768 អាចប្ដូរទំហំបាន មិនពេញអេក្រង់ បញ្ឈរ ដាក់ចំណងជើងតាមឈ្មោះបុគ្គលិក។
permissionsអ្វីដែលទំព័រអាចធ្វើបាន។ លំនាំដើម ["storage:readwrite"]។

ការអនុញ្ញាត

ការអនុញ្ញាតផ្ដល់សិទ្ធិ
storage:readwriteឃ្លាំងផ្ទុក key-value របស់កម្មវិធី។
subagent:<employee-id>ការសួរបុគ្គលិកផ្សេងទៀតពីទំព័រ។ បុគ្គលិកផ្ទាល់របស់កម្មវិធីមិនត្រូវការការអនុញ្ញាតទេ។
network:<host> ឬ network:*សំណើទៅ hosts ខាងក្រៅតាមរយៈ proxy របស់ Nebo។
device:motiongyroscope និង accelerometer សម្រាប់តែទំព័រនេះប៉ុណ្ណោះ។ នៅលើ iPhone ទំព័រក៏ហៅ DeviceMotionEvent.requestPermission() ពីការចុចផងដែរ។

ការអនុញ្ញាតនីមួយៗគឺ prefix:scope។ ស្នើសុំតិចបំផុតតាមដែលកម្មវិធីត្រូវការ។

ពេញអេក្រង់ ទិសដៅ និងការផ្អៀង

ហ្គេម និងភាពយន្តអាចប្រើអេក្រង់ទាំងមូល។ កំណត់ fullscreen ហើយសម្រាប់កម្មវិធីទូរស័ព្ទ កំណត់ orientation៖ portrait (លំនាំដើម) landscape ឬ any។ ទិសដៅផ្សេងទៀតត្រូវបានបដិសេធនៅពេលសរសេរ manifest។

{
  "type": "app",
  "permissions": ["storage:readwrite", "device:motion"],
  "window": { "title": "Kart", "fullscreen": true, "orientation": "landscape" }
}
  • នៅលើកុំព្យូទ័រ កម្មវិធីបើកក្នុងបង្អួចពេញអេក្រង់។
  • នៅក្នុងកម្មវិធីទូរស័ព្ទ គ្មានរបារកម្មវិធីទេ របារប្រព័ន្ធត្រូវបានលាក់ អេក្រង់នៅភ្លឺជានិច្ច ហើយការទាញដើម្បីធ្វើឱ្យស្រស់ត្រូវបានបិទ។ ប៊ូតុង បិទ តូចមួយស្ថិតនៅជ្រុងខាងលើឆ្វេង ហើយរលាយបាត់បន្ទាប់ពីពីរបីវិនាទី ការប៉ះនៅជិតផ្នែកខាងលើនាំវាមកវិញ។ ការអូសពីគែមលើ iOS ត្រូវបានបិទ ហើយប៊ូតុងថយក្រោយរបស់ Android ដើរតាមប្រវត្តិទំព័រមុនពេលបិទ។
  • បន្ថែមគម្លាតទំព័រដោយប្រើ env(safe-area-inset-*) និង viewport-fit=cover ហើយរក្សាការគ្រប់គ្រងឱ្យឆ្ងាយពីជ្រុងខាងលើឆ្វេង។

ការគ្រប់គ្រងសំឡេង

កម្មវិធីនីមួយៗដែលបើកក្នុងកម្មវិធី Nebo លើកុំព្យូទ័រ ឬក្នុងកម្មវិធីទូរស័ព្ទ បង្ហាញការគ្រប់គ្រងសំឡេងតូចមួយនៅជ្រុងខាងក្រោមស្ដាំ ដូច្នេះម្ចាស់អាចនិយាយជាមួយបុគ្គលិករបស់កម្មវិធី ខណៈពេលវាធ្វើការលើទំព័រ។ ការគ្រប់គ្រងស្ថិតនៅក្រៅទំព័ររបស់អ្នក ដូច្នេះការផ្ទុកទំព័រឡើងវិញមិនដែលផ្ដាច់ការហៅទេ។

  • នៅលើកុំព្យូទ័រ វាជារបារទំហំប្រហែល 300 គុណ 48 ភីកសែល ចូល 16 ភីកសែលពីជ្រុងខាងក្រោមស្ដាំរបស់បង្អួច។
  • នៅក្នុងកម្មវិធីទូរស័ព្ទ វាជាប៊ូតុងមូល 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 ដែលសរសេរថត manifest បុគ្គលិកលក្ខណៈ និងទំព័រក្នុងការហៅតែមួយ។ កម្មវិធីបង្ហាញក្នុងកម្លាំងការងាររបស់ម្ចាស់ក្នុងរយៈពេលប៉ុន្មានវិនាទី។

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 រក app id ពីអាសយដ្ឋានរបស់ទំព័រ។ ទំព័រដែលផ្ដល់ពីកន្លែងផ្សេង ត្រូវការ <meta name="nebo-app-id" content="<id>">។ រក្សាស្ថានភាពក្នុង storage របស់កម្មវិធី មិនមែនក្នុងទំព័រទេ៖ បង្អួចបិទ ហើយ storage នៅរស់រាន។

របៀបដែលទំព័រត្រូវបានផ្ដល់

  • Nebo ផ្ដល់ ui/ នៅ /apps/<id>/ui/ ហើយបើកវាក្នុងបង្អួចផ្ទាល់ខ្លួន។
  • ផ្លូវដែលគ្មានឯកសារត្រូវគ្នា ត្រឡប់ទៅ index.html ដូច្នេះការបញ្ជូនផ្លូវខាង client ដំណើរការ។
  • ទំព័រ HTML ទទួលបាន meta tags nebo-app-id និង nebo-base-url។
  • ឯកសារនីមួយៗត្រូវបានផ្ញើចេញជាមួយ content type ពិតប្រាកដរបស់វា រួមទាំងវីដេអូ សំឡេង ពុម្ពអក្សរ wasm និងម៉ូដែល 3D (glb, gltf)។ ឯកសារដែលមានកន្ទុយមិនស្គាល់ ត្រូវបានផ្ញើជា application/octet-stream ហើយកម្មវិធីរុករកនឹងមិនប្រើវាទេ។
  • ឯកសារឆ្លើយតបនឹងសំណើជួរ (206 ឬ 416 សម្រាប់ជួរដែលហួសចុង) ដូច្នេះវីដេអូ និងសំឡេងអាចរំលងទៅមុខក្រោយបាន។ នៅក្នុងកម្មវិធីទូរស័ព្ទ វីដេអូចាក់នៅនឹងកន្លែងដោយមិនចាំបាច់ចុច៖ <video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video>
  • ឯកសារដែលឈ្មោះមាន content hash ដូចជា main-0a8ksftt.js ត្រូវបានរក្សាក្នុង cache រយៈពេលមួយឆ្នាំ។ អ្វីៗផ្សេងទៀត រួមទាំង index.html ត្រូវបានពិនិត្យរាល់ពេលបើក ហើយឆ្លើយ 304 នៅពេលមិនបានផ្លាស់ប្ដូរ។ Build ជាមួយឈ្មោះដែលមាន hash ជាជាងប្ដូរឈ្មោះឯកសារដោយដៃ។
  • ឯកសារទំព័រនីមួយៗអាចមានទំហំច្រើនបំផុត 10 MB។
  • ការលុបថតបិទដំណើរការបុគ្គលិក delete_employee ដកវាចេញទាំងស្រុង។

បន្ថែម sidecar

នៅពេលទំព័រត្រូវការតក្កវិជ្ជាម៉ាស៊ីនមេ ទិន្នន័យផ្ទាល់ខ្លួន ឬឧបករណ៍ដែលបុគ្គលិកអាចហៅបាន សូមបន្ថែម sidecar៖ ឯកសារប្រព័ន្ធគោលពីរដែល Nebo ដំណើរការក្បែរកម្មវិធី។ ទំព័រទៅដល់វាដោយប្រើ neboFetch និងផ្លូវដែលទាក់ទង។ មើល App Sidecar។

បោះផ្សាយពី Nebo

កម្មវិធីដែលម្ចាស់បានបង្កើតអាចបោះផ្សាយខ្លួនឯងបាន។ ម្ចាស់និយាយថា “បោះផ្សាយខ្លួនឯង” ឬចុច បោះផ្សាយ នៅក្នុងការជជែករបស់កម្មវិធី នៅលើអេក្រង់កម្មវិធីក្នុងកម្មវិធីទូរស័ព្ទ (នៅរបារខាងលើ ឬជាប៊ូតុងនៅក្បែរ បិទ សម្រាប់កម្មវិធីពេញអេក្រង់) ឬជ្រើសរើស បោះផ្សាយកម្មវិធីនេះ… ពីម៉ឺនុយកុំព្យូទ័រ (ម៉ឺនុយ File នៅលើ macOS ខណៈពេលបង្អួចកម្មវិធីនៅខាងមុខ ម៉ឺនុយ App របស់បង្អួចកម្មវិធីនៅលើ Windows និង Linux)។ បុគ្គលិកព្រាងការដាក់បញ្ជីពីកម្មវិធី ថតរូបអេក្រង់ 3 ដល់ 5 ហើយបង្ហាញការដាក់បញ្ជីនៅក្នុងការជជែក ដើម្បីកែសម្រួលដោយការនិយាយ។ គ្មានអ្វីត្រូវបានផ្ញើទេ រហូតដល់ម្ចាស់ឆ្លើយ ដាក់ស្នើដើម្បីត្រួតពិនិត្យ នៅលើកាត ដោយការចុច ឬដោយសំឡេង។

កម្មវិធីដែលម្ចាស់បានបង្កើត តែងតែមានឧបករណ៍អ្នកអភិវឌ្ឍន៍សម្រាប់ខ្លួនវា៖ ផ្ទុកឡើងវិញ ស្ថានភាព console រូបថតអេក្រង់ និងការបោះផ្សាយ។ របៀបអ្នកអភិវឌ្ឍន៍កម្មវិធី (ការកំណត់បូត អ្នកអភិវឌ្ឍន៍) អនុញ្ញាតឱ្យបុគ្គលិកផ្សេងទៀតធ្វើការលើកម្មវិធីណាមួយរបស់ម្ចាស់ បន្ថែម console អណ្ដែតទៅទំព័រ និងបិទ cache។ កម្មវិធីដែលដំឡើងពីទីផ្សារមិនដែលទទួលបានឧបករណ៍អ្នកអភិវឌ្ឍន៍ ឬប៊ូតុង បោះផ្សាយ ទេ។

បោះផ្សាយកម្មវិធីដោយខ្លួនឯង

កម្មវិធីដែលមានតែទំព័រ បោះផ្សាយជាបណ្ដុំមួយជាមួយឧបករណ៍ agent។ frontmatter AGENT.md ត្រូវតែនិយាយថា 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បុគ្គលិកលក្ខណៈ និង manifest នៃការដាក់បញ្ជី។
agent.jsonការកំណត់រចនាសម្ព័ន្ធរបស់បុគ្គលិក។ {} គឺមិនអីទេ។
manifest.jsonរក្សាទុកជា manifest របស់កម្មវិធី៖ បង្អួច និងការអនុញ្ញាតទៅដល់កម្មវិធីដែលបានដំឡើង។ ត្រូវតែជា 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 ត្រូវបានបដិសេធ។
  • token ផ្ទុកឡើងមានសុពលភាព 5 នាទី។ ថតកំពូលតែមួយនៅក្នុង zip ត្រូវបានដកចេញ។
  • សម្រាប់កម្មវិធីឯកជន ឬសម្រាប់តែឆានែល ការផ្ទុកឡើងនីមួយៗបង្កើតកញ្ចប់ដែលអាចដំឡើងបានឡើងវិញភ្លាមៗ ហើយ Nebo ប្រាប់បូតដែលបានដំឡើងកម្មវិធីនោះ។ បូតដែលអនឡាញដាក់កញ្ចប់ដែលបានបង្កើតឡើងវិញភ្លាមៗ បូតដែលក្រៅបណ្ដាញធ្វើវានៅពេលវាតភ្ជាប់លើកក្រោយ។ អ្នកមិនចាំបាច់ដំឡើងកំណែសម្រាប់ការនេះទេ ហើយការកំណត់ កាលវិភាគ និងទិន្នន័យរបស់ម្ចាស់សម្រាប់កម្មវិធីត្រូវបានរក្សាទុក។ កម្មវិធីសាធារណៈ មិនដាក់បញ្ជី និងសម្រាប់តែអ្នកដែលបានអញ្ជើញ រក្សាកញ្ចប់ដែលបានយល់ព្រមរបស់វា រហូតដល់កំណែថ្មីឆ្លងកាត់ការត្រួតពិនិត្យ។
  • កំណែថ្មីអនុវត្តតាមការកំណត់ការធ្វើបច្ចុប្បន្នភាពស្វ័យប្រវត្តិរបស់ម្ចាស់នីមួយៗសម្រាប់កម្មវិធី។ វាត្រូវបានបិទ លុះត្រាតែម្ចាស់បើកវា ដូច្នេះតាមលំនាំដើម បូតបង្ហាញ "មានការធ្វើបច្ចុប្បន្នភាព" ហើយម្ចាស់អនុវត្តវាពី ការកំណត់ បន្ទាប់មក ការធ្វើបច្ចុប្បន្នភាព ឬពីប្រអប់ទទួល។ ការធ្វើបច្ចុប្បន្នភាពមិនដែលផ្ដល់ការអនុញ្ញាតថ្មីទេ ការអនុញ្ញាតដែលកំណែថ្មីបន្ថែម ត្រូវបានស្នើសុំនៅពេលកម្មវិធីត្រូវការវាជាលើកដំបូង។
  • ប្រសិនបើ NeboAI ដកកម្មវិធីចេញពីទីផ្សារ បូតគ្រប់ៗដែលបានដំឡើងវា នឹងបិទវា ហើយប្រាប់ម្ចាស់។ គ្មានអ្វីត្រូវបានលុបទេ៖ អ្វីៗទាំងអស់ដែលកម្មវិធីបានរក្សាទុក ត្រូវបានរក្សា។
  • កម្មវិធីដែលមាន sidecar ផ្ទុកឡើងឯកសារប្រព័ន្ធគោលពីររបស់វេទិកានីមួយៗដោយប្រើ binary-token ជំនួសវិញ ហើយទំព័រជាបណ្ណសារ ui។ មើល App Sidecar និង ការបោះផ្សាយ។