সংক্ষিপ্ত বিবরণ
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) ন্যূনতম অ্যাপের চেকলিস্ট
id,name,version,providesদিয়েmanifest.jsonতৈরি করুন- AI কর্মী কীভাবে আপনার টুল ব্যবহার করবে, তা বর্ণনা করে
TOOL.mdলিখুন - SDK ইনস্টল করুন (
go get github.com/neboloop/nebo-sdk-go) - আপনার সক্ষমতার জন্য হ্যান্ডলার ইন্টারফেস ইমপ্লিমেন্ট করুন (
ToolHandler,ChannelHandlerইত্যাদি) - হ্যান্ডলারটি রেজিস্টার করুন এবং
app.Run()কল করুন - একটি নেটিভ বাইনারি বিল্ড করুন (
go build -o binary .) - বাইনারি + manifest.json + TOOL.md রাখুন
apps/<your-app-id>/ডিরেক্টরিতে - 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 | মানুষের পড়ার উপযোগী নাম |
version | Semver স্ট্রিং |
provides | অন্তত একটি সক্ষমতা (নিচে দেখুন) |
ঐচ্ছিক ফিল্ড:
| ফিল্ড | ডিফল্ট | বিবরণ |
|---|---|---|
runtime | "local" | "local" অথবা "remote" |
protocol | "grpc" | শুধু "grpc" সমর্থিত |
permissions | [] | অ্যাপের কীসে অ্যাক্সেস দরকার |
description | "" | UI-তে দেখানো হয় |
settings | [] | কনফিগারযোগ্য সেটিংস (সেটিংস UI-তে দেখানো হয়) |
oauth | [] | OAuth প্রদানকারীর প্রয়োজনীয়তা (নিচে OAuth অংশ দেখুন) |
সক্ষমতা
আপনার অ্যাপ কী দেয়, তা ঘোষণা করুন:
| সক্ষমতা | gRPC সার্ভিস | বিবরণ |
|---|---|---|
gateway | GatewayService | LLM মডেল রাউটিং |
tool:<name> | ToolService | AI কর্মীর জন্য একটি নামযুক্ত টুল |
channel:<name> | ChannelService | একটি মেসেজিং চ্যানেল |
comm | CommService | AI কর্মীদের মধ্যে যোগাযোগ |
ui | UIService | HTTP প্রক্সিসহ কাস্টম UI |
schedule | ScheduleService | কাস্টম সময়সূচি |
vision | ToolService | ভিশন প্রসেসিং |
browser | ToolService | ব্রাউজার অটোমেশন |
একটি অ্যাপ একাধিক সক্ষমতা দিতে পারে। যেমন, একটি অ্যাপ একটি টুল এবং একটি UI প্যানেল দুটোই দিতে পারে।
অনুমতি
অনুমতি ঠিক করে অ্যাপটি কীসে অ্যাক্সেস পাবে। ডিফল্টভাবে নিষেধ — ঘোষণা না করলে অ্যাপ সেটি ব্যবহার করতে পারে না।
| প্রিফিক্স | উদাহরণ | বিবরণ |
|---|---|---|
network: | network:outbound, network:* | নেটওয়ার্ক অ্যাক্সেস |
filesystem: | filesystem:read, filesystem:write | ফাইল সিস্টেম অ্যাক্সেস |
memory: | memory:read, memory:write | AI কর্মীর স্মৃতিতে অ্যাক্সেস |
session: | session:read | কথোপকথনের সেশন |
tool: | tool:shell, tool:file | অন্যান্য টুল ব্যবহার |
shell: | shell:exec | শেল কমান্ড চালানো |
channel: | channel:send, channel:* | চ্যানেলের কাজ |
comm: | comm:send, comm:* | AI কর্মীদের মধ্যে যোগাযোগ |
model: | model:chat | AI মডেলে অ্যাক্সেস |
user: | user:token | অনুরোধে ব্যবহারকারীর JWT পাওয়া |
schedule: | schedule:create | Cron জব ব্যবস্থাপনা |
database: | database:query | ডেটাবেস অ্যাক্সেস |
storage: | storage:read, storage:write | স্থায়ী স্টোরেজ |
context: | context:read | AI কর্মীর প্রেক্ষাপটে অ্যাক্সেস |
subagent: | subagent:spawn | সাব-এজেন্টের কাজ |
lane: | lane:enqueue | লেনের কাজ |
notification: | notification:send | পুশ নোটিফিকেশন |
embedding: | embedding:search | ভেক্টর এমবেডিংয়ে অ্যাক্সেস |
skill: | skill:invoke | দক্ষতা চালু করা |
advisor: | advisor:consult | অ্যাডভাইজার সিস্টেমে অ্যাক্সেস |
mcp: | mcp:connect | MCP সার্ভারে অ্যাক্সেস |
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"]
}
]
} | ফিল্ড | বিবরণ |
|---|---|
provider | OAuth প্রদানকারী: "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 সেকেন্ড অপেক্ষা করে।
অ্যাপ চালু হওয়ার ক্রম
- Nebo
manifest.jsonপড়ে এবং যাচাই করে - অ্যাপ ডিরেক্টরিতে
binaryবাappএক্সিকিউটেবল খুঁজে বের করে .quarantinedচিহ্ন আছে কি না দেখে (কোয়ারেন্টাইন করা অ্যাপ চালু করতে অস্বীকার করে)- বাতিলকরণ যাচাই (শুধু NeboAI-এর বিতরণ করা অ্যাপের জন্য)
- সিগনেচার যাচাই (শুধু NeboAI-এর বিতরণ করা অ্যাপের জন্য, ডেভ মোডে বাদ দেওয়া হয়)
- বাইনারি যাচাই (সিমলিংক, স্ক্রিপ্ট, নন-এক্সিকিউটেবল ও অতিরিক্ত বড় ফাইল প্রত্যাখ্যান করে)
- আগের রান থেকে থেকে যাওয়া পুরোনো সকেট পরিষ্কার করে
- স্যান্ডবক্সড স্টোরেজের জন্য
data/ডিরেক্টরি তৈরি করে - প্রতিটি অ্যাপের আলাদা লগ ফাইল সেট আপ করে (
logs/stdout.log,logs/stderr.log) - পরিষ্কার করা এনভায়রনমেন্ট ও প্রসেস গ্রুপ আইসোলেশনসহ বাইনারি চালু করে
- Unix সকেট দেখা দেওয়ার জন্য অপেক্ষা করে (এক্সপোনেনশিয়াল ব্যাকঅফ, সর্বোচ্চ 10 সেকেন্ড)
- Unix সকেটের ওপর দিয়ে gRPC-এর মাধ্যমে সংযুক্ত হয়
provides-এর ভিত্তিতে সক্ষমতা-নির্দিষ্ট gRPC ক্লায়েন্ট তৈরি করে- হেলথ চেক চালায়
- 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") স্কিমার নিয়ম:
- সবসময় একটি
actionফিল্ড রাখুন, আবশ্যক স্ট্রিং enum হিসেবে resourceফিল্ড (আবশ্যক স্ট্রিং enum) যোগ করুন শুধু তখনই, যখন আপনার টুল একাধিক আলাদা ধরনের রিসোর্স সামলায়- বাকি সব ফিল্ড অ্যাকশন-নির্দিষ্ট প্যারামিটার
actionenum-এর বিবরণে সব উপলব্ধ অ্যাকশনের তালিকা থাকা উচিত
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 কল করে।
এটি যেভাবে কাজ করে
- আপনার চ্যানেলের অনন্য শনাক্তকারী পেতে Nebo
ID()কল করে - আপনার অ্যাপের সেটিংসের কনফিগসহ Nebo
Connect()কল করে - Nebo একটি
Receive()স্ট্রিম খোলে — কোনো ব্যবহারকারী বটকে বার্তা পাঠালেই আপনার অ্যাপ আসা বার্তাগুলো পাঠায় - আসা বার্তাগুলো AI কর্মীর মূল কথোপকথন লেনে পাঠানো হয়
- AI কর্মী বার্তা পাঠাতে চাইলে Nebo v1 মেসেজ এনভেলপসহ
Send()কল করে - বন্ধ হওয়ার সময় 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_id | UUID v7 | সময়ক্রম অনুযায়ী অনন্য ID |
channel_id | {type}:{platform_id} | রাউট করা যায় এমন চ্যানেল শনাক্তকারী |
sender | object | বটের পরিচয় — নাম, ভূমিকা, botId |
text | string | বার্তার মূল অংশ |
attachments | array | ফাইল, ছবি, অডিও |
reply_to | UUID v7 | থ্রেডিংয়ের জন্য মূল বার্তার ID |
actions | array | ইন্টারঅ্যাক্টিভ বোতাম/কিবোর্ড |
platform_data | bytes | প্ল্যাটফর্ম-নির্দিষ্ট ফিচারের জন্য অস্বচ্ছ পাসথ্রু |
timestamp | ISO 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.json | 1 MB | অ্যাপের মেটাডেটা |
binary অথবা app | 500 MB | এক্সিকিউটেবল |
signatures.json | 1 MB | Ed25519 সিগনেচার |
TOOL.md | 1 MB | AI কর্মীর জন্য টুলের নির্দেশনা |
এক্সট্র্যাকশনের সময় নিরাপত্তার নিয়ম:
- কোনো পাথ ট্রাভার্সাল নয় (
../প্রত্যাখ্যাত) - কোনো সিমলিংক নয় (প্রত্যাখ্যাত)
- কোনো অ্যাবসোলিউট পাথ নয় (প্রত্যাখ্যাত)
- শুধু অনুমোদিত তালিকার ফাইলনাম গ্রহণ করা হয়
সিগনেচার
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-এর মাধ্যমে প্রকাশ করুন।
ডেভেলপার অ্যাকাউন্ট সেটআপ
POST /api/v1/owners/register-এ একটি NeboAI অ্যাকাউন্ট রেজিস্টার করুন- একটি JWT টোকেন পেতে লগ ইন করুন:
POST /api/v1/owners/login - একটি ডেভেলপার অ্যাকাউন্ট তৈরি করুন:
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" পর্যালোচনা প্রক্রিয়া
- স্বয়ংক্রিয় স্ক্যান — বাইনারিগুলো VirusTotal দিয়ে স্ক্যান করা হয়
- অ্যাডমিন পর্যালোচনা — NeboAI দল মেটাডেটা, ম্যানিফেস্ট ও স্ক্যানের ফলাফল পর্যালোচনা করে
- অনুমোদিত হলে — NeboAI অ্যাপটি Ed25519 দিয়ে সাইন করে প্রকাশ করে
- প্রত্যাখ্যাত হলে — আপনি একটি কারণ পান এবং ঠিক করে আবার জমা দিতে পারেন
লক্ষ্যমাত্রার পর্যালোচনা সময়: <24 ঘণ্টা।
আপডেট পাঠানো
- অ্যাপের সংস্করণ হালনাগাদ করুন: নতুন সংস্করণ দিয়ে
PUT /api/v1/developer/apps/{id} - প্রতিটি প্ল্যাটফর্মের জন্য নতুন বাইনারি আপলোড করুন
- আবার পর্যালোচনার জন্য জমা দিন
প্রতিটি আপডেট একই পর্যালোচনা প্রক্রিয়ার মধ্য দিয়ে যায়। নতুন সংস্করণ অনুমোদিত না হওয়া পর্যন্ত আগের সংস্করণগুলো উপলব্ধ থাকে।
স্টোরের মেটাডেটা
| ফিল্ড | বিবরণ |
|---|---|
category | যেমন, productivity, communication, developer-tools |
icon | অ্যাপ আইকনের URL |
visibility | public অথবা private |
description | ম্যানিফেস্টের বিবরণের চেয়ে দীর্ঘ/বিস্তারিত হতে পারে |
ডেভ ওয়ার্কফ্লো
লোকাল ডেভেলপমেন্ট
লোকাল ডেভেলপমেন্টের জন্য কোনো প্যাকেজিং লাগে না:
- আপনার অ্যাপের ডিরেক্টরি তৈরি করুন:
mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp - আপনার
manifest.jsonও কোড লিখুন - আপনার বাইনারি বিল্ড করুন:
go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary . - Nebo নিজে থেকেই নতুন ডিরেক্টরি শনাক্ত করে (অথবা Nebo রিস্টার্ট করুন)
- কোড বদলানোর পর বাইনারি আবার বিল্ড করুন — ফাইল ওয়াচার অ্যাপটি রিস্টার্ট করবে
লগ দেখা
অ্যাপের 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") |
ভালো দক্ষতা লেখা
একটি ভালো দক্ষতার টেমপ্লেটে থাকে:
- একটি স্পষ্ট শিরোনাম — AI কর্মীকে জানায় সে কোন মোডে আছে
- মূল নীতি — আচরণের যে নিয়মগুলো নিয়ে কোনো আপস নেই
- কাজের পদ্ধতি — সাধারণ পরিস্থিতির জন্য ধাপে ধাপে পন্থা
- উদাহরণ — ব্যবহারকারীর বার্তা থেকে উত্তরের সুনির্দিষ্ট নমুনা
- ভুল পন্থা — কী করা যাবে না (নেতিবাচক উদাহরণ থেকে মডেলগুলো ভালো শেখে)
টিপ: প্রতিটি দক্ষতার একটি কাজ ভালোভাবে করা উচিত। একটি "সাধারণ প্রোগ্রামিং" দক্ষতা তৈরি করবেন না — code-review, debugging, api-design আলাদা আলাদা দক্ষতা হিসেবে তৈরি করুন। AI কর্মী একসাথে একাধিক দক্ষতা সক্রিয় রাখতে পারে।
অন্তর্ভুক্ত দক্ষতা
Nebo সাধারণ ব্যবহারের ক্ষেত্রগুলোর জন্য কিছু অন্তর্ভুক্ত দক্ষতাসহ আসে:
| দক্ষতা | অগ্রাধিকার | বিবরণ |
|---|---|---|
onboarding | 100 | নতুন ব্যবহারকারীকে স্বাগত জানানো ও প্রোফাইলের তথ্য সংগ্রহ |
best-friend | 50 | ব্যক্তিত্বের দক্ষতা — সহজ, বিশ্বস্ত, খোলামেলা কথা |
debugging | 25 | নিয়মতান্ত্রিক ডিবাগিং পদ্ধতি |
api-design | 15 | RESTful API ডিজাইনের সেরা চর্চা |
code-review | 10 | গুরুত্বের মাত্রাসহ কাঠামোবদ্ধ কোড রিভিউ |
database-expert | 10 | ডেটাবেস ডিজাইন, কোয়েরি, অপ্টিমাইজেশন |
git-workflow | 10 | Git ব্রাঞ্চিং, কমিট, PR ওয়ার্কফ্লো |
security-audit | 10 | নিরাপত্তা বিশ্লেষণ ও দুর্বলতা শনাক্তকরণ |
এগুলো কাজের ডিফল্ট হিসেবে যেমন কাজে লাগে, তেমনি আপনার নিজের দক্ষতা তৈরির জন্য রেফারেন্স হিসেবেও।
রেফারেন্স
Proto ফাইল
Proto ফাইলগুলো থাকে proto/apps/v0/-এ। SDK-গুলো আগে থেকে তৈরি কোডসহ আসে, তাই সাধারণ ডেভেলপমেন্টের জন্য protoc লাগে না।
| ফাইল | সার্ভিস | মূল RPC |
|---|---|---|
v0/common.proto | (শুধু মেসেজ) | HealthCheckRequest/Response, SettingsMap, UserContext, Empty |
v0/tool.proto | ToolService | Name, Description, Schema, Execute, RequiresApproval, Configure |
v0/channel.proto | ChannelService | ID, Connect, Disconnect, Send, Receive (stream), Configure |
v0/comm.proto | CommService | Name, Version, Connect, Disconnect, Send, Subscribe, Register, Receive (stream), Configure |
v0/gateway.proto | GatewayService | HealthCheck, Stream (stream), Poll, Cancel, Configure |
v0/ui.proto | UIService | HealthCheck, HandleRequest, Configure |
v0/schedule.proto | ScheduleService | HealthCheck, Create, Get, List, Update, Delete, Enable, Disable, Trigger, History, Triggers (stream), Configure |
প্রতিটি সার্ভিসে HealthCheck ও Configure RPC থাকে। SDK দুটোই নিজে থেকে সামলায়।
চ্যানেল Proto টাইপ
| মেসেজ টাইপ | বিবরণ |
|---|---|
ChannelSendRequest | message_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।