NeboAI
NeboAI
شروع کنید

برای Nebo برنامه بسازید

به هوش مصنوعی‌تان ابرقدرت‌های تازه بدهید. ابزارها، کانال‌ها، درگاه‌ها، پنل‌های رابط کاربری — هر چه تصورش را بکنید، کامپایل‌شده به یک فایل اجرایی بومی.

نمای کلی

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)

چک‌لیست حداقلی برنامه

  1. فایل manifest.json را با id، name، version و provides بسازید
  2. فایل TOOL.md را بنویسید و توضیح دهید کارمند هوش مصنوعی چطور باید از ابزار شما استفاده کند
  3. SDK را نصب کنید (go get github.com/neboloop/nebo-sdk-go)
  4. interface مربوط به handler را برای قابلیت خود پیاده‌سازی کنید (ToolHandler، ChannelHandler و غیره)
  5. handler را ثبت کنید و 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نام خوانا برای انسان
versionرشته Semver
providesدست‌کم یک قابلیت (پایین‌تر را ببینید)

فیلدهای اختیاری:

فیلدپیش‌فرضتوضیح
runtime"local""local" یا "remote"
protocol"grpc"فقط "grpc" پشتیبانی می‌شود
permissions[]چیزهایی که برنامه به آن‌ها دسترسی لازم دارد
description""در رابط کاربری نمایش داده می‌شود
settings[]تنظیمات قابل پیکربندی (در رابط تنظیمات نمایش داده می‌شوند)
oauth[]نیازمندی‌های ارائه‌دهنده OAuth (بخش OAuth را در ادامه ببینید)

قابلیت‌ها

اعلام کنید برنامه‌تان چه چیزی ارائه می‌دهد:

قابلیتسرویس gRPCتوضیح
gatewayGatewayServiceمسیریابی مدل LLM
tool:<name>ToolServiceیک ابزار نام‌دار برای کارمند هوش مصنوعی
channel:<name>ChannelServiceیک کانال پیام‌رسانی
commCommServiceارتباط بین کارمندان هوش مصنوعی
uiUIServiceرابط کاربری سفارشی با پراکسی HTTP
scheduleScheduleServiceزمان‌بندی سفارشی
visionToolServiceپردازش تصویر
browserToolServiceخودکارسازی مرورگر

یک برنامه می‌تواند چند قابلیت ارائه دهد. مثلاً یک برنامه می‌تواند هم یک ابزار و هم یک پنل رابط کاربری ارائه دهد.

مجوزها

مجوزها تعیین می‌کنند برنامه به چه چیزهایی دسترسی دارد. به‌طور پیش‌فرض رد — اگر اعلام نشده باشد، برنامه نمی‌تواند از آن استفاده کند.

پیشوندنمونه‌هاتوضیح
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/ برنامه
PATHPATH سیستم (بدون تغییر منتقل می‌شود)
HOMEپوشه خانگی کاربر (بدون تغییر منتقل می‌شود)
TMPDIRپوشه موقت (بدون تغییر منتقل می‌شود)

مهم: فایل اجرایی شما باید یک سرور gRPC بسازد که روی سوکت Unix در NEBO_APP_SOCK گوش بدهد. Nebo تا ۱۰ ثانیه منتظر ظاهر شدن این سوکت می‌ماند.

ترتیب اجرای برنامه

  1. Nebo فایل manifest.json را می‌خواند و اعتبارسنجی می‌کند
  2. فایل اجرایی binary یا app را در پوشه برنامه پیدا می‌کند
  3. نشانگر .quarantined را بررسی می‌کند (برنامه‌های قرنطینه‌شده را اجرا نمی‌کند)
  4. بررسی ابطال (فقط برنامه‌هایی که NeboAI توزیع می‌کند)
  5. تأیید امضا (فقط برنامه‌هایی که NeboAI توزیع می‌کند، در حالت توسعه رد می‌شود)
  6. اعتبارسنجی فایل اجرایی (symlinkها، اسکریپت‌ها، فایل‌های غیراجرایی و فایل‌های بیش از حد بزرگ رد می‌شوند)
  7. سوکت باقی‌مانده از اجرای قبلی را پاک می‌کند
  8. پوشه data/ را برای ذخیره‌سازی در sandbox می‌سازد
  9. فایل‌های لاگ مخصوص هر برنامه را راه‌اندازی می‌کند (logs/stdout.log، logs/stderr.log)
  10. فایل اجرایی را با محیط پاک‌سازی‌شده و ایزوله‌سازی گروه فرایند اجرا می‌کند
  11. منتظر ظاهر شدن سوکت Unix می‌ماند (backoff نمایی، حداکثر ۱۰ ثانیه)
  12. از طریق gRPC روی سوکت Unix وصل می‌شود
  13. کلاینت‌های gRPC مخصوص هر قابلیت را بر اساس provides می‌سازد
  14. بررسی سلامت را اجرا می‌کند
  15. قابلیت‌ها را نزد کارمند هوش مصنوعی ثبت می‌کند (ابزارها، درگاه، 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")

قواعد طرح‌واره:

  1. همیشه یک فیلد action به‌صورت enum رشته‌ای الزامی بگذارید
  2. فیلد resource (enum رشته‌ای الزامی) را فقط وقتی اضافه کنید که ابزارتان چند نوع منبع متمایز را مدیریت می‌کند
  3. همه فیلدهای دیگر پارامترهای مخصوص هر action هستند
  4. توضیح 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 برنامه شما را فرا می‌خواند.

چطور کار می‌کند

  1. Nebo تابع ID() را فرا می‌خواند تا شناسه یکتای کانال شما را بگیرد
  2. Nebo تابع Connect() را با پیکربندی‌ای از تنظیمات برنامه شما فرا می‌خواند
  3. Nebo یک استریم Receive() باز می‌کند — هر وقت کاربری به بات پیام بدهد، برنامه شما پیام‌های ورودی را می‌فرستد
  4. پیام‌های ورودی به lane اصلی گفتگوی کارمند هوش مصنوعی هدایت می‌شوند
  5. وقتی کارمند هوش مصنوعی می‌خواهد پیامی بفرستد، Nebo تابع Send() را با پاکت پیام v1 فرا می‌خواند
  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شناسه یکتای مرتب بر اساس زمان
channel_id{type}:{platform_id}شناسه کانال قابل مسیریابی
senderobjectهویت بات — name، role، botId
textstringمتن پیام
attachmentsarrayفایل‌ها، تصاویر، صدا
reply_toUUID v7شناسه پیام والد برای رشته‌بندی
actionsarrayدکمه‌ها/صفحه‌کلیدهای تعاملی
platform_databytesانتقال بدون تغییر برای قابلیت‌های مخصوص پلتفرم
timestampISO 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.json1 MBفراداده برنامه
binary یا app500 MBفایل اجرایی
signatures.json1 MBامضاهای Ed25519
TOOL.md1 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 برسد.

راه‌اندازی حساب توسعه‌دهنده

  1. یک حساب NeboAI در POST /api/v1/owners/register ثبت کنید
  2. برای گرفتن توکن JWT وارد شوید: POST /api/v1/owners/login
  3. یک حساب توسعه‌دهنده بسازید: 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"

فرایند بازبینی

  1. اسکن خودکار — فایل‌های اجرایی با VirusTotal اسکن می‌شوند
  2. بازبینی مدیر — تیم NeboAI فراداده، manifest و نتایج اسکن را بازبینی می‌کند
  3. در صورت تأیید — NeboAI برنامه را با Ed25519 امضا و منتشر می‌کند
  4. در صورت رد — دلیل را دریافت می‌کنید و می‌توانید اصلاح کنید و دوباره ارسال کنید

زمان هدف بازبینی: <24 ساعت.

ارسال به‌روزرسانی‌ها

  1. نسخهٔ اپ را به‌روز کنید: PUT /api/v1/developer/apps/{id} با نسخهٔ جدید
  2. برای هر پلتفرم فایل‌های اجرایی تازه بارگذاری کنید
  3. دوباره برای بازبینی ارسال کنید

هر به‌روزرسانی از همان فرایند بازبینی می‌گذرد. نسخه‌های قبلی تا تأیید نسخه تازه در دسترس می‌مانند.

فراداده فروشگاه

فیلدتوضیح
categoryمثلاً productivity، communication، developer-tools
iconURL آیکون برنامه
visibilitypublic یا private
descriptionمی‌تواند بلندتر و کامل‌تر از توضیح manifest باشد

گردش‌کار توسعه

توسعه محلی

برای توسعه محلی بسته‌بندی لازم نیست:

  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)
  • مطمئن شوید روی مسیر سوکت 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")

نوشتن مهارت‌های خوب

یک قالب مهارت خوب این‌ها را دارد:

  1. یک عنوان روشن — به کارمند هوش مصنوعی می‌گوید در چه حالتی است
  2. اصول اصلی — قواعد رفتاری غیرقابل مذاکره
  3. روش کار — رویکرد گام‌به‌گام برای موقعیت‌های رایج
  4. نمونه‌ها — الگوهای مشخص از پیام کاربر تا پاسخ
  5. ضدالگوها — کارهایی که نباید انجام شوند (مدل‌ها از نمونه‌های منفی خوب یاد می‌گیرند)

نکته: هر مهارت باید یک کار را خوب انجام دهد. یک مهارت «برنامه‌نویسی عمومی» نسازید — code-review، debugging و api-design را به‌صورت مهارت‌های جداگانه بسازید. کارمند هوش مصنوعی می‌تواند چند مهارت را هم‌زمان فعال داشته باشد.

مهارت‌های همراه

Nebo با مهارت‌های همراهی عرضه می‌شود که کاربردهای رایج را پوشش می‌دهند:

مهارتاولویتتوضیح
onboarding100خوشامدگویی به کاربر تازه و جمع‌آوری اطلاعات نمایه
best-friend50مهارت شخصیت — خودمانی، وفادار، رک و صادق
debugging25روش نظام‌مند اشکال‌زدایی
api-design15بهترین شیوه‌های طراحی API به سبک RESTful
code-review10بازبینی ساختاریافته کد با سطح‌بندی شدت
database-expert10طراحی پایگاه داده، کوئری‌ها، بهینه‌سازی
git-workflow10شاخه‌بندی Git، commitها، گردش‌کار 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

هر سرویس 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)
MessageActionaction دکمه/صفحه‌کلید تعاملی (label، callback_id)

هویت و نقش‌های بات

بات‌های Nebo یک مدل هویتی سه‌محوری دارند:

  • creature — بات چیست (کهن‌الگو): «استراتژیست حاضرجواب»، «پژوهشگر دقیق»
  • role — چه نسبتی با کاربر دارد (رابطه): «دوست»، «مدیر عملیات»، «مربی»
  • vibe — انرژی‌اش (سبک ارتباط): «آرام ولی صاحب‌نظر»، «گرم و دلگرم‌کننده»

وقتی افزونه کانال شما پیام خروجی دریافت می‌کند، فیلد sender شامل name و role بات است. از این برای قالب‌بندی نام نمایشی در پلتفرم خود استفاده کنید. نقش عنوان شغلی نیست — توصیف یک رابطه است. «دوست»، «پسر» و «مربی» در کنار «COO» و «DevLead» نقش‌های معتبری هستند.