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صرف اسی صفحے کے لیے 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 پوائنٹ کا ایک گول بٹن ہے جسے مالک کسی بھی طرف کھینچ سکتا ہے۔ فل اسکرین ایپ میں کال شروع ہونے کے چند سیکنڈ بعد یہ سمٹ کر اسی بٹن میں بدل جاتا ہے۔
  • اہم کنٹرولز کو نیچے دائیں کونے سے دور رکھیں۔
  • کال کے دوران کسی لمبے کام میں ملازم مختصر اپ ڈیٹس دیتا ہے جیسے “اب ترمیم ہو رہی ہے۔” اور کبھی فائلوں کے نام یا کمانڈز نہیں پڑھتا۔

ایپ بنائیں

ملازم دو طریقوں سے ایپ بنا سکتا ہے، اور مالک کی بات کے مطابق چنتا ہے۔ “میرے آرڈرز کے لیے ایک ایپ بنا دو” ایک نیا ایپ ملازم بناتا ہے۔ “تم ہی ایپ ہو” یا “اپنے لیے ایک گیم بناؤ” اس ملازم کو، جس سے مالک بات کر رہا ہے، ایپ میں بدل دیتا ہے: اس کی چیٹ، یادداشت اور شخصیت برقرار رہتی ہے، اور مالک کے بات کرنے کے دوران اس کا صفحہ دوبارہ لوڈ ہوتا ہے۔ یہ گفتگو میں رکھے گئے ملازم کے لیے بھی کام کرتا ہے۔ جب واضح نہ ہو کہ مالک کا مطلب کیا ہے، تو ملازم ایک بار پوچھتا ہے۔

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 میٹا ٹیگز ملتے ہیں۔
  • ہر فائل اپنی اصل 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 اسے مکمل طور پر ہٹا دیتا ہے۔

سائیڈکار شامل کریں

جب صفحے کو سرور لاجک، اپنا ڈیٹا، یا ایسے ٹولز درکار ہوں جنہیں ملازم کال کر سکے، تو ایک سائیڈکار شامل کریں: ایک بائنری جسے Nebo ایپ کے ساتھ چلاتا ہے۔ صفحہ neboFetch اور رشتہ دار راستے سے اس تک پہنچتا ہے۔ ایپ سائیڈکار دیکھیں۔

Nebo سے شائع کریں

مالک کی بنائی ہوئی ایپ خود کو شائع کر سکتی ہے۔ مالک کہتا ہے “خود کو شائع کرو”، یا ایپ کی چیٹ میں، موبائل ایپ میں ایپ کی اسکرین پر (اوپری بار میں، یا فل اسکرین ایپ کے لیے بند کرنے کے ساتھ گولی کی صورت میں) 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 لکھا ہونا لازمی ہے، ورنہ مارکیٹ پلیس بغیر صفحے کا ایک سادہ ملازم بنا دیتی ہے۔ ہر وہ قدر جس میں کولن کے بعد اسپیس ہو اسے quotes میں رکھیں؛ quotes کے بغیر 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 کسی ایپ کو مارکیٹ پلیس سے واپس لے لے، تو جس بوٹ نے بھی اسے انسٹال کیا ہو وہ اسے بند کر کے مالک کو بتاتا ہے۔ کچھ حذف نہیں ہوتا: ایپ کا محفوظ کیا ہوا سب کچھ برقرار رہتا ہے۔
  • سائیڈکار والی ایپ اس کے بجائے ہر پلیٹ فارم کی بائنری binary-token سے اپ لوڈ کرتی ہے، اور صفحہ ui آرکائیو کی صورت میں۔ ایپ سائیڈکار اور اشاعت دیکھیں۔