પૅકેજ
ઍપ એટલે એવું કર્મચારી પૅકેજ જેમાં તેને ઍપ તરીકે ચિહ્નિત કરતી 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 | ઍપનો key-value સ્ટોર. |
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" }
} - ડેસ્કટૉપ પર ઍપ પૂર્ણ-સ્ક્રીન વિન્ડોમાં ખૂલે છે.
- મોબાઇલ ઍપમાં કોઈ ઍપ બાર નથી, સિસ્ટમ બાર છુપાયેલા રહે છે, સ્ક્રીન ચાલુ રહે છે અને ખેંચીને રિફ્રેશ કરવાનું બંધ રહે છે. ઉપર ડાબા ખૂણે એક નાનું Close બટન હોય છે જે થોડી સેકન્ડ પછી ઝાંખું થઈ જાય છે; ઉપરની બાજુ સ્પર્શ કરવાથી તે પાછું આવે છે. iOS નું કિનારીથી સ્વાઇપ બંધ છે, અને Android નું પાછળ બટન બંધ કરતાં પહેલાં પેજના ઇતિહાસમાં પાછળ જાય છે.
- પેજમાં
env(safe-area-inset-*)અનેviewport-fit=coverવડે પૅડિંગ આપો, અને નિયંત્રણોને ઉપરના ડાબા ખૂણાથી દૂર રાખો.
અવાજ નિયંત્રણ
Nebo ડેસ્કટૉપ ઍપમાં અથવા મોબાઇલ ઍપમાં ખૂલતી દરેક ઍપ તેના નીચેના જમણા ખૂણે એક નાનું અવાજ નિયંત્રણ બતાવે છે, જેથી માલિક ઍપનો કર્મચારી પેજ પર કામ કરે ત્યારે તેની સાથે વાત કરી શકે. નિયંત્રણ તમારા પેજની બહાર હોય છે, તેથી પેજ ફરી લોડ કરવાથી કૉલ ક્યારેય કપાતો નથી.
- ડેસ્કટૉપ પર તે લગભગ 300 બાય 48 પિક્સેલનો બાર છે, જે વિન્ડોના નીચેના જમણા ખૂણેથી 16 પિક્સેલ અંદર હોય છે.
- મોબાઇલ ઍપમાં તે safe area માં 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-urlmeta ટૅગ મળે છે. - દરેક ફાઇલ તેના ખરા 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, તે એક વર્ષ માટે કૅશ થાય છે. બાકી બધું,index.htmlસહિત, દરેક વાર ખોલતી વખતે તપાસાય છે અને બદલાયું ન હોય ત્યારે304જવાબ આપે છે. ફાઇલોનાં નામ જાતે બદલવાને બદલે hash વાળાં નામ સાથે બિલ્ડ કરો. - દરેક પેજ ફાઇલ વધુમાં વધુ 10 MB ની હોઈ શકે છે.
- ફોલ્ડર ડિલીટ કરવાથી કર્મચારી નિષ્ક્રિય થાય છે;
delete_employeeતેને સંપૂર્ણપણે દૂર કરે છે.
Sidecar ઉમેરો
જ્યારે પેજને સર્વર લૉજિક, પોતાનો ડેટા, અથવા કર્મચારી કૉલ કરી શકે તેવાં સાધનો જોઈએ, ત્યારે sidecar ઉમેરો: એક બાઇનરી જે Nebo ઍપની બાજુમાં ચલાવે છે. પેજ neboFetch અને સાપેક્ષ પાથ વડે તેના સુધી પહોંચે છે. App Sidecar જુઓ.
Nebo માંથી પ્રકાશિત કરો
માલિકે બનાવેલી ઍપ પોતાને પ્રકાશિત કરી શકે છે. માલિક “પોતાને પ્રકાશિત કરો” કહે છે, અથવા ઍપની ચૅટમાં, મોબાઇલ ઍપમાં ઍપની સ્ક્રીન પર (ઉપરના બારમાં, અથવા પૂર્ણ-સ્ક્રીન ઍપ માટે Close ની બાજુના બટન તરીકે) Publish પર ટૅપ કરે છે, અથવા ડેસ્કટૉપ મેનૂમાંથી Publish This App… પસંદ કરે છે (macOS પર ઍપ વિન્ડો આગળ હોય ત્યારે File મેનૂ; Windows અને Linux પર ઍપ વિન્ડોનું App મેનૂ). કર્મચારી ઍપ પરથી લિસ્ટિંગનો ડ્રાફ્ટ બનાવે છે, 3 થી 5 સ્ક્રીનશૉટ લે છે, અને વાત કરીને ઘડી શકાય તે માટે લિસ્ટિંગ ચૅટમાં બતાવે છે. માલિક કાર્ડ પર ટૅપથી કે અવાજથી Submit for review જવાબ આપે ત્યાં સુધી કંઈ મોકલાતું નથી.
માલિકે બનાવેલી ઍપ પાસે પોતાના માટે હંમેશાં ડેવલપર સાધનો હોય છે: ફરી લોડ, સ્થિતિ, કન્સોલ, સ્ક્રીનશૉટ અને પ્રકાશન. App Developer મોડ (Bot settings, Developer) બીજા કર્મચારીઓને માલિકની કોઈ પણ ઍપ પર કામ કરવા દે છે, પેજમાં તરતું કન્સોલ ઉમેરે છે, અને કૅશિંગ બંધ કરે છે. માર્કેટપ્લેસમાંથી ઇન્સ્ટૉલ કરેલી ઍપ્સને ક્યારેય ડેવલપર સાધનો કે Publish બટન મળતું નથી.
ઍપ જાતે પ્રકાશિત કરો
ફક્ત પેજવાળી ઍપ 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 ઍપ ઇન્સ્ટૉલ કરનાર બૉટને જાણ કરે છે. ઑનલાઇન બૉટ ફરી બનેલું પૅકેજ તરત મૂકી દે છે; ઑફલાઇન બૉટ આગલી વાર જોડાય ત્યારે તે કરે છે. આ માટે તમારે વર્ઝન વધારવાની જરૂર નથી, અને ઍપ માટેનાં માલિકનાં સેટિંગ, સમયપત્રક અને ડેટા રાખવામાં આવે છે. સાર્વજનિક, અનલિસ્ટેડ અને ફક્ત-આમંત્રણ ઍપ્સ નવું વર્ઝન સમીક્ષામાં પાસ થાય ત્યાં સુધી પોતાનું મંજૂર પૅકેજ રાખે છે.
- નવું વર્ઝન ઍપ માટે દરેક માલિકના આપમેળે અપડેટ સેટિંગને અનુસરે છે. માલિક ચાલુ ન કરે ત્યાં સુધી તે બંધ રહે છે, તેથી ડિફૉલ્ટ રૂપે બૉટ "Update available" બતાવે છે અને માલિક Settings, પછી Updates માંથી, અથવા Inbox માંથી તે લાગુ કરે છે. અપડેટ ક્યારેય નવી પરવાનગીઓ આપતું નથી; નવું વર્ઝન ઉમેરે તે પરવાનગી ઍપને પહેલી વાર જરૂર પડે ત્યારે માંગવામાં આવે છે.
- જો NeboAI માર્કેટપ્લેસમાંથી કોઈ ઍપ પાછી ખેંચે, તો તેને ઇન્સ્ટૉલ કરનાર દરેક બૉટ તેને બંધ કરે છે અને માલિકને જણાવે છે. કંઈ ડિલીટ થતું નથી: ઍપે સાચવેલું બધું રાખવામાં આવે છે.
- sidecar વાળી ઍપ તેના બદલે દરેક પ્લૅટફૉર્મની બાઇનરી
binary-tokenવડે અને પેજuiઆર્કાઇવ તરીકે અપલોડ કરે છે. App Sidecar અને પ્રકાશન જુઓ.