نمای کلی
Nebo چیست
Nebo یک دستیار هوش مصنوعی شخصی روی رایانه است — یک کارمند هوش مصنوعی همیشه در حال اجرا که زندگی دیجیتال شما را مدیریت میکند. Nebo را همانطور ببینید که یک گوشی هوشمند را میبینید: پلتفرمی قدرتمند که با برنامههایش متحولکننده میشود.
Nebo بهتنهایی یک کارمند هوش مصنوعی توانمند با حافظه، زمانبندی، مرور وب، مدیریت فایل و دسترسی به shell است. اما کلید اصلی، برنامهها هستند. همانطور که قدرت گوشی هوشمند از اکوسیستم برنامههایش میآید، قدرت Nebo هم از برنامههایی میآید که تواناییهایش را گسترش میدهند.
برنامهها چه هستند
برنامههای Nebo واحدهای مستقل و از پیش کامپایلشدهای با کارایی فوقالعادهاند. هر برنامه یک ابرقدرت تازه به Nebo میدهد — مدیریت تقویم، دستهبندی ایمیل، پیگیری پروژه، خودکارسازی خانه، تحلیل مالی — هر چه یک توسعهدهنده تصورش را بکند.
برنامهها قدرت فوقالعادهای را به شکلی بسیار امن فراهم میکنند. هر برنامه در یک sandbox با مجوزهایی که بهطور پیشفرض رد میشوند اجرا میشود. فقط به چیزهایی دسترسی دارد که manifest آن اعلام کرده و کاربر تأیید کرده است.
رابط کاربری ۱۰۰٪ گفتگومحور است. کاربران از طریق صفحهها یا داشبوردهای جداگانه با برنامهها کار نمیکنند. با Nebo حرف میزنند و Nebo از ابزارهای برنامه برای انجام کارها استفاده میکند. «فردا در تقویمم چه دارم؟» — Nebo برنامه تقویم را فرا میخواند. «یک جلسه با Sarah ساعت ۳ بعدازظهر بساز» — Nebo برنامه تقویم را فرا میخواند. کاربر هرگز از گفتگو بیرون نمیرود.
برنامهها میتوانند بهدلخواه یک رابط تنظیمات داشته باشند — پنل پیکربندیای که در پنجره مرورگر داخلی Nebo باز میشود. اینجا کاربران کلیدهای API را وارد میکنند، قابلیتها را روشن و خاموش میکنند و برنامه را پیکربندی میکنند. رابط تنظیمات بر اساس آرایه settings در manifest ساخته میشود (Nebo فرم را خودکار نمایش میدهد)، یا برنامه میتواند از طریق قابلیت ui رابط کاربری کاملاً سفارشی خودش را ارائه دهد.
برنامهها قابلیتهای داخلی Nebo را جایگزین و گسترش میدهند. Nebo با ابزارهای پایه پلتفرم عرضه میشود (دسترسی به تقویم محلی، اسکرینشات و غیره). وقتی یک برنامه تقویم نصب میکنید، جایگزین ابزار تقویم داخلی میشود و مجموعهای کاملتر از آن میشود — محلی + ابری + تجمیع + بررسی زمانهای آزاد.
سیاست فقط کامپایلشده
Nebo یک سیاست سختگیرانه برای فایلهای اجرایی فقط کامپایلشده اعمال میکند. همه برنامهها باید فایلهای اجرایی بومی کامپایلشده باشند.
| وضعیت | زبانها |
|---|---|
| پشتیبانیشده | Go (پیشنهادی)، Rust، C/C++، Zig |
| ردشده | Python، Node.js، Ruby، Java، .NET، اسکریپتهای shell |
دلیل:
- جلوگیری از تغییر خودسرانه توسط هوش مصنوعی — یک کارمند هوش مصنوعی با دسترسی به shell میتواند رفتار یک اسکریپت تفسیری را در زمان اجرا تغییر دهد. فایلهای اجرایی کامپایلشده پس از امضا تغییرناپذیرند.
- یکپارچگی امضا — امضاهای Ed25519 بایتهای خام فایل اجرایی را پوشش میدهند. یک فایل اجرایی امضاشده را نمیتوان بدون باطل شدن امضا تغییر داد.
- اعمال sandbox — اعتبارسنجی قالب فایل اجرایی (magic byteهای ELF/Mach-O/PE) دروازهای سریع و قابل اعتماد است.
شروع سریع
نصب SDK
SDKهای رسمی همه راهاندازی سرور gRPC، مدیریت سیگنالها و پلزدن پروتکل را انجام میدهند. شما فقط interfaceهای handler را پیادهسازی میکنید.
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/ ساختار پوشه برنامه
برنامهها در زیرپوشه apps/ از پوشه دادههای Nebo شما قرار میگیرند:
~/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) چکلیست حداقلی برنامه
- فایل
manifest.jsonرا باid،name،versionوprovidesبسازید - فایل
TOOL.mdرا بنویسید و توضیح دهید کارمند هوش مصنوعی چطور باید از ابزار شما استفاده کند - SDK را نصب کنید (
go get github.com/neboloop/nebo-sdk-go) - interface مربوط به handler را برای قابلیت خود پیادهسازی کنید (
ToolHandler،ChannelHandlerو غیره) - handler را ثبت کنید و
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 | "" | در رابط کاربری نمایش داده میشود |
settings | [] | تنظیمات قابل پیکربندی (در رابط تنظیمات نمایش داده میشوند) |
oauth | [] | نیازمندیهای ارائهدهنده OAuth (بخش OAuth را در ادامه ببینید) |
قابلیتها
اعلام کنید برنامهتان چه چیزی ارائه میدهد:
| قابلیت | سرویس gRPC | توضیح |
|---|---|---|
gateway | GatewayService | مسیریابی مدل LLM |
tool:<name> | ToolService | یک ابزار نامدار برای کارمند هوش مصنوعی |
channel:<name> | ChannelService | یک کانال پیامرسانی |
comm | CommService | ارتباط بین کارمندان هوش مصنوعی |
ui | UIService | رابط کاربری سفارشی با پراکسی HTTP |
schedule | ScheduleService | زمانبندی سفارشی |
vision | ToolService | پردازش تصویر |
browser | ToolService | خودکارسازی مرورگر |
یک برنامه میتواند چند قابلیت ارائه دهد. مثلاً یک برنامه میتواند هم یک ابزار و هم یک پنل رابط کاربری ارائه دهد.
مجوزها
مجوزها تعیین میکنند برنامه به چه چیزهایی دسترسی دارد. بهطور پیشفرض رد — اگر اعلام نشده باشد، برنامه نمیتواند از آن استفاده کند.
| پیشوند | نمونهها | توضیح |
|---|---|---|
network: | network:outbound، network:* | دسترسی به شبکه |
filesystem: | filesystem:read، filesystem:write | دسترسی به سیستم فایل |
memory: | memory:read، memory:write | دسترسی به حافظه کارمند هوش مصنوعی |
session: | session:read | جلسههای گفتگو |
tool: | tool:shell، tool:file | استفاده از ابزارهای دیگر |
shell: | shell:exec | اجرای فرمانهای shell |
channel: | channel:send، channel:* | عملیات کانال |
comm: | comm:send، comm:* | ارتباط بین کارمندان هوش مصنوعی |
model: | model:chat | دسترسی به مدل هوش مصنوعی |
user: | user:token | دریافت JWT کاربر در درخواستها |
schedule: | schedule:create | مدیریت کارهای cron |
database: | database:query | دسترسی به پایگاه داده |
storage: | storage:read، storage:write | ذخیرهسازی ماندگار |
context: | context:read | دسترسی به بستر کارمند هوش مصنوعی |
subagent: | subagent:spawn | عملیات زیرایجنت |
lane: | lane:enqueue | عملیات lane |
notification: | notification:send | اعلانهای push |
embedding: | embedding:search | دسترسی به embeddingهای برداری |
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 | ثبت قابلیت |
مجوزهای wildcard پشتیبانی میشوند: network:* با هر بررسی مجوز network: مطابقت دارد.
تنظیمات
تنظیمات در رابط کاربری Nebo، در پنل تنظیمات برنامه نمایش داده میشوند. Nebo آنها را در پایگاه داده ذخیره میکند و هر وقت تغییر کنند، از طریق RPC Configure برای برنامه شما میفرستد.
طرحواره تنظیمات شما در صفحه برنامه در فروشگاه NeboAI آورده میشود. برنامههایی که تنظیمات الزامی پیکربندینشده دارند، در رابط کاربری نشان «نیاز به راهاندازی» میگیرند.
| نوع | توضیح |
|---|---|
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 را اعلام کنند. کارگزار OAuth در Nebo کل جریان را مدیریت میکند — برنامهها توکنها را خودکار از طریق RPC Configure دریافت میکنند.
{
"oauth": [
{
"provider": "google",
"scopes": ["https://www.googleapis.com/auth/calendar"]
}
]
} | فیلد | توضیح |
|---|---|
provider | ارائهدهنده OAuth: "google"، "microsoft"، "github" |
scopes | آرایهای از scopeهای OAuth که برنامه لازم دارد |
وقتی کاربر برنامه را نصب میکند، Nebo از او میخواهد scopeهای OAuth لازم را مجاز کند. برنامه توکنهای تازهشده را از طریق RPC Configure دریافت میکند، بدون اینکه خودش جریان OAuth را مدیریت کند.
متغیرهای محیطی
فرایند برنامه شما یک محیط پاکسازیشده دریافت میکند. همه اطلاعات محرمانه حذف میشوند. آنچه دریافت میکنید:
| متغیر | مقدار |
|---|---|
NEBO_APP_DIR | پوشه نصب برنامه |
NEBO_APP_SOCK | مسیر سوکت Unix که باید ساخته شود |
NEBO_APP_ID | شناسه برنامه از manifest |
NEBO_APP_NAME | نام برنامه از manifest |
NEBO_APP_VERSION | نسخه برنامه از manifest |
NEBO_APP_DATA | مسیر پوشه data/ برنامه |
PATH | PATH سیستم (بدون تغییر منتقل میشود) |
HOME | پوشه خانگی کاربر (بدون تغییر منتقل میشود) |
TMPDIR | پوشه موقت (بدون تغییر منتقل میشود) |
مهم: فایل اجرایی شما باید یک سرور gRPC بسازد که روی سوکت Unix در NEBO_APP_SOCK گوش بدهد. Nebo تا ۱۰ ثانیه منتظر ظاهر شدن این سوکت میماند.
ترتیب اجرای برنامه
- Nebo فایل
manifest.jsonرا میخواند و اعتبارسنجی میکند - فایل اجرایی
binaryیاappرا در پوشه برنامه پیدا میکند - نشانگر
.quarantinedرا بررسی میکند (برنامههای قرنطینهشده را اجرا نمیکند) - بررسی ابطال (فقط برنامههایی که NeboAI توزیع میکند)
- تأیید امضا (فقط برنامههایی که NeboAI توزیع میکند، در حالت توسعه رد میشود)
- اعتبارسنجی فایل اجرایی (symlinkها، اسکریپتها، فایلهای غیراجرایی و فایلهای بیش از حد بزرگ رد میشوند)
- سوکت باقیمانده از اجرای قبلی را پاک میکند
- پوشه
data/را برای ذخیرهسازی در sandbox میسازد - فایلهای لاگ مخصوص هر برنامه را راهاندازی میکند (
logs/stdout.log،logs/stderr.log) - فایل اجرایی را با محیط پاکسازیشده و ایزولهسازی گروه فرایند اجرا میکند
- منتظر ظاهر شدن سوکت Unix میماند (backoff نمایی، حداکثر ۱۰ ثانیه)
- از طریق gRPC روی سوکت Unix وصل میشود
- کلاینتهای gRPC مخصوص هر قابلیت را بر اساس
providesمیسازد - بررسی سلامت را اجرا میکند
- قابلیتها را نزد کارمند هوش مصنوعی ثبت میکند (ابزارها، درگاه، comm و غیره)
برنامههای ابزار
در manifest خود "provides": ["tool:my_tool_name"] را اعلام کنید.
الگوی STRAP
همه برنامههای ابزار Nebo باید برای طرحواره و مسیریابی اجرای خود از STRAP (Single Tool Resource Action Pattern) استفاده کنند. این همان الگویی است که Nebo در داخل برای ادغام بیش از ۳۵ ابزار جداگانه در ۴ ابزار دامنهای به کار میبرد — و سربار بستر LLM را حدود ۸۰٪ کم میکند.
ایده اصلی: بهجای ثبت چند ابزار (get_events، check_availability، suggest_slots)، یک ابزار با فیلدهای action (و در صورت نیاز resource) ثبت کنید که به handler درست هدایت میکنند.
نمونه تکمنبعی (تقویم):
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 رشتهای الزامی) را فقط وقتی اضافه کنید که ابزارتان چند نوع منبع متمایز را مدیریت میکند - همه فیلدهای دیگر پارامترهای مخصوص هر action هستند
- توضیح enum مربوط به
actionباید همه actionهای موجود را فهرست کند
چرا STRAP مهم است:
- LLMها الگوی مسیریابی
actionرا یک بار یاد میگیرند و به همه عملیات تعمیم میدهند - تعریف ابزارها حدود ۶٪ از بستر را مصرف میکند — STRAP آن را ۸۰٪ کم میکند
- عملیات تازه فقط افزودنی به 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 وصل میکنند. وقتی کاربری در پلتفرم بیرونی پیامی میفرستد، برنامه شما آن را از طریق Receive به Nebo استریم میکند. وقتی کارمند هوش مصنوعی میخواهد پاسخ دهد، Nebo تابع Send برنامه شما را فرا میخواند.
چطور کار میکند
- Nebo تابع
ID()را فرا میخواند تا شناسه یکتای کانال شما را بگیرد - Nebo تابع
Connect()را با پیکربندیای از تنظیمات برنامه شما فرا میخواند - Nebo یک استریم
Receive()باز میکند — هر وقت کاربری به بات پیام بدهد، برنامه شما پیامهای ورودی را میفرستد - پیامهای ورودی به lane اصلی گفتگوی کارمند هوش مصنوعی هدایت میشوند
- وقتی کارمند هوش مصنوعی میخواهد پیامی بفرستد، Nebo تابع
Send()را با پاکت پیام v1 فرا میخواند - هنگام خاموش شدن، 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 | شناسه یکتای مرتب بر اساس زمان |
channel_id | {type}:{platform_id} | شناسه کانال قابل مسیریابی |
sender | object | هویت بات — name، role، botId |
text | string | متن پیام |
attachments | array | فایلها، تصاویر، صدا |
reply_to | UUID v7 | شناسه پیام والد برای رشتهبندی |
actions | array | دکمهها/صفحهکلیدهای تعاملی |
platform_data | bytes | انتقال بدون تغییر برای قابلیتهای مخصوص پلتفرم |
timestamp | ISO 8601 | ناشر این را تعیین میکند |
طراحی دولایه: فیلدهای مشترک (text، attachments، reply_to، actions) ۹۰٪ پیامهایی را که کارمند آغاز میکند پوشش میدهند. قابلیتهای مخصوص پلتفرم در 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 ارتباط بین کارمندان هوش مصنوعی را ممکن میکنند.
| فیلد | توضیح |
|---|---|
from | شناسه کارمند فرستنده |
to | شناسه کارمند گیرنده |
topic | موضوع/کانال پیام |
type | "message"، "mention"، "proposal"، "command"، "info"، "task" |
content | متن پیام |
رفتارهای کلیدی:
Registerاین کارمند هوش مصنوعی را همراه با قابلیتهایش در شبکه معرفی میکندSubscribe/Unsubscribeاشتراک در موضوعها را مدیریت میکنندReceiveپیامهای ورودی را استریم میکند (استریم از سمت سرور، مثل کانالها)- در هر زمان فقط یک برنامه Comm میتواند فعال باشد
برنامه Gateway
یک برنامه Gateway درخواستهای 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 در manifest شما میسازد)، برنامه UI رابط کاربری کامل HTML/CSS/JS خودش را ارائه میکند.
برنامه شما یک پوشه ui/ با فایلهای وب ایستا (HTML، CSS، JS — معمولاً یک SPA با index.html) همراه دارد. 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 استاندارد را در بر میگیرد، پس شما handlerهای HTTP معمولی Go مینویسید — SDK پلزدن gRPC را خودکار انجام میدهد.
نمونه Go — رابط داشبورد:
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 شما فراخوانیهای fetch را به /api/v1/apps/com.example.dashboard/api/status میفرستد که به handler mux شما پراکسی میشوند.
برنامه Schedule
برنامه Schedule جایگزین زمانبند cron داخلی Nebo میشود. "provides": ["schedule"] و "permissions": ["schedule:create"] را اعلام کنید.
وقتی برنامه Schedule شما اجرا شود، Nebo همه زمانبندیها را بهجای موتور cron پیشفرض از طریق برنامه شما انجام میدهد. اگر برنامهتان از کار بیفتد، Nebo خودکار به موتور داخلی برمیگردد.
- برنامه شما مالک وضعیت زمانبندی است — وقتی یک برنامه Schedule فعال است، Nebo زمانبندیها را در پایگاه داده خودش ذخیره نمیکند
- CRUD استاندارد:
Create،Get،List،Update،Delete،Enable،Disable Triggersیک RPC با استریم از سمت سرور است — هر وقت زمانبندیای فعال شود، برنامه شما یک پیام trigger میفرستد- در هر زمان فقط یک برنامه Schedule میتواند فعال باشد
برنامههای چندقابلیتی
یک برنامه میتواند چند قابلیت ارائه دهد. مثلاً یک برنامه داشبورد که هم ابزار دارد و هم رابط کاربری:
{
"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 | دستورالعملهای ابزار برای کارمند هوش مصنوعی |
قواعد امنیتی هنگام استخراج:
- بدون پیمایش مسیر (
../رد میشود) - بدون symlink (رد میشود)
- بدون مسیر مطلق (رد میشود)
- فقط نام فایلهای مجاز پذیرفته میشوند
امضاها
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>"
} در حالت توسعه (وقتی هیچ URL مربوط به NeboAI پیکربندی نشده باشد)، تأیید امضا کاملاً کنار گذاشته میشود. برای توسعه محلی به signatures.json نیازی ندارید.
انتشار
وقتی برنامهتان بهصورت محلی کار کرد، آن را از طریق NeboAI منتشر کنید تا به دست همه کاربران Nebo برسد.
راهاندازی حساب توسعهدهنده
- یک حساب NeboAI در
POST /api/v1/owners/registerثبت کنید - برای گرفتن توکن JWT وارد شوید:
POST /api/v1/owners/login - یک حساب توسعهدهنده بسازید:
POST /api/v1/developer/accounts
روند ارسال
draft → pending_review → [approved] → published
→ [rejected] → draft (fix and resubmit) مرحله ۱: ساختن برنامه
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"
}' مرحله ۲: بارگذاری فایلهای اجرایی پلتفرمها
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.
مرحله ۳: ارسال برای بازبینی
curl -X POST https://neboai.com/api/v1/developer/apps/{id}/submit \
-H "Authorization: Bearer $TOKEN" فرایند بازبینی
- اسکن خودکار — فایلهای اجرایی با VirusTotal اسکن میشوند
- بازبینی مدیر — تیم NeboAI فراداده، manifest و نتایج اسکن را بازبینی میکند
- در صورت تأیید — NeboAI برنامه را با Ed25519 امضا و منتشر میکند
- در صورت رد — دلیل را دریافت میکنید و میتوانید اصلاح کنید و دوباره ارسال کنید
زمان هدف بازبینی: <24 ساعت.
ارسال بهروزرسانیها
- نسخهٔ اپ را بهروز کنید:
PUT /api/v1/developer/apps/{id}با نسخهٔ جدید - برای هر پلتفرم فایلهای اجرایی تازه بارگذاری کنید
- دوباره برای بازبینی ارسال کنید
هر بهروزرسانی از همان فرایند بازبینی میگذرد. نسخههای قبلی تا تأیید نسخه تازه در دسترس میمانند.
فراداده فروشگاه
| فیلد | توضیح |
|---|---|
category | مثلاً productivity، communication، developer-tools |
icon | URL آیکون برنامه |
visibility | public یا private |
description | میتواند بلندتر و کاملتر از توضیح manifest باشد |
گردشکار توسعه
توسعه محلی
برای توسعه محلی بستهبندی لازم نیست:
- پوشهٔ اپ خود را بسازید:
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) - مطمئن شوید روی مسیر سوکت Unix از
NEBO_APP_SOCKگوش میدهید - سوکت باید ظرف ۱۰ ثانیه پس از اجرا آماده باشد
- برای ذخیرهسازی از
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 را در طول گفتگو شکل میدهند. وقتی مهارتی فعال است، محتوای آن مستقیم در پرامپت سیستم تزریق میشود — و لحن، روش کار، تخصص حوزهای و استفاده از ابزارهای کارمند هوش مصنوعی را در آن جلسه هدایت میکند.
مهارتها کد نیستند. اسناد markdown با فراداده YAML هستند. بدون کامپایل، بدون فایل اجرایی، بدون gRPC. یک مهارت یعنی یک فایل SKILL.md در یک پوشه. همین.
مهارتها وابسته به بستر و موقتاند. وقتی مرتبط باشند فعال میشوند (با تطبیق محرک یا بارگذاری دستی)، چند نوبت باقی میمانند و وقتی دیگر لازم نباشند منقضی میشوند. این کار بستر کارمند هوش مصنوعی را سبک نگه میدارد — فقط راهنماییای که همین حالا مهم است در پرامپت قرار دارد.
مهارتها مکمل برنامهها هستند. برنامهها قابلیتهای اجرایی فراهم میکنند (ابزارها، کانالها، درگاهها). مهارتها راهنمای هماهنگی را فراهم میکنند — اینکه چطور از آن ابزارها مؤثر استفاده شود. یک برنامه تقویم به Nebo توانایی خواندن و نوشتن رویدادها را میدهد. یک مهارت «آمادگی برای جلسه» به Nebo میگوید چطور با استفاده همزمان از آن برنامه تقویم، ایمیل و جستجوی وب برای جلسهها آماده شود.
مهارتها در برابر برنامهها
| مهارتها | برنامهها | |
|---|---|---|
| قالب | Markdown (SKILL.md) | فایل اجرایی کامپایلشده (.napp) |
| زمان اجرا | تزریقشده در پرامپت سیستم | فرایند sandboxشده روی gRPC |
| ارائه میدهد | راهنمای رفتاری، روش کار | ابزارها، کانالها، پنلهای رابط کاربری |
| طول عمر | محدود به جلسه، انقضا بر اساس TTL | همیشه در حال اجرا |
| ساختن | یک فایل markdown بنویسید | بنویسید، کامپایل کنید، امضا کنید، بستهبندی کنید |
| امنیت | بدون نیاز به مجوز | sandbox با رد پیشفرض |
شروع سریع
در پوشه مهارتهای 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 با دو بخش است: frontmatter به زبان YAML بین نشانگرهای ---، و بدنه markdown (همان دستورالعملهایی که در پرامپت سیستم تزریق میشوند).
| فیلد | الزامی | پیشفرض | توضیح |
|---|---|---|---|
name | بله | — | شناسه یکتا (به slug تبدیل میشود) |
description | بله | — | توضیح یکخطی که در فهرست مهارتها نمایش داده میشود |
version | خیر | "1.0.0" | Semver برای پیگیری بهروزرسانیها |
author | خیر | — | نویسنده مهارت |
priority | خیر | 0 | بالاتر = زودتر تطبیق داده میشود (۱۰۰+ برای جایگزینیهای حیاتی) |
max_turns | خیر | 4 | تعداد نوبتهای بیفعالیتی پیش از انقضای خودکار |
triggers | خیر | [] | عبارتهایی که این مهارت را خودکار فعال میکنند (تطبیق زیررشتهای، بدون حساسیت به حروف بزرگ و کوچک) |
tools | خیر | [] | ابزارهایی که این مهارت انتظار دارد استفاده کند (اطلاعاتی) |
dependencies | خیر | [] | مهارتهای دیگری که باید نصب باشند |
tags | خیر | [] | برای دستهبندی و پیدا شدن |
platform | خیر | [] | پلتفرمهای پشتیبانیشده: macos، linux، windows (خالی = همه) |
مهارتها چطور فعال میشوند
مهارتها از یک مدل فعالسازی دومرحلهای پیروی میکنند: اول اشاره، بعد فراخوانی.
مرحله ۱: تطبیق محرک — هر بار که کاربر پیامی میفرستد، Nebo همه مهارتهای ثبتشده را برای تطبیق محرک بررسی میکند. مهارتهای منطبق بهصورت اشاره در پرامپت سیستم ظاهر میشوند. کارمند هوش مصنوعی اشاره را میبیند و تصمیم میگیرد مهارت را فرا بخواند یا نه.
مرحله ۲: فراخوانی — کارمند هوش مصنوعی مهارت را با این فراخوانی فعال میکند:
skill(name: "code-review") این کار کل قالب SKILL.md را بهعنوان نتیجه ابزار برمیگرداند، فراخوانی را ثبت میکند و قالب را در نوبتهای بعدی دوباره در پرامپت سیستم تزریق میکند.
TTL و انقضا:
- مهارتهای خودکار منطبقشده: ۴ نوبت بیفعالیتی (قابل تنظیم با
max_turns) - مهارتهای دستی بارگذاریشده: ۶ نوبت بیفعالیتی
- فراخوانی دوباره، زمانسنج را از نو شروع میکند
- سقف قطعی: حداکثر ۴ مهارت فعال در هر جلسه
- بودجه توکن: مجموع محتوای مهارتهای فعال حداکثر ۱۶٬۰۰۰ نویسه
مدیریت مهارتها
کارمند هوش مصنوعی میتواند مهارتها را با ابزار skill مدیریت کند:
| Action | توضیح | نمونه |
|---|---|---|
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") |
نوشتن مهارتهای خوب
یک قالب مهارت خوب اینها را دارد:
- یک عنوان روشن — به کارمند هوش مصنوعی میگوید در چه حالتی است
- اصول اصلی — قواعد رفتاری غیرقابل مذاکره
- روش کار — رویکرد گامبهگام برای موقعیتهای رایج
- نمونهها — الگوهای مشخص از پیام کاربر تا پاسخ
- ضدالگوها — کارهایی که نباید انجام شوند (مدلها از نمونههای منفی خوب یاد میگیرند)
نکته: هر مهارت باید یک کار را خوب انجام دهد. یک مهارت «برنامهنویسی عمومی» نسازید — code-review، debugging و api-design را بهصورت مهارتهای جداگانه بسازید. کارمند هوش مصنوعی میتواند چند مهارت را همزمان فعال داشته باشد.
مهارتهای همراه
Nebo با مهارتهای همراهی عرضه میشود که کاربردهای رایج را پوشش میدهند:
| مهارت | اولویت | توضیح |
|---|---|---|
onboarding | 100 | خوشامدگویی به کاربر تازه و جمعآوری اطلاعات نمایه |
best-friend | 50 | مهارت شخصیت — خودمانی، وفادار، رک و صادق |
debugging | 25 | روش نظاممند اشکالزدایی |
api-design | 15 | بهترین شیوههای طراحی API به سبک RESTful |
code-review | 10 | بازبینی ساختاریافته کد با سطحبندی شدت |
database-expert | 10 | طراحی پایگاه داده، کوئریها، بهینهسازی |
git-workflow | 10 | شاخهبندی Git، commitها، گردشکار 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 |
هر سرویس RPCهای HealthCheck و Configure را دارد. SDK هر دو را خودکار مدیریت میکند.
انواع Proto کانال
| نوع پیام | توضیح |
|---|---|
ChannelSendRequest | پاکت پیام خروجی با message_id، channelId، sender، text، attachments، reply_to، actions، platform_data |
ChannelSendResponse | شناسه پیام پلتفرم برای رشتهبندی |
InboundMessage | پاکت پیام ورودی با همه فیلدهای مشترک + timestamp |
MessageSender | هویت بات (name، role، botId) — تکمیلشده توسط کارگزار |
Attachment | پیوست فایل/تصویر/صدا (type، url، filename، size) |
MessageAction | action دکمه/صفحهکلید تعاملی (label، callback_id) |
هویت و نقشهای بات
باتهای Nebo یک مدل هویتی سهمحوری دارند:
- creature — بات چیست (کهنالگو): «استراتژیست حاضرجواب»، «پژوهشگر دقیق»
- role — چه نسبتی با کاربر دارد (رابطه): «دوست»، «مدیر عملیات»، «مربی»
- vibe — انرژیاش (سبک ارتباط): «آرام ولی صاحبنظر»، «گرم و دلگرمکننده»
وقتی افزونه کانال شما پیام خروجی دریافت میکند، فیلد sender شامل name و role بات است. از این برای قالببندی نام نمایشی در پلتفرم خود استفاده کنید. نقش عنوان شغلی نیست — توصیف یک رابطه است. «دوست»، «پسر» و «مربی» در کنار «COO» و «DevLead» نقشهای معتبری هستند.