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ऐप का की-वैल्यू स्टोर।
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 डेस्कटॉप ऐप या मोबाइल ऐप में खुलने वाला हर ऐप अपने नीचे दाएँ कोने में एक छोटा वॉइस कंट्रोल दिखाता है, ताकि मालिक ऐप के कर्मचारी से बात कर सके जब वह पेज पर काम कर रहा हो। यह कंट्रोल आपके पेज के बाहर रहता है, इसलिए पेज रीलोड करने पर कॉल कभी नहीं कटती।

  • डेस्कटॉप पर यह लगभग 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 इस्तेमाल करता है, जो एक ही कॉल में फ़ोल्डर, मैनिफ़ेस्ट, व्यक्तित्व और पेज लिख देता है। ऐप कुछ ही सेकंड में मालिक के कार्यबल में दिखने लगता है।

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 और एक रिलेटिव पाथ से उस तक पहुँचता है। ऐप Sidecar देखें।

Nebo से पब्लिश करें

मालिक का बनाया ऐप खुद को पब्लिश कर सकता है। मालिक कहता है "खुद को पब्लिश करो", या ऐप की चैट में, मोबाइल ऐप में ऐप की स्क्रीन पर (ऊपरी बार में, या फ़ुल-स्क्रीन ऐप के लिए बंद करें बटन के पास) पब्लिश करें पर टैप करता है, या डेस्कटॉप मेनू से यह ऐप पब्लिश करें… चुनता है (macOS पर ऐप विंडो सामने होने पर File मेनू; Windows और Linux पर ऐप विंडो का App मेनू)। कर्मचारी ऐप से लिस्टिंग का ड्राफ़्ट बनाता है, 3 से 5 स्क्रीनशॉट लेता है, और लिस्टिंग चैट में दिखाता है ताकि बातचीत से उसे सँवारा जा सके। जब तक मालिक कार्ड पर, टैप से या आवाज़ से, समीक्षा के लिए सबमिट करें का जवाब नहीं देता, कुछ भी नहीं भेजा जाता।

मालिक के बनाए ऐप के पास उसके अपने लिए डेवलपर टूल हमेशा रहते हैं: रीलोड, स्थिति, कंसोल, स्क्रीनशॉट और पब्लिश करना। App Developer मोड (बॉट सेटिंग्स, डेवलपर) दूसरे कर्मचारियों को मालिक के किसी भी ऐप पर काम करने देता है, पेज पर एक तैरता हुआ कंसोल जोड़ता है, और कैशिंग बंद कर देता है। मार्केटप्लेस से इंस्टॉल किए गए ऐप्स को कभी डेवलपर टूल या पब्लिश बटन नहीं मिलता।

ऐप खुद पब्लिश करें

सिर्फ़ पेज वाला ऐप agent टूल से एक बंडल के रूप में पब्लिश होता है। AGENT.md के फ़्रंटमैटर में artifact_type: app लिखा होना चाहिए, नहीं तो मार्केटप्लेस बिना पेज वाला एक सादा कर्मचारी बना देता है। जिस मान में कोलन के बाद स्पेस हो, उसे उद्धरण चिह्नों में रखें; बिना उद्धरण के फ़्रंटमैटर पढ़ा नहीं जा सकता और ऐप चुपचाप एक सादा कर्मचारी बन जाता है।

---
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 आर्काइव के रूप में। ऐप Sidecar और पब्लिश करना देखें।