NeboAI
NeboAI
শুরু করুন

Nebo-র জন্য অ্যাপ তৈরি করুন

আপনার AI-কে নতুন অসাধারণ ক্ষমতা দিন। টুল, চ্যানেল, গেটওয়ে, UI প্যানেল — আপনি যা কল্পনা করতে পারেন সবকিছু, নেটিভ বাইনারিতে কম্পাইল করা।

সংক্ষিপ্ত বিবরণ

Nebo কী

Nebo একটি ব্যক্তিগত ডেস্কটপ AI সহকারী — সবসময় চলতে থাকা একজন AI কর্মী, যে আপনার ডিজিটাল জীবন সামলায়। Nebo-কে ভাবুন স্মার্টফোনের মতো করে: একটি শক্তিশালী প্ল্যাটফর্ম, যা তার অ্যাপগুলোর মাধ্যমে বদলে দেওয়ার মতো হয়ে ওঠে।

নিজে থেকেই Nebo একজন সক্ষম AI কর্মী, যার আছে স্মৃতি, সময়সূচি, ওয়েব ব্রাউজিং, ফাইল ব্যবস্থাপনা এবং শেল অ্যাক্সেস। কিন্তু আসল সম্ভাবনা খোলে অ্যাপে। যেমন স্মার্টফোনের শক্তি আসে তার অ্যাপ ইকোসিস্টেম থেকে, তেমনি Nebo-র শক্তি আসে সেই অ্যাপগুলো থেকে, যা তার কাজের পরিধি বাড়ায়।

অ্যাপ কী

Nebo অ্যাপ হলো স্বয়ংসম্পূর্ণ, আগে থেকে কম্পাইল করা অসাধারণ কার্যকারিতার একক। প্রতিটি অ্যাপ Nebo-কে একটি নতুন অসাধারণ ক্ষমতা দেয় — ক্যালেন্ডার ব্যবস্থাপনা, ইমেইল বাছাই, প্রজেক্ট ট্র্যাকিং, হোম অটোমেশন, আর্থিক বিশ্লেষণ — একজন ডেভেলপার যা কল্পনা করতে পারেন সবকিছু।

অ্যাপগুলো অত্যন্ত নিরাপদ উপায়ে অসাধারণ ক্ষমতা দেয়। প্রতিটি অ্যাপ চলে একটি স্যান্ডবক্সে, যেখানে অনুমতি ডিফল্টভাবে বন্ধ থাকে। এর ম্যানিফেস্ট যা ঘোষণা করে এবং ব্যবহারকারী যা অনুমোদন করেন, শুধু সেটুকুতেই এটি অ্যাক্সেস পায়।

ইন্টারফেস ১০০% কথোপকথনভিত্তিক। ব্যবহারকারীরা আলাদা স্ক্রিন বা ড্যাশবোর্ডের মাধ্যমে অ্যাপ ব্যবহার করেন না। তারা Nebo-র সাথে কথা বলেন, আর Nebo কাজ সারতে অ্যাপের টুলগুলো ব্যবহার করে। "আগামীকাল আমার ক্যালেন্ডারে কী আছে?" — Nebo ক্যালেন্ডার অ্যাপকে কল করে। "বিকেল ৩টায় Sarah-র সাথে একটি মিটিং তৈরি করো" — Nebo ক্যালেন্ডার অ্যাপকে কল করে। ব্যবহারকারী কখনও কথোপকথন ছেড়ে যান না।

অ্যাপগুলো চাইলে একটি সেটিংস UI দিতে পারে — একটি কনফিগারেশন প্যানেল, যা Nebo-র বিল্ট-ইন ব্রাউজার উইন্ডোতে খোলে। এখানেই ব্যবহারকারীরা API কী লেখেন, ফিচার চালু-বন্ধ করেন এবং অ্যাপ কনফিগার করেন। সেটিংস UI চলে ম্যানিফেস্টের settings অ্যারে দিয়ে (Nebo নিজে থেকেই ফর্মটি দেখায়), অথবা অ্যাপটি ui সক্ষমতার মাধ্যমে নিজস্ব পূর্ণ কাস্টম UI দিতে পারে।

অ্যাপগুলো Nebo-র বিল্ট-ইন সক্ষমতাকে প্রতিস্থাপন করে ও বাড়ায়। Nebo কিছু মৌলিক প্ল্যাটফর্ম টুলসহ আসে (লোকাল ক্যালেন্ডার অ্যাক্সেস, স্ক্রিনশট ইত্যাদি)। আপনি একটি ক্যালেন্ডার অ্যাপ ইনস্টল করলে সেটি বিল্ট-ইন ক্যালেন্ডার টুলকে প্রতিস্থাপন করে এবং আরও বড় পরিসরের হয়ে ওঠে — লোকাল + ক্লাউড + একত্রীকরণ + সময় খালি আছে কি না যাচাই।

শুধু-কম্পাইল-করা নীতি

Nebo কঠোরভাবে শুধু-কম্পাইল-করা বাইনারির নীতি মেনে চলে। সব অ্যাপকে নেটিভ কম্পাইল করা এক্সিকিউটেবল হতে হবে।

অবস্থাভাষা
সমর্থিতGo (প্রস্তাবিত), Rust, C/C++, Zig
প্রত্যাখ্যাতPython, Node.js, Ruby, Java, .NET, শেল স্ক্রিপ্ট

যুক্তি:

  • AI-এর নিজেকে বদলানো ঠেকানো — শেল অ্যাক্সেস থাকা একজন AI কর্মী রানটাইমে একটি ইন্টারপ্রেটেড স্ক্রিপ্টের আচরণ বদলে দিতে পারে। কম্পাইল করা বাইনারি সাইন করার পর আর বদলানো যায় না।
  • সিগনেচারের অখণ্ডতা — Ed25519 সিগনেচার কাঁচা বাইনারি বাইটগুলোকে ঢেকে রাখে। সিগনেচার অবৈধ না করে একটি সাইন করা বাইনারি বদলানো যায় না।
  • স্যান্ডবক্স প্রয়োগ — বাইনারি ফরম্যাট যাচাই (ELF/Mach-O/PE ম্যাজিক বাইট) একটি দ্রুত ও নির্ভরযোগ্য ছাঁকনি।

দ্রুত শুরু

SDK ইনস্টল করুন

অফিসিয়াল SDK-গুলো সব gRPC সার্ভার সেটআপ, সিগনাল হ্যান্ডলিং এবং প্রোটোকল ব্রিজিং সামলায়। আপনাকে শুধু হ্যান্ডলার ইন্টারফেসগুলো ইমপ্লিমেন্ট করতে হবে।

Go (প্রস্তাবিত):

go get github.com/neboloop/nebo-sdk-go

Rust (শীঘ্রই আসছে):

# Coming soon
[dependencies]
nebo-sdk = "0.1"

C/C++ (শীঘ্রই আসছে):

# Coming soon — Add as a CMake subdirectory or copy headers from sdk/c/include/

অ্যাপ ডিরেক্টরির গঠন

অ্যাপগুলো থাকে আপনার Nebo ডেটা ডিরেক্টরির apps/ সাবডিরেক্টরিতে:

~/Library/Application Support/Nebo/apps/   # macOS
~/.config/nebo/apps/                        # Linux
%AppData%\Nebo\apps\                        # Windows

apps/
  com.example.myapp/
    manifest.json       # Required: app metadata
    binary              # Required: executable (or named "app")
    signatures.json     # Required for NeboAI distribution, optional in dev
    TOOL.md             # Required: tool instructions for the agent
    data/               # Auto-created: app's sandboxed storage
    logs/               # Auto-created: stdout.log, stderr.log
    ui/                 # Optional: static UI assets (HTML/CSS/JS)

ন্যূনতম অ্যাপের চেকলিস্ট

  1. id, name, version, provides দিয়ে manifest.json তৈরি করুন
  2. AI কর্মী কীভাবে আপনার টুল ব্যবহার করবে, তা বর্ণনা করে TOOL.md লিখুন
  3. SDK ইনস্টল করুন (go get github.com/neboloop/nebo-sdk-go)
  4. আপনার সক্ষমতার জন্য হ্যান্ডলার ইন্টারফেস ইমপ্লিমেন্ট করুন (ToolHandler, ChannelHandler ইত্যাদি)
  5. হ্যান্ডলারটি রেজিস্টার করুন এবং app.Run() কল করুন
  6. একটি নেটিভ বাইনারি বিল্ড করুন (go build -o binary .)
  7. বাইনারি + manifest.json + TOOL.md রাখুন apps/<your-app-id>/ ডিরেক্টরিতে
  8. Nebo নিজে থেকেই এটি খুঁজে পায় এবং চালু করে

কনফিগারেশন

manifest.json

প্রতিটি অ্যাপের একটি manifest.json লাগে:

{
    "id": "com.example.myapp",
    "name": "My App",
    "version": "1.0.0",
    "description": "What this app does",
    "runtime": "local",
    "protocol": "grpc",
    "provides": ["tool:my_tool"],
    "permissions": ["network:outbound"],
    "settings": [
        {
            "key": "api_key",
            "title": "API Key",
            "type": "password",
            "required": true,
            "description": "Your API key for the service",
            "secret": true
        }
    ]
}

আবশ্যক ফিল্ড:

ফিল্ডবিবরণ
idরিভার্স-ডোমেইন শনাক্তকারী (যেমন, com.mycompany.myapp)
nameমানুষের পড়ার উপযোগী নাম
versionSemver স্ট্রিং
providesঅন্তত একটি সক্ষমতা (নিচে দেখুন)

ঐচ্ছিক ফিল্ড:

ফিল্ডডিফল্টবিবরণ
runtime"local""local" অথবা "remote"
protocol"grpc"শুধু "grpc" সমর্থিত
permissions[]অ্যাপের কীসে অ্যাক্সেস দরকার
description""UI-তে দেখানো হয়
settings[]কনফিগারযোগ্য সেটিংস (সেটিংস UI-তে দেখানো হয়)
oauth[]OAuth প্রদানকারীর প্রয়োজনীয়তা (নিচে OAuth অংশ দেখুন)

সক্ষমতা

আপনার অ্যাপ কী দেয়, তা ঘোষণা করুন:

সক্ষমতাgRPC সার্ভিসবিবরণ
gatewayGatewayServiceLLM মডেল রাউটিং
tool:<name>ToolServiceAI কর্মীর জন্য একটি নামযুক্ত টুল
channel:<name>ChannelServiceএকটি মেসেজিং চ্যানেল
commCommServiceAI কর্মীদের মধ্যে যোগাযোগ
uiUIServiceHTTP প্রক্সিসহ কাস্টম UI
scheduleScheduleServiceকাস্টম সময়সূচি
visionToolServiceভিশন প্রসেসিং
browserToolServiceব্রাউজার অটোমেশন

একটি অ্যাপ একাধিক সক্ষমতা দিতে পারে। যেমন, একটি অ্যাপ একটি টুল এবং একটি UI প্যানেল দুটোই দিতে পারে।

অনুমতি

অনুমতি ঠিক করে অ্যাপটি কীসে অ্যাক্সেস পাবে। ডিফল্টভাবে নিষেধ — ঘোষণা না করলে অ্যাপ সেটি ব্যবহার করতে পারে না।

প্রিফিক্সউদাহরণবিবরণ
network:network:outbound, network:*নেটওয়ার্ক অ্যাক্সেস
filesystem:filesystem:read, filesystem:writeফাইল সিস্টেম অ্যাক্সেস
memory:memory:read, memory:writeAI কর্মীর স্মৃতিতে অ্যাক্সেস
session:session:readকথোপকথনের সেশন
tool:tool:shell, tool:fileঅন্যান্য টুল ব্যবহার
shell:shell:execশেল কমান্ড চালানো
channel:channel:send, channel:*চ্যানেলের কাজ
comm:comm:send, comm:*AI কর্মীদের মধ্যে যোগাযোগ
model:model:chatAI মডেলে অ্যাক্সেস
user:user:tokenঅনুরোধে ব্যবহারকারীর JWT পাওয়া
schedule:schedule:createCron জব ব্যবস্থাপনা
database:database:queryডেটাবেস অ্যাক্সেস
storage:storage:read, storage:writeস্থায়ী স্টোরেজ
context:context:readAI কর্মীর প্রেক্ষাপটে অ্যাক্সেস
subagent:subagent:spawnসাব-এজেন্টের কাজ
lane:lane:enqueueলেনের কাজ
notification:notification:sendপুশ নোটিফিকেশন
embedding:embedding:searchভেক্টর এমবেডিংয়ে অ্যাক্সেস
skill:skill:invokeদক্ষতা চালু করা
advisor:advisor:consultঅ্যাডভাইজার সিস্টেমে অ্যাক্সেস
mcp:mcp:connectMCP সার্ভারে অ্যাক্সেস
voice:voice:recordভয়েস/অডিও অ্যাক্সেস
browser:browser:navigateব্রাউজার অটোমেশন
oauth:oauth:google, oauth:*OAuth টোকেনে অ্যাক্সেস
settings:settings:readসেটিংসে অ্যাক্সেস
capability:capability:registerসক্ষমতা রেজিস্ট্রেশন

ওয়াইল্ডকার্ড অনুমতি সমর্থিত: network:* যেকোনো network: অনুমতি যাচাইয়ের সাথে মেলে।

সেটিংস

সেটিংস দেখা যায় Nebo UI-তে অ্যাপের সেটিংস প্যানেলে। Nebo এগুলো ডেটাবেসে সংরক্ষণ করে এবং বদলালে Configure RPC-এর মাধ্যমে আপনার অ্যাপে পাঠায়।

আপনার সেটিংস স্কিমা NeboAI অ্যাপ স্টোরের তালিকায় অন্তর্ভুক্ত থাকে। যে অ্যাপগুলোর আবশ্যক সেটিংস কনফিগার করা হয়নি, সেগুলো UI-তে "সেটআপ দরকার" ব্যাজ দেখায়।

ধরনবিবরণ
textএক লাইনের টেক্সট ইনপুট
passwordলুকানো টেক্সট ইনপুট
toggleবুলিয়ান চালু/বন্ধ সুইচ
selectআগে থেকে ঠিক করা বিকল্পসহ ড্রপডাউন
numberসংখ্যার ইনপুট
urlযাচাইসহ URL ইনপুট
{
    "key": "region",
    "title": "Region",
    "type": "select",
    "required": true,
    "default": "us-east-1",
    "options": [
        {"label": "US East", "value": "us-east-1"},
        {"label": "EU West", "value": "eu-west-1"}
    ]
}

OAuth প্রয়োজনীয়তা

অ্যাপগুলো OAuth প্রদানকারীর প্রয়োজনীয়তা ঘোষণা করতে পারে। Nebo-র OAuth ব্রোকার পুরো প্রক্রিয়াটি সামলায় — অ্যাপগুলো Configure RPC-এর মাধ্যমে নিজে থেকেই টোকেন পায়।

{
    "oauth": [
        {
            "provider": "google",
            "scopes": ["https://www.googleapis.com/auth/calendar"]
        }
    ]
}
ফিল্ডবিবরণ
providerOAuth প্রদানকারী: "google", "microsoft", "github"
scopesঅ্যাপের দরকারি OAuth স্কোপের অ্যারে

ব্যবহারকারী অ্যাপটি ইনস্টল করলে Nebo তাকে দরকারি OAuth স্কোপগুলো অনুমোদন করতে বলে। অ্যাপটি নিজে OAuth প্রক্রিয়া না সামলেই Configure RPC-এর মাধ্যমে রিফ্রেশ করা টোকেন পায়।

এনভায়রনমেন্ট ভেরিয়েবল

আপনার অ্যাপ প্রসেস একটি পরিষ্কার করা এনভায়রনমেন্ট পায়। সব গোপন তথ্য সরিয়ে ফেলা হয়। আপনি পান:

ভেরিয়েবলমান
NEBO_APP_DIRঅ্যাপের ইনস্টলেশন ডিরেক্টরি
NEBO_APP_SOCKযে Unix সকেট তৈরি করতে হবে তার পাথ
NEBO_APP_IDম্যানিফেস্ট থেকে অ্যাপ ID
NEBO_APP_NAMEম্যানিফেস্ট থেকে অ্যাপের নাম
NEBO_APP_VERSIONম্যানিফেস্ট থেকে অ্যাপের সংস্করণ
NEBO_APP_DATAঅ্যাপের data/ ডিরেক্টরির পাথ
PATHসিস্টেম PATH (যেমন আছে তেমন)
HOMEব্যবহারকারীর হোম ডিরেক্টরি (যেমন আছে তেমন)
TMPDIRটেম্প ডিরেক্টরি (যেমন আছে তেমন)

গুরুত্বপূর্ণ: আপনার বাইনারিকে অবশ্যই NEBO_APP_SOCK-এর Unix সকেটে শুনতে থাকা একটি gRPC সার্ভার তৈরি করতে হবে। এই সকেট দেখা দেওয়ার জন্য Nebo সর্বোচ্চ 10 সেকেন্ড অপেক্ষা করে।

অ্যাপ চালু হওয়ার ক্রম

  1. Nebo manifest.json পড়ে এবং যাচাই করে
  2. অ্যাপ ডিরেক্টরিতে binary বা app এক্সিকিউটেবল খুঁজে বের করে
  3. .quarantined চিহ্ন আছে কি না দেখে (কোয়ারেন্টাইন করা অ্যাপ চালু করতে অস্বীকার করে)
  4. বাতিলকরণ যাচাই (শুধু NeboAI-এর বিতরণ করা অ্যাপের জন্য)
  5. সিগনেচার যাচাই (শুধু NeboAI-এর বিতরণ করা অ্যাপের জন্য, ডেভ মোডে বাদ দেওয়া হয়)
  6. বাইনারি যাচাই (সিমলিংক, স্ক্রিপ্ট, নন-এক্সিকিউটেবল ও অতিরিক্ত বড় ফাইল প্রত্যাখ্যান করে)
  7. আগের রান থেকে থেকে যাওয়া পুরোনো সকেট পরিষ্কার করে
  8. স্যান্ডবক্সড স্টোরেজের জন্য data/ ডিরেক্টরি তৈরি করে
  9. প্রতিটি অ্যাপের আলাদা লগ ফাইল সেট আপ করে (logs/stdout.log, logs/stderr.log)
  10. পরিষ্কার করা এনভায়রনমেন্ট ও প্রসেস গ্রুপ আইসোলেশনসহ বাইনারি চালু করে
  11. Unix সকেট দেখা দেওয়ার জন্য অপেক্ষা করে (এক্সপোনেনশিয়াল ব্যাকঅফ, সর্বোচ্চ 10 সেকেন্ড)
  12. Unix সকেটের ওপর দিয়ে gRPC-এর মাধ্যমে সংযুক্ত হয়
  13. provides-এর ভিত্তিতে সক্ষমতা-নির্দিষ্ট gRPC ক্লায়েন্ট তৈরি করে
  14. হেলথ চেক চালায়
  15. AI কর্মীর সাথে সক্ষমতাগুলো রেজিস্টার করে (টুল, গেটওয়ে, comm ইত্যাদি)

টুল অ্যাপ

আপনার ম্যানিফেস্টে "provides": ["tool:my_tool_name"] ঘোষণা করুন।

STRAP প্যাটার্ন

সব Nebo টুল অ্যাপকে তাদের স্কিমা ও এক্সিকিউশন রাউটিংয়ের জন্য অবশ্যই STRAP (Single Tool Resource Action Pattern) ব্যবহার করতে হবে। এটি সেই একই প্যাটার্ন, যা দিয়ে Nebo ভেতরে 35+ আলাদা টুলকে 4টি ডোমেইন টুলে একত্র করে — LLM কনটেক্সটের অতিরিক্ত ভার প্রায় 80% কমিয়ে।

মূল ধারণা: একাধিক টুল (get_events, check_availability, suggest_slots) রেজিস্টার না করে, action (এবং চাইলে resource) ফিল্ডসহ একটিমাত্র টুল রেজিস্টার করুন, যা সঠিক হ্যান্ডলারে পাঠায়।

এক-রিসোর্সের উদাহরণ (ক্যালেন্ডার):

calendar(action: "get_events", start: "2025-01-15T09:00:00Z", end: "2025-01-16T00:00:00Z")
calendar(action: "next_event")
calendar(action: "check_availability", start: "...", end: "...")
calendar(action: "suggest_slots", duration_minutes: 30, preferred_time: "morning")

বহু-রিসোর্সের উদাহরণ (প্রজেক্ট ম্যানেজার):

project(resource: "task", action: "create", title: "Ship v2", assignee: "alice")
project(resource: "task", action: "list", status: "open")
project(resource: "milestone", action: "create", name: "Beta", deadline: "2025-03-01")
project(resource: "milestone", action: "list")

স্কিমার নিয়ম:

  1. সবসময় একটি action ফিল্ড রাখুন, আবশ্যক স্ট্রিং enum হিসেবে
  2. resource ফিল্ড (আবশ্যক স্ট্রিং enum) যোগ করুন শুধু তখনই, যখন আপনার টুল একাধিক আলাদা ধরনের রিসোর্স সামলায়
  3. বাকি সব ফিল্ড অ্যাকশন-নির্দিষ্ট প্যারামিটার
  4. action enum-এর বিবরণে সব উপলব্ধ অ্যাকশনের তালিকা থাকা উচিত

STRAP কেন গুরুত্বপূর্ণ:

  • LLM-গুলো action রাউটিং প্যাটার্ন একবার শেখে এবং সব কাজে তা প্রয়োগ করে
  • টুল সংজ্ঞাগুলো কনটেক্সটের প্রায় 6% খরচ করে — STRAP তা 80% কমায়
  • নতুন কাজ মানে শুধু enum-এ যোগ করা, নতুন টুল রেজিস্ট্রেশন নয়
  • হোস্টেড ও লোকাল মডেলে একইভাবে কাজ করে

Go উদাহরণ — ক্যালকুলেটর টুল

package main

import (
    "context"
    "encoding/json"
    "fmt"
    "log"

    nebo "github.com/neboloop/nebo-sdk-go"
)

type Calculator struct{}

func (c *Calculator) Name() string        { return "calculator" }
func (c *Calculator) Description() string { return "Performs arithmetic calculations." }

func (c *Calculator) Schema() json.RawMessage {
    return nebo.NewSchema("add", "subtract", "multiply", "divide").
        Number("a", "First operand", true).
        Number("b", "Second operand", true).
        Build()
}

func (c *Calculator) Execute(_ context.Context, input json.RawMessage) (string, error) {
    var in struct {
        Action string  `json:"action"`
        A      float64 `json:"a"`
        B      float64 `json:"b"`
    }
    if err := json.Unmarshal(input, &in); err != nil {
        return "", fmt.Errorf("invalid input: %w", err)
    }

    var result float64
    switch in.Action {
    case "add":
        result = in.A + in.B
    case "subtract":
        result = in.A - in.B
    case "multiply":
        result = in.A * in.B
    case "divide":
        if in.B == 0 {
            return "", fmt.Errorf("division by zero")
        }
        result = in.A / in.B
    default:
        return "", fmt.Errorf("unknown action: %s", in.Action)
    }

    return fmt.Sprintf("%g %s %g = %g", in.A, in.Action, in.B, result), nil
}

func main() {
    app, err := nebo.New()
    if err != nil {
        log.Fatal(err)
    }
    app.RegisterTool(&Calculator{})
    log.Fatal(app.Run())
}

manifest.json:

{
    "id": "com.example.calculator",
    "name": "Calculator",
    "version": "1.0.0",
    "description": "Arithmetic calculator tool for the agent",
    "runtime": "local",
    "protocol": "grpc",
    "provides": ["tool:calculator"],
    "permissions": []
}

বিল্ড ও ইনস্টল:

go build -o binary .
mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.calculator
cp binary manifest.json ~/Library/Application\ Support/Nebo/apps/com.example.calculator/

Rust উদাহরণ

use async_trait::async_trait;
use nebo_sdk::{NeboApp, NeboError, SchemaBuilder};
use nebo_sdk::tool::ToolHandler;
use serde::Deserialize;
use serde_json::Value;

struct Calculator;

#[derive(Deserialize)]
struct Input { action: String, a: f64, b: f64 }

#[async_trait]
impl ToolHandler for Calculator {
    fn name(&self) -> &str { "calculator" }
    fn description(&self) -> &str { "Performs arithmetic calculations." }
    fn schema(&self) -> Value {
        SchemaBuilder::new(&["add", "subtract", "multiply", "divide"])
            .number("a", "First operand", true)
            .number("b", "Second operand", true)
            .build()
    }
    async fn execute(&self, input: Value) -> Result<String, NeboError> {
        let i: Input = serde_json::from_value(input)
            .map_err(|e| NeboError::Execution(e.to_string()))?;
        let r = match i.action.as_str() {
            "add" => i.a + i.b,
            "subtract" => i.a - i.b,
            "multiply" => i.a * i.b,
            "divide" => {
                if i.b == 0.0 {
                    return Err(NeboError::Execution("division by zero".into()));
                }
                i.a / i.b
            }
            other => return Err(NeboError::Execution(format!("unknown action: {other}"))),
        };
        Ok(format!("{} {} {} = {}", i.a, i.action, i.b, r))
    }
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    NeboApp::new()?.register_tool(Calculator).run().await?;
    Ok(())
}

C উদাহরণ

#include <nebo/nebo.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

static int calculator_execute(const char *input_json, char **output, int *is_error) {
    /* Parse JSON, compute result, set *output */
    *output = strdup("2 add 3 = 5");
    *is_error = 0;
    return 0;
}

int main(void) {
    const char *actions[] = {"add", "subtract", "multiply", "divide", NULL};
    nebo_schema_builder_t *sb = nebo_schema_new(actions);
    nebo_schema_number(sb, "a", "First operand", 1);
    nebo_schema_number(sb, "b", "Second operand", 1);
    char *schema = nebo_schema_build(sb);
    nebo_schema_free(sb);

    nebo_tool_handler_t calculator = {
        .name = "calculator",
        .description = "Performs arithmetic calculations.",
        .schema = schema,
        .execute = calculator_execute,
    };

    nebo_app_t *app = nebo_app_new();
    nebo_app_register_tool(app, &calculator);
    int ret = nebo_app_run(app);
    free(schema);
    return ret;
}

চ্যানেল অ্যাপ

"provides": ["channel:my_channel"] এবং "permissions": ["channel:send"] ঘোষণা করুন।

চ্যানেল অ্যাপগুলো বাইরের মেসেজিং প্ল্যাটফর্ম (Telegram, Discord, Slack ইত্যাদি)-কে Nebo-র AI কর্মীর সাথে যুক্ত করে। কোনো ব্যবহারকারী বাইরের প্ল্যাটফর্মে বার্তা পাঠালে আপনার অ্যাপ Receive-এর মাধ্যমে তা Nebo-তে স্ট্রিম করে। AI কর্মী উত্তর দিতে চাইলে Nebo আপনার অ্যাপের Send কল করে।

এটি যেভাবে কাজ করে

  1. আপনার চ্যানেলের অনন্য শনাক্তকারী পেতে Nebo ID() কল করে
  2. আপনার অ্যাপের সেটিংসের কনফিগসহ Nebo Connect() কল করে
  3. Nebo একটি Receive() স্ট্রিম খোলে — কোনো ব্যবহারকারী বটকে বার্তা পাঠালেই আপনার অ্যাপ আসা বার্তাগুলো পাঠায়
  4. আসা বার্তাগুলো AI কর্মীর মূল কথোপকথন লেনে পাঠানো হয়
  5. AI কর্মী বার্তা পাঠাতে চাইলে Nebo v1 মেসেজ এনভেলপসহ Send() কল করে
  6. বন্ধ হওয়ার সময় Nebo Disconnect() কল করে

v1 মেসেজ এনভেলপ

সব চ্যানেল বার্তা — আসা ও যাওয়া — সাধারণ মেসেজ এনভেলপ ব্যবহার করে:

{
  "message_id": "01953f8a-...",
  "channel_id": "telegram:12345",
  "sender": { "name": "Alex", "role": "COO", "bot_id": "uuid" },
  "text": "Q3 numbers look good...",
  "attachments": [{ "type": "image", "url": "https://...", "filename": "chart.png", "size": 45000 }],
  "reply_to": "01953f89-...",
  "actions": [{ "label": "Approve", "callback_id": "approve_q3" }],
  "platform_data": null,
  "timestamp": "2026-02-12T15:10:00Z"
}
ফিল্ডধরনবিবরণ
message_idUUID v7সময়ক্রম অনুযায়ী অনন্য ID
channel_id{type}:{platform_id}রাউট করা যায় এমন চ্যানেল শনাক্তকারী
senderobjectবটের পরিচয় — নাম, ভূমিকা, botId
textstringবার্তার মূল অংশ
attachmentsarrayফাইল, ছবি, অডিও
reply_toUUID v7থ্রেডিংয়ের জন্য মূল বার্তার ID
actionsarrayইন্টারঅ্যাক্টিভ বোতাম/কিবোর্ড
platform_databytesপ্ল্যাটফর্ম-নির্দিষ্ট ফিচারের জন্য অস্বচ্ছ পাসথ্রু
timestampISO 8601প্রকাশক এটি সেট করে

দুই স্তরের নকশা: সাধারণ ফিল্ডগুলো (text, attachments, reply_to, actions) কর্মীর শুরু করা বার্তার 90% সামলায়। প্ল্যাটফর্ম-নির্দিষ্ট ফিচার যায় platform_data-তে — আপনার প্লাগইন সেগুলোকে নেটিভ প্ল্যাটফর্ম ফরম্যাটে ও ফরম্যাট থেকে রূপান্তর করে।

কথোপকথন স্ট্রিম

আলাদা রাখার জন্য চ্যানেল বার্তাগুলো প্রতিটি চ্যানেলের নিজস্ব কথোপকথন স্ট্রিমে পাঠানো হয়:

neboai/bot/{botID}/channels/{channelType}/inbound    # messages from users → agent
neboai/bot/{botID}/channels/{channelType}/outbound   # messages from agent → channel

Go উদাহরণ — Telegram চ্যানেল

package main

import (
    "context"
    "encoding/json"
    "fmt"
    "log"
    "time"

    "github.com/google/uuid"
    tgbot "github.com/go-telegram/bot"
    nebo "github.com/neboloop/nebo-sdk-go"
)

type Telegram struct {
    bot      *tgbot.Bot
    messages chan nebo.ChannelEnvelope
    cancel   context.CancelFunc
}

func (t *Telegram) ID() string { return "telegram" }

func (t *Telegram) Connect(_ context.Context, config map[string]string) error {
    token := config["bot_token"]
    if token == "" {
        return fmt.Errorf("bot_token is required")
    }

    botCtx, cancel := context.WithCancel(context.Background())
    t.cancel = cancel

    bot, err := tgbot.New(token, tgbot.WithDefaultHandler(
        func(bCtx context.Context, b *tgbot.Bot, update *tgbot.Update) {
            if update.Message == nil {
                return
            }
            env := nebo.ChannelEnvelope{
                MessageID: uuid.Must(uuid.NewV7()).String(),
                ChannelID: fmt.Sprintf("telegram:%d", update.Message.Chat.ID),
                Text:      update.Message.Text,
                Timestamp: time.Unix(int64(update.Message.Date), 0).UTC(),
            }
            t.messages <- env
        },
    ))
    if err != nil {
        return err
    }

    t.bot = bot
    go bot.Start(botCtx)
    return nil
}

func (t *Telegram) Send(ctx context.Context, env nebo.ChannelEnvelope) (string, error) {
    if t.bot == nil {
        return "", fmt.Errorf("not connected")
    }
    chatID := env.ChannelID[len("telegram:"):]
    params := &tgbot.SendMessageParams{
        ChatID: chatID,
        Text:   env.Text,
    }
    msg, err := t.bot.SendMessage(ctx, params)
    if err != nil {
        return "", err
    }
    return fmt.Sprintf("%d", msg.MessageID), nil
}

func (t *Telegram) Receive(_ context.Context) (<-chan nebo.ChannelEnvelope, error) {
    return t.messages, nil
}

func (t *Telegram) Disconnect(_ context.Context) error {
    if t.cancel != nil {
        t.cancel()
    }
    return nil
}

func main() {
    app, err := nebo.New()
    if err != nil {
        log.Fatal(err)
    }
    app.RegisterChannel(&Telegram{
        messages: make(chan nebo.ChannelEnvelope, 100),
    })
    log.Fatal(app.Run())
}

manifest.json:

{
    "id": "com.example.telegram",
    "name": "Telegram",
    "version": "1.0.0",
    "description": "Telegram messaging channel for Nebo",
    "runtime": "local",
    "protocol": "grpc",
    "provides": ["channel:telegram"],
    "permissions": ["channel:send", "network:outbound"],
    "settings": [
        {
            "key": "bot_token",
            "title": "Bot Token",
            "type": "password",
            "required": true,
            "description": "Telegram bot token from @BotFather",
            "secret": true
        }
    ]
}

আরও সক্ষমতা

Comm অ্যাপ

"provides": ["comm"] এবং "permissions": ["comm:*"] ঘোষণা করুন। Comm অ্যাপগুলো AI কর্মীদের মধ্যে যোগাযোগ সম্ভব করে।

ফিল্ডবিবরণ
fromপ্রেরক কর্মীর ID
toপ্রাপক কর্মীর ID
topicবার্তার টপিক/চ্যানেল
type"message", "mention", "proposal", "command", "info", "task"
contentবার্তার মূল অংশ

মূল আচরণ:

  • Register এই AI কর্মীকে তার সক্ষমতাসহ নেটওয়ার্কে ঘোষণা করে
  • Subscribe/Unsubscribe টপিক সাবস্ক্রিপশন সামলায়
  • Receive আসা বার্তাগুলো স্ট্রিম করে (সার্ভার-স্ট্রিমিং, চ্যানেলের মতোই)
  • একসাথে শুধু একটি comm অ্যাপ সক্রিয় থাকতে পারে

গেটওয়ে অ্যাপ

একটি গেটওয়ে অ্যাপ LLM অনুরোধগুলো মডেলে পাঠায়। "provides": ["gateway"] এবং "permissions": ["network:outbound", "user:token"] ঘোষণা করুন।

GatewayRequest-এ থাকে বার্তা, টুল, সিস্টেম প্রম্পট, সর্বোচ্চ টোকেন, temperature এবং একটি UserContext (user:token অনুমতি দেওয়া থাকলে JWT টোকেন)।

GatewayEvent-এর ধরন:

ধরনকনটেন্টবিবরণ
"text"টেক্সটের অংশস্ট্রিমিং টেক্সট টোকেন
"tool_call"JSONমডেল একটি টুল কল করতে চায়
"thinking"টেক্সটের অংশবর্ধিত চিন্তা/যুক্তি
"error"ত্রুটির বার্তাকিছু একটা ভুল হয়েছে
"done"ফাঁকাস্ট্রিম সম্পূর্ণ

UI অ্যাপ

একটি UI অ্যাপ একটি কাস্টম কনফিগারেশন ইন্টারফেস দেয়, যা Nebo-র বিল্ট-ইন ব্রাউজার উইন্ডোতে খোলে। "provides": ["ui"] ঘোষণা করুন। স্বয়ংক্রিয় সেটিংস ফর্মের মতো নয় (যা Nebo আপনার settings ম্যানিফেস্ট থেকে দেখায়), একটি UI অ্যাপ নিজস্ব পূর্ণ HTML/CSS/JS ফ্রন্টএন্ড পরিবেশন করে।

আপনার অ্যাপের সাথে থাকে একটি ui/ ডিরেক্টরি, যাতে স্ট্যাটিক ওয়েব অ্যাসেট থাকে (HTML, CSS, JS — সাধারণত index.html-সহ একটি SPA)। Nebo এই ফাইলগুলো সরাসরি পরিবেশন করে এবং API কলগুলো gRPC-এর মাধ্যমে আপনার অ্যাপে প্রক্সি করে।

পাথপদ্ধতিউদ্দেশ্য
GET /api/v1/apps/{id}/ui/*স্ট্যাটিক ফাইল সার্ভারআপনার ui/ ডিরেক্টরি থেকে ফাইল পরিবেশন করে (SPA ফলব্যাক index.html-এ)
ANY /api/v1/apps/{id}/api/*gRPC প্রক্সিHTTP অনুরোধগুলো আপনার অ্যাপের UIService.HandleRequest()-এ প্রক্সি করে

SDK একটি স্ট্যান্ডার্ড net/http.ServeMux মুড়ে রাখে, তাই আপনি সাধারণ Go HTTP হ্যান্ডলার লেখেন — SDK নিজে থেকেই gRPC ব্রিজিং সামলায়।

Go উদাহরণ — ড্যাশবোর্ড UI:

package main

import (
    "encoding/json"
    "log"
    "net/http"

    nebo "github.com/neboloop/nebo-sdk-go"
)

type Dashboard struct {
    mux *http.ServeMux
}

func NewDashboard() *Dashboard {
    d := &Dashboard{mux: http.NewServeMux()}

    d.mux.HandleFunc("GET /status", func(w http.ResponseWriter, r *http.Request) {
        json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
    })

    d.mux.HandleFunc("POST /action", func(w http.ResponseWriter, r *http.Request) {
        var req map[string]string
        json.NewDecoder(r.Body).Decode(&req)
        json.NewEncoder(w).Encode(map[string]string{"result": "done"})
    })

    return d
}

func (d *Dashboard) Handler() *http.ServeMux { return d.mux }

func main() {
    app, err := nebo.New()
    if err != nil {
        log.Fatal(err)
    }
    app.RegisterUI(NewDashboard())
    log.Fatal(app.Run())
}

আপনার ui/index.html /api/v1/apps/com.example.dashboard/api/status-এ fetch কল করবে, যা আপনার mux হ্যান্ডলারে প্রক্সি হয়ে পৌঁছায়।

শিডিউল অ্যাপ

একটি শিডিউল অ্যাপ Nebo-র বিল্ট-ইন cron শিডিউলারকে প্রতিস্থাপন করে। "provides": ["schedule"] এবং "permissions": ["schedule:create"] ঘোষণা করুন।

আপনার শিডিউল অ্যাপ চালু হলে Nebo ডিফল্ট cron ইঞ্জিনের বদলে সব সময়সূচির কাজ আপনার অ্যাপের মাধ্যমে পাঠায়। আপনার অ্যাপ ক্র্যাশ করলে Nebo নিজে থেকেই বিল্ট-ইন ইঞ্জিনে ফিরে যায়।

  • আপনার অ্যাপ সময়সূচির অবস্থার মালিক — শিডিউল অ্যাপ সক্রিয় থাকলে Nebo নিজের DB-তে সময়সূচি সংরক্ষণ করে না
  • স্ট্যান্ডার্ড CRUD: Create, Get, List, Update, Delete, Enable, Disable
  • Triggers একটি সার্ভার-স্ট্রিমিং RPC — কোনো সময়সূচি চালু হলেই আপনার অ্যাপ একটি ট্রিগার বার্তা পাঠায়
  • একসাথে শুধু একটি শিডিউল অ্যাপ সক্রিয় থাকতে পারে

বহু-সক্ষমতার অ্যাপ

একটি অ্যাপ একাধিক সক্ষমতা দিতে পারে। যেমন, একটি টুল ও একটি UI দুটোই আছে এমন একটি ড্যাশবোর্ড অ্যাপ:

{
    "id": "com.example.dashboard",
    "name": "Dashboard",
    "version": "1.0.0",
    "provides": ["tool:dashboard_query", "ui"],
    "permissions": ["network:outbound"]
}
app, _ := nebo.New()
app.RegisterTool(&dashboardTool{})
app.RegisterUI(&dashboardUI{})
log.Fatal(app.Run())

প্যাকেজিং

.napp ফরম্যাট

NeboAI-এর মাধ্যমে বিতরণের জন্য আপনার অ্যাপকে একটি .napp ফাইল (একটি tar.gz আর্কাইভ) হিসেবে প্যাকেজ করুন:

cd com.example.myapp/
tar -czf myapp-1.0.0.napp manifest.json binary signatures.json TOOL.md

আবশ্যক ফাইল:

ফাইলসর্বোচ্চ আকারবিবরণ
manifest.json1 MBঅ্যাপের মেটাডেটা
binary অথবা app500 MBএক্সিকিউটেবল
signatures.json1 MBEd25519 সিগনেচার
TOOL.md1 MBAI কর্মীর জন্য টুলের নির্দেশনা

এক্সট্র্যাকশনের সময় নিরাপত্তার নিয়ম:

  • কোনো পাথ ট্রাভার্সাল নয় (../ প্রত্যাখ্যাত)
  • কোনো সিমলিংক নয় (প্রত্যাখ্যাত)
  • কোনো অ্যাবসোলিউট পাথ নয় (প্রত্যাখ্যাত)
  • শুধু অনুমোদিত তালিকার ফাইলনাম গ্রহণ করা হয়

সিগনেচার

NeboAI Ed25519 দিয়ে অ্যাপ সাইন করে। signatures.json ফরম্যাট:

{
    "key_id": "a1b2c3d4",
    "algorithm": "ed25519",
    "manifest_signature": "<base64 signature of raw manifest.json bytes>",
    "binary_sha256": "<hex SHA256 of binary>",
    "binary_signature": "<base64 signature of raw binary bytes>"
}

ডেভ মোডে (কোনো NeboAI URL কনফিগার করা না থাকলে) সিগনেচার যাচাই পুরোপুরি বাদ দেওয়া হয়। লোকাল ডেভেলপমেন্টের জন্য আপনার signatures.json লাগে না।

প্রকাশ করা

আপনার অ্যাপ লোকালি কাজ করলে, সব Nebo ব্যবহারকারীর কাছে বিতরণের জন্য NeboAI-এর মাধ্যমে প্রকাশ করুন।

ডেভেলপার অ্যাকাউন্ট সেটআপ

  1. POST /api/v1/owners/register-এ একটি NeboAI অ্যাকাউন্ট রেজিস্টার করুন
  2. একটি JWT টোকেন পেতে লগ ইন করুন: POST /api/v1/owners/login
  3. একটি ডেভেলপার অ্যাকাউন্ট তৈরি করুন: POST /api/v1/developer/accounts

জমা দেওয়ার প্রক্রিয়া

draft → pending_review → [approved] → published
                       → [rejected] → draft (fix and resubmit)

ধাপ 1: অ্যাপ তৈরি করুন

curl -X POST https://neboai.com/api/v1/developer/apps \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My App",
    "version": "1.0.0",
    "description": "What it does",
    "category": "productivity",
    "visibility": "public"
  }'

ধাপ 2: প্ল্যাটফর্ম বাইনারি আপলোড করুন

curl -X POST https://neboai.com/api/v1/developer/apps/{id}/binaries \
  -H "Authorization: Bearer $TOKEN" \
  -F "binary=@myapp-darwin-arm64" \
  -F "platform=darwin-arm64"

প্রতিটি প্ল্যাটফর্মের জন্য একটি করে বাইনারি আপলোড করুন: darwin-arm64, darwin-amd64, linux-amd64, linux-arm64।

ধাপ 3: পর্যালোচনার জন্য জমা দিন

curl -X POST https://neboai.com/api/v1/developer/apps/{id}/submit \
  -H "Authorization: Bearer $TOKEN"

পর্যালোচনা প্রক্রিয়া

  1. স্বয়ংক্রিয় স্ক্যান — বাইনারিগুলো VirusTotal দিয়ে স্ক্যান করা হয়
  2. অ্যাডমিন পর্যালোচনা — NeboAI দল মেটাডেটা, ম্যানিফেস্ট ও স্ক্যানের ফলাফল পর্যালোচনা করে
  3. অনুমোদিত হলে — NeboAI অ্যাপটি Ed25519 দিয়ে সাইন করে প্রকাশ করে
  4. প্রত্যাখ্যাত হলে — আপনি একটি কারণ পান এবং ঠিক করে আবার জমা দিতে পারেন

লক্ষ্যমাত্রার পর্যালোচনা সময়: <24 ঘণ্টা।

আপডেট পাঠানো

  1. অ্যাপের সংস্করণ হালনাগাদ করুন: নতুন সংস্করণ দিয়ে PUT /api/v1/developer/apps/{id}
  2. প্রতিটি প্ল্যাটফর্মের জন্য নতুন বাইনারি আপলোড করুন
  3. আবার পর্যালোচনার জন্য জমা দিন

প্রতিটি আপডেট একই পর্যালোচনা প্রক্রিয়ার মধ্য দিয়ে যায়। নতুন সংস্করণ অনুমোদিত না হওয়া পর্যন্ত আগের সংস্করণগুলো উপলব্ধ থাকে।

স্টোরের মেটাডেটা

ফিল্ডবিবরণ
categoryযেমন, productivity, communication, developer-tools
iconঅ্যাপ আইকনের URL
visibilitypublic অথবা private
descriptionম্যানিফেস্টের বিবরণের চেয়ে দীর্ঘ/বিস্তারিত হতে পারে

ডেভ ওয়ার্কফ্লো

লোকাল ডেভেলপমেন্ট

লোকাল ডেভেলপমেন্টের জন্য কোনো প্যাকেজিং লাগে না:

  1. আপনার অ্যাপের ডিরেক্টরি তৈরি করুন:
    mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp
  2. আপনার manifest.json ও কোড লিখুন
  3. আপনার বাইনারি বিল্ড করুন:
    go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary .
  4. Nebo নিজে থেকেই নতুন ডিরেক্টরি শনাক্ত করে (অথবা Nebo রিস্টার্ট করুন)
  5. কোড বদলানোর পর বাইনারি আবার বিল্ড করুন — ফাইল ওয়াচার অ্যাপটি রিস্টার্ট করবে

লগ দেখা

অ্যাপের stdout/stderr প্রতিটি অ্যাপের আলাদা লগ ফাইলে ধরা থাকে:

tail -f ~/Library/Application\ Support/Nebo/apps/com.example.myapp/logs/stdout.log
tail -f ~/Library/Application\ Support/Nebo/apps/com.example.myapp/logs/stderr.log

স্থায়ী ডেটা

আপনার অ্যাপের যে ফাইলগুলো স্থায়ীভাবে রাখা দরকার, সেগুলোর জন্য data/ ডিরেক্টরি ব্যবহার করুন (NEBO_APP_DATA এনভায়রনমেন্ট ভেরিয়েবল হিসেবেও পাওয়া যায়)। এই ডিরেক্টরি অ্যাপ আপডেট ও কোয়ারেন্টাইনের পরেও টিকে থাকে।

ডিবাগিংয়ের টিপস

  • আপনার অ্যাপ চালু না হলে ত্রুটির জন্য logs/stderr.log দেখুন
  • নিশ্চিত করুন যে বাইনারিটি এক্সিকিউটেবল (chmod +x binary)
  • নিশ্চিত করুন যে আপনি NEBO_APP_SOCK-এর Unix সকেট পাথে শুনছেন
  • চালু হওয়ার 10 সেকেন্ডের মধ্যে সকেট প্রস্তুত থাকতে হবে
  • স্টোরেজের জন্য NEBO_APP_DATA ব্যবহার করুন, হার্ডকোড করা পাথ নয়
  • ডিবাগ লগের জন্য stderr-এ প্রিন্ট করুন (logs/stderr.log-এ ধরা থাকে)

যাচাই করা

# List installed apps
nebo apps list

# Check running apps via the web UI Settings > Apps
# Or check the apps directory for running sockets
ls ~/Library/Application\ Support/Nebo/apps/*/app.sock

আনইনস্টল করা

nebo apps uninstall com.example.myapp

দক্ষতা

দক্ষতা কী

দক্ষতা হলো নির্দেশনার সেট, যা কথোপকথনের সময় Nebo-র আচরণ গড়ে দেয়। কোনো দক্ষতা সক্রিয় থাকলে তার কনটেন্ট সরাসরি সিস্টেম প্রম্পটে যুক্ত হয় — সেই সেশনে AI কর্মীর সুর, কাজের পদ্ধতি, বিষয়ভিত্তিক দক্ষতা ও টুল ব্যবহারকে পথ দেখায়।

দক্ষতা কোড নয়। এগুলো YAML মেটাডেটাসহ markdown ডকুমেন্ট। কোনো কম্পাইলেশন নেই, কোনো বাইনারি নেই, কোনো gRPC নেই। একটি দক্ষতা হলো একটি ডিরেক্টরিতে থাকা একটি SKILL.md ফাইল। ব্যস।

দক্ষতা প্রেক্ষাপটনির্ভর ও অস্থায়ী। প্রাসঙ্গিক হলে এগুলো সক্রিয় হয় (ট্রিগার মিলে গেলে বা হাতে লোড করলে), কয়েকটি পালা ধরে থাকে, এবং আর দরকার না হলে মেয়াদ শেষ হয়। এতে AI কর্মীর কনটেক্সট হালকা থাকে — এই মুহূর্তে যে নির্দেশনা দরকার, শুধু সেটুকুই প্রম্পটে থাকে।

দক্ষতা অ্যাপের পরিপূরক। অ্যাপ দেয় চালানোর মতো সক্ষমতা (টুল, চ্যানেল, গেটওয়ে)। দক্ষতা দেয় সমন্বয়ের নির্দেশনা — সেই টুলগুলো কীভাবে কার্যকরভাবে ব্যবহার করতে হয়। একটি ক্যালেন্ডার অ্যাপ Nebo-কে ইভেন্ট পড়া ও লেখার ক্ষমতা দেয়। একটি "মিটিং প্রস্তুতি" দক্ষতা Nebo-কে বলে দেয় সেই ক্যালেন্ডার অ্যাপ, ইমেইল ও ওয়েব সার্চ একসাথে ব্যবহার করে কীভাবে মিটিংয়ের প্রস্তুতি নিতে হয়।

দক্ষতা বনাম অ্যাপ

দক্ষতাঅ্যাপ
ফরম্যাটMarkdown (SKILL.md)কম্পাইল করা বাইনারি (.napp)
রানটাইমসিস্টেম প্রম্পটে যুক্ত হয়gRPC-এর ওপর স্যান্ডবক্সড প্রসেস
যা দেয়আচরণের নির্দেশনা, কাজের পদ্ধতিটুল, চ্যানেল, UI প্যানেল
আয়ুষ্কালসেশনভিত্তিক, TTL অনুযায়ী মেয়াদ শেষসবসময় চলে
তৈরি করাএকটি markdown ফাইল লিখুনলিখুন, কম্পাইল করুন, সাইন করুন, প্যাকেজ করুন
নিরাপত্তাকোনো অনুমতি লাগে নাডিফল্টভাবে নিষেধের স্যান্ডবক্স

দ্রুত শুরু

আপনার Nebo দক্ষতা ফোল্ডারে একটি SKILL.md ফাইলসহ একটি ডিরেক্টরি তৈরি করুন:

~/Library/Application Support/Nebo/skills/   # macOS
~/.config/nebo/skills/                        # Linux
%AppData%\Nebo\skills\                        # Windows
mkdir -p ~/.config/nebo/skills/my-skill

একটি SKILL.md লিখুন:

---
name: my-skill
description: One-line description of what this skill does
version: "1.0.0"
triggers:
  - keyword that activates this skill
  - another trigger phrase
---

# My Skill

Instructions for Nebo when this skill is active.

Tell the agent what to do, how to approach problems,
what tools to use, and what tone to take.

Nebo fsnotify দিয়ে দক্ষতার ডিরেক্টরিতে নজর রাখে। আপনার দক্ষতা সঙ্গে সঙ্গেই উপলব্ধ — রিস্টার্টের দরকার নেই। কোনো ট্রিগারের সাথে মেলে এমন কিছু বলুন, আর এটি নিজে থেকেই সক্রিয় হবে।

অথবা সরাসরি Nebo-কে বলুন: "ব্লগ পোস্ট লেখার জন্য একটি দক্ষতা তৈরি করো" — Nebo আপনার জন্য SKILL.md ফাইলটি লিখে দেবে।

SKILL.md ফরম্যাট

প্রতিটি দক্ষতা হলো দুই অংশের একটিমাত্র SKILL.md ফাইল: --- চিহ্নের মাঝে YAML frontmatter, এবং একটি markdown মূল অংশ (সিস্টেম প্রম্পটে যুক্ত হওয়া আসল নির্দেশনা)।

ফিল্ডআবশ্যকডিফল্টবিবরণ
nameহ্যাঁ—অনন্য শনাক্তকারী (এটিই slug হয়)
descriptionহ্যাঁ—দক্ষতার ক্যাটালগে দেখানো এক লাইনের বিবরণ
versionনা"1.0.0"আপডেট ট্র্যাক করার জন্য Semver
authorনা—দক্ষতার লেখক
priorityনা0বেশি = আগে মেলে (গুরুত্বপূর্ণ ওভাররাইডের জন্য 100+)
max_turnsনা4নিজে থেকে মেয়াদ শেষ হওয়ার আগে কতগুলো নিষ্ক্রিয় পালা
triggersনা[]যে বাক্যাংশগুলো এই দক্ষতা নিজে থেকে সক্রিয় করে (বড়-ছোট হাতের অক্ষর নির্বিশেষে সাবস্ট্রিং মিল)
toolsনা[]এই দক্ষতা যে টুলগুলো ব্যবহার করবে বলে আশা করে (তথ্যের জন্য)
dependenciesনা[]অন্য যে দক্ষতাগুলো ইনস্টল থাকতে হবে
tagsনা[]শ্রেণিবিন্যাস ও খুঁজে পাওয়ার জন্য
platformনা[]সমর্থিত প্ল্যাটফর্ম: macos, linux, windows (ফাঁকা = সব)

দক্ষতা যেভাবে সক্রিয় হয়

দক্ষতা দুই ধাপের সক্রিয়করণ মডেল মেনে চলে: আগে ইঙ্গিত, তারপর চালু।

ধাপ 1: ট্রিগার মেলানো — প্রতিবার ব্যবহারকারী বার্তা পাঠালে Nebo সব রেজিস্টার করা দক্ষতায় ট্রিগারের মিল খোঁজে। মিলে যাওয়া দক্ষতাগুলো সিস্টেম প্রম্পটে ইঙ্গিত হিসেবে দেখা দেয়। AI কর্মী ইঙ্গিতটি দেখে ঠিক করে দক্ষতাটি চালু করবে কি না।

ধাপ 2: চালু করা — AI কর্মী এভাবে কল করে একটি দক্ষতা চালু করে:

skill(name: "code-review")

এটি টুলের ফলাফল হিসেবে পুরো SKILL.md টেমপ্লেট ফেরত দেয়, চালু করার ঘটনাটি রেকর্ড করে, এবং পরের পালাগুলোতে টেমপ্লেটটি আবার সিস্টেম প্রম্পটে যুক্ত করে।

TTL ও মেয়াদ শেষ:

  • নিজে থেকে মেলা দক্ষতা: 4টি নিষ্ক্রিয় পালা (max_turns দিয়ে বদলানো যায়)
  • হাতে লোড করা দক্ষতা: 6টি নিষ্ক্রিয় পালা
  • আবার চালু করলে টাইমার নতুন করে শুরু হয়
  • কঠোর সীমা: প্রতি সেশনে সর্বোচ্চ 4টি সক্রিয় দক্ষতা
  • টোকেন বাজেট: সক্রিয় দক্ষতাগুলোর মোট কনটেন্ট সর্বোচ্চ 16,000 অক্ষর

দক্ষতা পরিচালনা

AI কর্মী skill টুলের মাধ্যমে দক্ষতা পরিচালনা করতে পারে:

অ্যাকশনবিবরণউদাহরণ
catalogসব উপলব্ধ দক্ষতার তালিকা দেখায়skill(action: "catalog")
loadএই সেশনের জন্য সক্রিয় করেskill(name: "code-review", action: "load")
unloadএকটি দক্ষতা নিষ্ক্রিয় করেskill(name: "code-review", action: "unload")
createডিস্কে একটি নতুন দক্ষতা তৈরি করেskill(action: "create", content: "...")
updateএকটি বিদ্যমান দক্ষতা আপডেট করেskill(name: "my-skill", action: "update", content: "...")
deleteডিস্ক থেকে একটি দক্ষতা মুছে ফেলেskill(name: "my-skill", action: "delete")

ভালো দক্ষতা লেখা

একটি ভালো দক্ষতার টেমপ্লেটে থাকে:

  1. একটি স্পষ্ট শিরোনাম — AI কর্মীকে জানায় সে কোন মোডে আছে
  2. মূল নীতি — আচরণের যে নিয়মগুলো নিয়ে কোনো আপস নেই
  3. কাজের পদ্ধতি — সাধারণ পরিস্থিতির জন্য ধাপে ধাপে পন্থা
  4. উদাহরণ — ব্যবহারকারীর বার্তা থেকে উত্তরের সুনির্দিষ্ট নমুনা
  5. ভুল পন্থা — কী করা যাবে না (নেতিবাচক উদাহরণ থেকে মডেলগুলো ভালো শেখে)

টিপ: প্রতিটি দক্ষতার একটি কাজ ভালোভাবে করা উচিত। একটি "সাধারণ প্রোগ্রামিং" দক্ষতা তৈরি করবেন না — code-review, debugging, api-design আলাদা আলাদা দক্ষতা হিসেবে তৈরি করুন। AI কর্মী একসাথে একাধিক দক্ষতা সক্রিয় রাখতে পারে।

অন্তর্ভুক্ত দক্ষতা

Nebo সাধারণ ব্যবহারের ক্ষেত্রগুলোর জন্য কিছু অন্তর্ভুক্ত দক্ষতাসহ আসে:

দক্ষতাঅগ্রাধিকারবিবরণ
onboarding100নতুন ব্যবহারকারীকে স্বাগত জানানো ও প্রোফাইলের তথ্য সংগ্রহ
best-friend50ব্যক্তিত্বের দক্ষতা — সহজ, বিশ্বস্ত, খোলামেলা কথা
debugging25নিয়মতান্ত্রিক ডিবাগিং পদ্ধতি
api-design15RESTful API ডিজাইনের সেরা চর্চা
code-review10গুরুত্বের মাত্রাসহ কাঠামোবদ্ধ কোড রিভিউ
database-expert10ডেটাবেস ডিজাইন, কোয়েরি, অপ্টিমাইজেশন
git-workflow10Git ব্রাঞ্চিং, কমিট, PR ওয়ার্কফ্লো
security-audit10নিরাপত্তা বিশ্লেষণ ও দুর্বলতা শনাক্তকরণ

এগুলো কাজের ডিফল্ট হিসেবে যেমন কাজে লাগে, তেমনি আপনার নিজের দক্ষতা তৈরির জন্য রেফারেন্স হিসেবেও।

রেফারেন্স

Proto ফাইল

Proto ফাইলগুলো থাকে proto/apps/v0/-এ। SDK-গুলো আগে থেকে তৈরি কোডসহ আসে, তাই সাধারণ ডেভেলপমেন্টের জন্য protoc লাগে না।

ফাইলসার্ভিসমূল RPC
v0/common.proto(শুধু মেসেজ)HealthCheckRequest/Response, SettingsMap, UserContext, Empty
v0/tool.protoToolServiceName, Description, Schema, Execute, RequiresApproval, Configure
v0/channel.protoChannelServiceID, Connect, Disconnect, Send, Receive (stream), Configure
v0/comm.protoCommServiceName, Version, Connect, Disconnect, Send, Subscribe, Register, Receive (stream), Configure
v0/gateway.protoGatewayServiceHealthCheck, Stream (stream), Poll, Cancel, Configure
v0/ui.protoUIServiceHealthCheck, HandleRequest, Configure
v0/schedule.protoScheduleServiceHealthCheck, Create, Get, List, Update, Delete, Enable, Disable, Trigger, History, Triggers (stream), Configure

প্রতিটি সার্ভিসে HealthCheck ও Configure RPC থাকে। SDK দুটোই নিজে থেকে সামলায়।

চ্যানেল Proto টাইপ

মেসেজ টাইপবিবরণ
ChannelSendRequestmessage_id, channelId, sender, text, attachments, reply_to, actions, platform_data-সহ যাওয়া বার্তার এনভেলপ
ChannelSendResponseথ্রেডিংয়ের জন্য প্ল্যাটফর্মের মেসেজ ID
InboundMessageসব সাধারণ ফিল্ড + timestamp-সহ আসা বার্তার এনভেলপ
MessageSenderবটের পরিচয় (name, role, botId) — ব্রোকার দ্বারা সমৃদ্ধ করা
Attachmentফাইল/ছবি/অডিও সংযুক্তি (type, url, filename, size)
MessageActionইন্টারঅ্যাক্টিভ বোতাম/কিবোর্ড অ্যাকশন (label, callback_id)

বটের পরিচয় ও ভূমিকা

Nebo বটগুলোর পরিচয় তিনটি অক্ষের মডেলে গড়া:

  • creature — বটটি কী (আদিরূপ): "তীক্ষ্ণবুদ্ধির কৌশলবিদ", "খুঁটিনাটিতে মনোযোগী গবেষক"
  • role — ব্যবহারকারীর সাথে তার সম্পর্ক: "বন্ধু", "COO", "মেন্টর"
  • vibe — তার মেজাজ (যোগাযোগের ধরন): "শান্ত কিন্তু নিজস্ব মতামতওয়ালা", "আন্তরিক ও উৎসাহদায়ী"

আপনার চ্যানেল প্লাগইন যাওয়ার বার্তা পেলে sender ফিল্ডে বটের name ও role থাকে। আপনার প্ল্যাটফর্মের জন্য প্রদর্শিত নাম সাজাতে এটি ব্যবহার করুন। role কোনো পদবি নয় — এটি সম্পর্কের বর্ণনা। "COO" ও "DevLead"-এর পাশাপাশি "বন্ধু", "ছেলে" ও "মেন্টর"-ও বৈধ role।