NeboAI
NeboAI
सुरू करा

ॲप्स

ॲप म्हणजे पृष्ठ असलेला कर्मचारी. मालक एखादी गोष्ट थेट पाहण्यासाठी आणि तिच्यावर काम करण्यासाठी ते स्वतःच्या विंडोमध्ये उघडतात: बोर्ड, ट्रॅकर, फॉर्म. पृष्ठ साधे HTML आणि JavaScript असते, आणि ते एकाच स्क्रिप्टद्वारे, App SDK द्वारे, Nebo शी आणि त्याच्या कर्मचाऱ्याशी बोलते.

पॅकेज

ॲप म्हणजे त्याला ॲप म्हणून चिन्हांकित करणारी 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ॲपचे 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 चे back बटण बंद करण्यापूर्वी पृष्ठाच्या इतिहासातून मागे जाते.
  • पृष्ठाला 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-url meta टॅग मिळतात.
  • प्रत्येक फाइल तिच्या खऱ्या कंटेंट प्रकारासह पाठवली जाते, ज्यात व्हिडिओ, आवाज, फॉन्ट, wasm आणि 3D मॉडेल (glb, gltf) येतात. अज्ञात एक्स्टेंशन असलेली फाइल application/octet-stream म्हणून पाठवली जाते आणि ब्राउझर ती वापरणार नाही.
  • फाइल्स range विनंत्यांना उत्तर देतात (206, किंवा शेवटच्या पलीकडील range साठी 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 तो पूर्णपणे काढते.

साइडकार जोडा

पृष्ठाला सर्व्हर लॉजिक, स्वतःचा डेटा, किंवा कर्मचारी कॉल करू शकेल अशी साधने लागतात तेव्हा, साइडकार जोडा: Nebo ॲपशेजारी चालवणारी बायनरी. पृष्ठ neboFetch आणि सापेक्ष पाथने तिच्यापर्यंत पोहोचते. ॲप साइडकार पहा.

Nebo मधून प्रकाशित करा

मालकाने बनवलेले ॲप स्वतःला प्रकाशित करू शकते. मालक “स्वतःला प्रकाशित कर” म्हणतो, किंवा ॲपच्या चॅटमध्ये, मोबाइल ॲपमधील ॲपच्या स्क्रीनवर (वरच्या पट्टीत, किंवा पूर्ण स्क्रीन ॲपसाठी Close शेजारी गोळीच्या रूपात) Publish वर टॅप करतो, किंवा डेस्कटॉप मेनूमधून Publish This App… निवडतो (macOS वर ॲप विंडो समोर असताना File मेनू; Windows आणि Linux वर ॲप विंडोचा App मेनू). कर्मचारी ॲपवरून सूचीचा मसुदा तयार करतो, 3 ते 5 स्क्रीनशॉट घेतो आणि बोलून आकार देण्यासाठी सूची चॅटमध्ये दाखवतो. मालक कार्डवर टॅपने किंवा आवाजाने Submit for review असे उत्तर देईपर्यंत काहीही पाठवले जात नाही.

मालकाने बनवलेल्या ॲपकडे स्वतःसाठी नेहमी त्याची डेव्हलपर साधने असतात: रीलोड, स्थिती, कन्सोल, स्क्रीनशॉट आणि प्रकाशन. App Developer मोड (बॉट सेटिंग्ज, 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" दाखवतो आणि मालक ते सेटिंग्ज, मग Updates मधून, किंवा इनबॉक्समधून लागू करतो. अपडेट कधीही नवीन परवानग्या देत नाही; नवीन आवृत्तीने जोडलेली परवानगी ॲपला पहिल्यांदा तिची गरज पडल्यावर मागितली जाते.
  • NeboAI ने एखादे ॲप मार्केटप्लेसवरून मागे घेतल्यास, ते इन्स्टॉल केलेला प्रत्येक बॉट ते बंद करतो आणि मालकाला सांगतो. काहीही हटवले जात नाही: ॲपने साठवलेले सर्व काही ठेवले जाते.
  • साइडकार असलेले ॲप त्याऐवजी प्रत्येक प्लॅटफॉर्मची बायनरी binary-token ने अपलोड करते, आणि पृष्ठ ui संग्रह म्हणून. ॲप साइडकार आणि प्रकाशन पहा.