প্যাকেজ
একটি অ্যাপ হলো এমন একটি কর্মী প্যাকেজ, যাতে একটি 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" }
} - ডেস্কটপে অ্যাপটি একটি ফুল-স্ক্রিন উইন্ডোতে খোলে।
- মোবাইল অ্যাপে কোনো অ্যাপ বার থাকে না, সিস্টেম বারগুলো লুকানো থাকে, স্ক্রিন জেগে থাকে এবং টেনে রিফ্রেশ বন্ধ থাকে। ওপরের বাঁ কোণে একটি ছোট ‘বন্ধ করুন’ বোতাম থাকে, যা কয়েক সেকেন্ড পরে মিলিয়ে যায়; ওপরের দিকে ছুঁলে এটি ফিরে আসে। 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-urlmeta ট্যাগ পায়। - প্রতিটি ফাইল তার আসল কনটেন্ট টাইপসহ পাঠানো হয়, ভিডিও, শব্দ, ফন্ট,
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তাকে পুরোপুরি সরিয়ে দেয়।
একটি সাইডকার যোগ করুন
পাতার যখন সার্ভার লজিক, নিজস্ব ডেটা, বা কর্মী কল করতে পারে এমন টুল দরকার, তখন একটি সাইডকার যোগ করুন: একটি বাইনারি, যা Nebo অ্যাপের পাশে চালায়। পাতা neboFetch ও একটি আপেক্ষিক পাথ দিয়ে এতে পৌঁছায়। অ্যাপ সাইডকার দেখুন।
Nebo থেকে প্রকাশ করুন
মালিকের তৈরি একটি অ্যাপ নিজেকে প্রকাশ করতে পারে। মালিক বলেন "নিজেকে প্রকাশ করো", অথবা অ্যাপের চ্যাটে, মোবাইল অ্যাপে অ্যাপের স্ক্রিনে (ওপরের বারে, অথবা ফুল-স্ক্রিন অ্যাপে ‘বন্ধ করুন’-এর পাশের বোতাম হিসেবে) প্রকাশ করুন-এ ট্যাপ করেন, অথবা ডেস্কটপ মেনু থেকে এই অ্যাপটি প্রকাশ করুন… বেছে নেন (macOS-এ অ্যাপ উইন্ডো সামনে থাকলে File মেনু; Windows ও Linux-এ অ্যাপ উইন্ডোর App মেনু)। কর্মী অ্যাপ থেকে তালিকার খসড়া তৈরি করে, 3 থেকে 5টি স্ক্রিনশট নেয়, এবং কথা বলে সাজিয়ে নেওয়ার জন্য তালিকাটি চ্যাটে দেখায়। মালিক কার্ডে ট্যাপ করে বা মুখে পর্যালোচনার জন্য জমা দিন না বলা পর্যন্ত কিছুই পাঠানো হয় না।
মালিকের তৈরি অ্যাপের নিজের জন্য সবসময় ডেভেলপার টুল থাকে: রিলোড, স্ট্যাটাস, কনসোল, স্ক্রিনশট ও প্রকাশ। App Developer মোড (বটের সেটিংস, Developer) অন্য কর্মীদের মালিকের যেকোনো অ্যাপে কাজ করতে দেয়, পাতায় একটি ভাসমান কনসোল যোগ করে, এবং ক্যাশিং বন্ধ করে। মার্কেটপ্লেস থেকে ইনস্টল করা অ্যাপ কখনও ডেভেলপার টুল বা প্রকাশ বোতাম পায় না।
নিজেই একটি অ্যাপ প্রকাশ করুন
শুধু-পাতার একটি অ্যাপ 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 মার্কেটপ্লেস থেকে কোনো অ্যাপ প্রত্যাহার করলে যে প্রতিটি বট সেটি ইনস্টল করেছে, সে সেটি বন্ধ করে মালিককে জানায়। কিছুই মুছে ফেলা হয় না: অ্যাপ যা যা সেভ করেছে, সব থেকে যায়।
- সাইডকারসহ একটি অ্যাপ এর বদলে
binary-tokenদিয়ে প্রতিটি প্ল্যাটফর্মের বাইনারি আপলোড করে, আর পাতাটি একটিuiআর্কাইভ হিসেবে। অ্যাপ সাইডকার ও প্রকাশ করা দেখুন।