ጥቅሉ
መተግበሪያ እንደ መተግበሪያ ምልክት የሚያደርገው 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 proxy በኩል ወደ ውጫዊ hosts የሚሄዱ ጥያቄዎች። |
device:motion | ለዚህ ገጽ ብቻ gyroscopeና accelerometer። በ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 የኮምፒውተር መተግበሪያ ወይም በሞባይል መተግበሪያው ውስጥ የሚከፈት እያንዳንዱ መተግበሪያ ከታች በቀኝ ጥጉ ላይ ትንሽ የድምፅ መቆጣጠሪያ ያሳያል፣ ስለዚህ ባለቤቱ የመተግበሪያው ሰራተኛ በገጹ ላይ ሲሠራ ሊያነጋግረው ይችላል። መቆጣጠሪያው ከገጽዎ ውጭ ነው፣ ስለዚህ ገጹን እንደገና መጫን በፍጹም ጥሪውን አያቋርጥም።
- በኮምፒውተር ላይ ወደ 300 በ48 ፒክሰሎች የሚሆን አሞሌ ነው፣ ከመስኮቱ ታች ቀኝ ጥግ 16 ፒክሰሎች ወደ ውስጥ።
- በሞባይል መተግበሪያው ውስጥ ባለቤቱ ወደ የትኛውም ጎን ሊጎትተው የሚችል በደህንነት ቦታው ውስጥ ያለ ክብ 48-point አዝራር ነው። በሙሉ ማያ መተግበሪያ ውስጥ በጥሪው ጥቂት ሰከንዶች ውስጥ ወደዚያ አዝራር ይታጠፋል።
- አስፈላጊ መቆጣጠሪያዎችን ከታች በቀኝ ጥግ ያርቁ።
- በጥሪ ላይ ረጅም ተግባር ሲከናወን ሰራተኛው እንደ “አሁን በማርትዕ ላይ።” ያሉ አጫጭር ማሻሻያዎችን ይናገራል፣ የፋይል ስሞችን ወይም ትዕዛዞችን ግን በፍጹም አያነብም።
መተግበሪያ ይፍጠሩ
ሰራተኛ መተግበሪያን በሁለት መንገዶች ሊገነባ ይችላል፣ ባለቤቱ በሚናገረውም ይመርጣል። “ለትዕዛዞቼ መተግበሪያ ገንባልኝ” አዲስ የመተግበሪያ ሰራተኛ ይፈጥራል። “አንተ ራስህ መተግበሪያው ነህ” ወይም “ለራስህ ጨዋታ ገንባ” ባለቤቱ እያነጋገረው ያለውን ሰራተኛ ወደ መተግበሪያው ይቀይረዋል፤ ውይይቱን፣ ትውስታውንና ስብዕናውን ይይዛል፣ ባለቤቱ ሲያነጋግረውም ገጹ እንደገና ይጫናል። ይህ በውይይት ለተቀጠረ ሰራተኛም ይሠራል። ባለቤቱ የትኛውን ማለቱ እንደሆነ ግልጽ ካልሆነ ሰራተኛው አንድ ጊዜ ይጠይቃል።
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-urlmeta tags ያገኛሉ። - እያንዳንዱ ፋይል በእውነተኛ የይዘት ዓይነቱ ይላካል፤ ቪዲዮ፣ ድምፅ፣ ፊደሎች፣
wasmእና 3D ሞዴሎች (glb፣gltf) ጭምር። ያልታወቀ ቅጥያ ያለው ፋይል እንደapplication/octet-streamይላካል፣ አሳሹም አይጠቀምበትም። - ፋይሎች ለክልል ጥያቄዎች ምላሽ ይሰጣሉ (
206፣ ወይም ከመጨረሻው ላለፈ ክልል416)፣ ስለዚህ ቪዲዮ እና ድምፅ ወደፊት ወይም ወደኋላ መዝለል ይችላሉ። በሞባይል መተግበሪያው ውስጥ ቪዲዮ ሳይነኩት በቦታው ይጫወታል፦<video muted playsinline autoplay loop poster="assets/hero.jpg" src="assets/hero.mp4"></video> - ስሙ የይዘት hash የያዘ ፋይል፣ ለምሳሌ
main-0a8ksftt.js፣ ለአንድ ዓመት በማቆያ ይቀመጣል። ሌላው ሁሉ፣index.htmlን ጨምሮ፣ በእያንዳንዱ መክፈቻ ይፈተሻል፣ ካልተለወጠም304ይመልሳል። ፋይሎችን በእጅ ከመሰየም ይልቅ በhash ስሞች ይገንቡ። - እያንዳንዱ የገጽ ፋይል ቢበዛ 10 MB ሊሆን ይችላል።
- አቃፊውን መሰረዝ ሰራተኛውን ያቦዝነዋል፤
delete_employeeሙሉ በሙሉ ያስወግደዋል።
sidecar ያክሉ
ገጹ የአገልጋይ ሎጂክ፣ የራሱ ውሂብ ወይም ሰራተኛው ሊጠራቸው የሚችሉ መሣሪያዎች ሲያስፈልጉት sidecar ያክሉ፤ Nebo ከመተግበሪያው ጎን የሚያስኬደው ተፈጻሚ ፋይል። ገጹ በneboFetchና በአንጻራዊ ዱካ ይደርስበታል። የመተግበሪያ ተጓዳኝ ሂደትን ይመልከቱ።
ከNebo ያትሙ
ባለቤቱ የሠራው መተግበሪያ ራሱን ማተም ይችላል። ባለቤቱ “ራስህን አትም” ይላል፣ ወይም በመተግበሪያው ውይይት ውስጥ፣ በሞባይል መተግበሪያው ውስጥ ባለው የመተግበሪያው ማያ ላይ (በላይኛው አሞሌ ውስጥ፣ ወይም ለሙሉ ማያ መተግበሪያ ከዝጋ አጠገብ እንደ ትንሽ አዝራር) አትምን ይነካል፣ ወይም ከኮምፒውተሩ ምናሌ ይህን መተግበሪያ አትም…ን ይመርጣል (በmacOS ላይ የመተግበሪያ መስኮት ፊት ለፊት ሲሆን የFile ምናሌ፤ በWindows እና በLinux ላይ የመተግበሪያው መስኮት App ምናሌ)። ሰራተኛው ከመተግበሪያው ዝርዝሩን ያረቅቃል፣ ከ3 እስከ 5 ቅጽበታዊ ገጽ እይታዎችን ያነሳል፣ በመነጋገር እንዲቀረጽም ዝርዝሩን በውይይቱ ውስጥ ያሳያል። ባለቤቱ በካርዱ ላይ ለግምገማ አስገባን በመንካት ወይም በድምፅ እስኪመልስ ድረስ ምንም ነገር አይላክም።
ባለቤቱ የሠራው መተግበሪያ ሁልጊዜ ለራሱ የገንቢ መሣሪያዎቹ አሉት፤ እንደገና መጫን፣ ሁኔታ፣ console፣ ቅጽበታዊ ገጽ እይታዎችና ማተም። የመተግበሪያ ገንቢ ሁነታ (የቦት ቅንብሮች፣ ገንቢ) ሌሎች ሰራተኞች በማንኛውም የባለቤቱ መተግበሪያ ላይ እንዲሠሩ ያስችላል፣ በገጹ ላይ ተንሳፋፊ console ያክላል፣ ማቆያንም ያጠፋል። ከገበያ ቦታው የተጫኑ መተግበሪያዎች በፍጹም የገንቢ መሣሪያዎችን ወይም የአትም አዝራርን አያገኙም።
መተግበሪያን በራስዎ ያትሙ
ገጽ ብቻ ያለው መተግበሪያ በ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ማህደር። የመተግበሪያ ተጓዳኝ ሂደትን እና ማተምን ይመልከቱ።