NeboAI
NeboAI
ابدأ الآن

أنشئ تطبيقات لـ Nebo

امنح ذكاءك الاصطناعي قدرات خارقة جديدة. أدوات وقنوات وبوابات ولوحات واجهة، وكل ما يمكنك تخيّله، مُجمَّعًا في ملف تنفيذي أصلي.

نظرة عامة

ما هو Nebo

Nebo مساعد ذكاء اصطناعي شخصي لسطح المكتب، أي موظف ذكاء اصطناعي يعمل دائمًا ويدير حياتك الرقمية. فكّر في Nebo كما تفكّر في الهاتف الذكي: منصة قوية تصبح مُغيِّرة للقواعد بفضل تطبيقاتها.

Nebo بمفرده موظف ذكاء اصطناعي قدير يملك ذاكرة وجدولة وتصفّحًا للويب وإدارة للملفات ووصولًا إلى سطر الأوامر. لكن المفتاح الحقيقي هو التطبيقات. فكما تأتي قوة الهاتف الذكي من منظومة تطبيقاته، تأتي قوة Nebo من التطبيقات التي توسّع ما يستطيع فعله.

ما هي التطبيقات

تطبيقات Nebo وحدات مستقلة ومُجمَّعة مسبقًا تقدّم وظائف مذهلة. كل تطبيق يمنح Nebo قدرة خارقة جديدة: إدارة التقويم، وفرز البريد الإلكتروني، وتتبّع المشاريع، وأتمتة المنزل، والتحليل المالي، وكل ما يمكن أن يتخيّله المطوّر.

تقدّم التطبيقات قوة مذهلة بطريقة آمنة للغاية. يعمل كل تطبيق داخل بيئة معزولة بأذونات مرفوضة افتراضيًا. ولا يمكنه الوصول إلا إلى ما يصرّح به ملف البيان ويوافق عليه المستخدم.

الواجهة محادثة بنسبة 100%. لا يتعامل المستخدمون مع التطبيقات عبر شاشات أو لوحات تحكم منفصلة. بل يتحدثون إلى Nebo، ويستخدم Nebo أدوات التطبيق لإنجاز المهام. "ما الذي في تقويمي غدًا؟" فيستدعي Nebo تطبيق التقويم. "أنشئ اجتماعًا مع سارة الساعة 3 مساءً" فيستدعي Nebo تطبيق التقويم. ولا يغادر المستخدم المحادثة أبدًا.

يمكن للتطبيقات اختياريًا أن توفّر واجهة إعدادات، وهي لوحة تهيئة تُفتح في نافذة المتصفح المدمجة في Nebo. هنا يُدخل المستخدمون مفاتيح API ويفعّلون الميزات ويهيّئون التطبيق. تعتمد واجهة الإعدادات على المصفوفة settings في ملف البيان (يعرض Nebo النموذج تلقائيًا)، أو يمكن للتطبيق أن يوفّر واجهته المخصصة الكاملة عبر القدرة ui.

تحلّ التطبيقات محلّ القدرات المدمجة في Nebo وتوسّعها. يأتي Nebo مزوّدًا بأدوات منصة أساسية (الوصول إلى التقويم المحلي، ولقطات الشاشة، وغيرها). وعندما تثبّت تطبيق تقويم، فإنه يحلّ محلّ أداة التقويم المدمجة ويصبح مجموعة أشمل منها: محلي + سحابي + تجميع + التحقق من التوفّر.

سياسة الملفات المُجمَّعة فقط

يفرض Nebo سياسة صارمة تقتضي أن تكون الملفات التنفيذية مُجمَّعة فقط. يجب أن تكون جميع التطبيقات ملفات تنفيذية أصلية مُجمَّعة.

الحالةاللغات
مدعومةGo (موصى بها)، وRust، وC/C++، وZig
مرفوضةPython، وNode.js، وRuby، وJava، و.NET، وسكربتات shell

المبررات:

  • منع التعديل الذاتي للذكاء الاصطناعي: يستطيع موظف ذكاء اصطناعي لديه وصول إلى سطر الأوامر أن يعدّل سلوك سكربت مُفسَّر أثناء التشغيل. أما الملفات التنفيذية المُجمَّعة فلا يمكن تغييرها بعد توقيعها.
  • سلامة التوقيع: تغطي توقيعات 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/

بنية مجلد التطبيق

توجد التطبيقات في المجلد الفرعي 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. نفّذ واجهة المعالِج الخاصة بقدرتك (ToolHandler، ChannelHandler، وغيرها)
  5. سجّل المعالِج واستدعِ app.Run()
  6. ابنِ ملفًا تنفيذيًا أصليًا (go build -o binary .)
  7. ضع الملف التنفيذي + manifest.json + TOOL.md في المجلد apps/<your-app-id>/
  8. يكتشفه Nebo ويشغّله تلقائيًا

التهيئة

manifest.json

يحتاج كل تطبيق إلى ملف manifest.json:

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

الحقول المطلوبة:

الحقلالوصف
idمعرّف بصيغة النطاق المعكوس (مثل com.mycompany.myapp)
nameاسم مقروء للبشر
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عمليات المسارات
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 ضمن لوحة إعدادات التطبيق. يخزّنها 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مصفوفة نطاقات OAuth التي يحتاجها التطبيق

عندما يثبّت المستخدم التطبيق، يطلب منه Nebo تفويض نطاقات OAuth المطلوبة. ويستلم التطبيق الرموز المُحدَّثة عبر RPC المسمّى Configure دون أن يتولى عملية OAuth بنفسه.

متغيرات البيئة

تستلم عملية تطبيقك بيئة منقّاة، تُزال منها كل الأسرار. وتحصل على:

المتغيرالقيمة
NEBO_APP_DIRمجلد تثبيت التطبيق
NEBO_APP_SOCKمسار مقبس Unix المطلوب إنشاؤه
NEBO_APP_IDمعرّف التطبيق من ملف البيان
NEBO_APP_NAMEاسم التطبيق من ملف البيان
NEBO_APP_VERSIONإصدار التطبيق من ملف البيان
NEBO_APP_DATAمسار المجلد data/ الخاص بالتطبيق
PATHPATH الخاص بالنظام (يُمرَّر كما هو)
HOMEالمجلد الرئيسي للمستخدم (يُمرَّر كما هو)
TMPDIRالمجلد المؤقت (يُمرَّر كما هو)

مهم جدًا: يجب أن ينشئ ملفك التنفيذي خادم gRPC يستمع على مقبس Unix عند NEBO_APP_SOCK. ينتظر Nebo ظهور هذا المقبس مدة تصل إلى 10 ثوانٍ.

تسلسل تشغيل التطبيق

  1. يقرأ Nebo الملف manifest.json ويتحقق منه
  2. يعثر على الملف التنفيذي binary أو app في مجلد التطبيق
  3. يتحقق من وجود العلامة .quarantined (ويرفض تشغيل التطبيقات المعزولة)
  4. التحقق من الإلغاء (للتطبيقات الموزّعة عبر NeboAI فقط)
  5. التحقق من التوقيع (للتطبيقات الموزّعة عبر NeboAI فقط، ويُتخطّى في وضع التطوير)
  6. التحقق من الملف التنفيذي (يرفض الروابط الرمزية والسكربتات والملفات غير التنفيذية والملفات كبيرة الحجم)
  7. ينظّف المقبس القديم المتبقي من التشغيل السابق
  8. ينشئ المجلد data/ للتخزين المعزول
  9. يُعِدّ ملفات سجل لكل تطبيق (logs/stdout.log، logs/stderr.log)
  10. يشغّل الملف التنفيذي ببيئة منقّاة وعزل لمجموعة العمليات
  11. ينتظر ظهور مقبس Unix (مع تراجع أسّي، بحد أقصى 10 ثوانٍ)
  12. يتصل عبر gRPC من خلال مقبس Unix
  13. ينشئ عملاء gRPC خاصين بكل قدرة بناءً على provides
  14. يُجري فحص السلامة
  15. يسجّل القدرات لدى موظف الذكاء الاصطناعي (الأدوات، والبوابة، والتواصل، وغيرها)

تطبيقات الأدوات

صرّح بـ "provides": ["tool:my_tool_name"] في ملف البيان.

نمط STRAP

يجب أن تستخدم جميع تطبيقات الأدوات في Nebo نمط STRAP (Single Tool Resource Action Pattern) لمخططها وتوجيه تنفيذها. وهو النمط نفسه الذي يستخدمه Nebo داخليًا لدمج أكثر من 35 أداة منفردة في 4 أدوات للمجالات، مما يقلّل عبء سياق LLM بنحو 80%.

الفكرة الأساسية: بدلًا من تسجيل عدة أدوات (get_events، check_availability، suggest_slots)، سجّل أداة واحدة فقط تحتوي على حقل action (وحقل resource اختياريًا) يوجّه إلى المعالِج المناسب.

مثال بمورد واحد (التقويم):

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

مثال بعدة موارد (مدير المشاريع):

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

قواعد المخطط:

  1. أضِف دائمًا حقل action بوصفه تعدادًا نصيًا مطلوبًا
  2. أضِف حقل resource (تعداد نصي مطلوب) فقط إذا كانت أداتك تدير عدة أنواع مختلفة من الموارد
  3. كل الحقول الأخرى معاملات خاصة بالإجراء
  4. ينبغي أن يسرد وصف التعداد action كل الإجراءات المتاحة

لماذا يهم STRAP:

  • تتعلم نماذج LLM نمط التوجيه عبر action مرة واحدة وتعمّمه على كل العمليات
  • تستهلك تعريفات الأدوات نحو 6% من السياق، ويقلّص STRAP ذلك بنسبة 80%
  • العمليات الجديدة مجرد إضافات إلى التعداد، لا تسجيلات لأدوات جديدة
  • يعمل بالطريقة نفسها مع النماذج المستضافة والمحلية

مثال 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. عندما يرسل مستخدم رسالة على المنصة الخارجية، يبثّها تطبيقك إلى Nebo عبر Receive. وعندما يريد موظف الذكاء الاصطناعي الرد، يستدعي Nebo الدالة Send في تطبيقك.

كيف يعمل

  1. يستدعي Nebo الدالة ID() للحصول على المعرّف الفريد لقناتك
  2. يستدعي Nebo الدالة Connect() مع التهيئة المأخوذة من إعدادات تطبيقك
  3. يفتح Nebo بثًّا عبر Receive()، ويرسل تطبيقك الرسائل الواردة كلما راسل مستخدمٌ البوت
  4. تُوجَّه الرسائل الواردة إلى مسار المحادثة الرئيسي لموظف الذكاء الاصطناعي
  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هوية البوت: الاسم، والدور، وbotId
textstringنص الرسالة
attachmentsarrayالملفات والصور والصوت
reply_toUUID v7معرّف الرسالة الأم لتكوين سلاسل الردود
actionsarrayأزرار ولوحات مفاتيح تفاعلية
platform_databytesتمرير مُبهَم للميزات الخاصة بكل منصة
timestampISO 8601يحدّده الناشر

تصميم من طبقتين: تغطي الحقول المشتركة (text، attachments، reply_to، actions) نسبة 90% من الرسائل التي يبادر بها الموظف. أما الميزات الخاصة بكل منصة فتوضع في platform_data، وتتولى إضافتك تحويلها من صيغة المنصة الأصلية وإليها.

تدفقات المحادثة

تُوجَّه رسائل القنوات عبر تدفقات محادثة منفصلة لكل قناة لضمان العزل:

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

مثال Go — قناة Telegram

package main

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

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

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

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

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

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

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

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

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

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

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

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

manifest.json:

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

مزيد من القدرات

تطبيق التواصل

صرّح بـ "provides": ["comm"] و"permissions": ["comm:*"]. تتيح تطبيقات التواصل الاتصال بين موظفي الذكاء الاصطناعي.

الحقلالوصف
fromمعرّف الموظف المرسِل
toمعرّف الموظف المستلِم
topicموضوع الرسالة/قناتها
type"message"، "mention"، "proposal"، "command"، "info"، "task"
contentنص الرسالة

السلوكيات الأساسية:

  • Register يعلن عن موظف الذكاء الاصطناعي هذا على الشبكة مع قدراته
  • Subscribe/Unsubscribe يديران الاشتراكات في المواضيع
  • Receive يبثّ الرسائل الواردة (بثّ من الخادم، كما في القنوات)
  • لا يمكن أن يكون أكثر من تطبيق تواصل واحد نشطًا في الوقت نفسه

تطبيق البوابة

يوجّه تطبيق البوابة طلبات LLM إلى النماذج. صرّح بـ "provides": ["gateway"] و"permissions": ["network:outbound", "user:token"].

يحتوي GatewayRequest على الرسائل والأدوات وموجّه النظام والحد الأقصى للرموز ودرجة الحرارة وUserContext (رمز JWT إذا مُنح الإذن user:token).

أنواع GatewayEvent:

النوعالمحتوىالوصف
"text"جزء نصيرمز نصي متدفق
"tool_call"JSONيريد النموذج استدعاء أداة
"thinking"جزء نصيتفكير/استدلال موسّع
"error"رسالة خطأحدث خطأ ما
"done"فارغاكتمل البث

تطبيق الواجهة

يوفّر تطبيق الواجهة واجهة تهيئة مخصصة تُفتح في نافذة المتصفح المدمجة في Nebo. صرّح بـ "provides": ["ui"]. وبخلاف نموذج الإعدادات التلقائي (الذي يعرضه Nebo من settings في ملف البيان)، يقدّم تطبيق الواجهة واجهته الأمامية الكاملة بـ HTML/CSS/JS.

يأتي تطبيقك مع مجلد ui/ يحتوي على أصول ويب ثابتة (HTML وCSS وJS، وعادةً تطبيق صفحة واحدة مع index.html). يقدّم Nebo هذه الملفات مباشرة ويمرّر استدعاءات API إلى تطبيقك عبر gRPC.

المسارالآليةالغرض
GET /api/v1/apps/{id}/ui/*خادم ملفات ثابتةيقدّم الملفات من مجلد ui/ لديك (مع الرجوع إلى index.html لتطبيق الصفحة الواحدة)
ANY /api/v1/apps/{id}/api/*وكيل gRPCيمرّر طلبات HTTP إلى UIService.HandleRequest() في تطبيقك

يغلّف SDK كائن net/http.ServeMux قياسيًا، فتكتب معالجات 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، فتُمرَّر إلى المعالج mux لديك.

تطبيق الجدولة

يحلّ تطبيق الجدولة محلّ مُجدوِل cron المدمج في Nebo. صرّح بـ "provides": ["schedule"] و"permissions": ["schedule:create"].

عند تشغيل تطبيق الجدولة لديك، يوجّه Nebo كل عمليات الجدولة عبر تطبيقك بدلًا من محرك cron الافتراضي. وإذا تعطّل تطبيقك، يعود Nebo تلقائيًا إلى المحرك المدمج.

  • تطبيقك يملك حالة الجداول، فلا يخزّن Nebo الجداول في قاعدة بياناته الخاصة عندما يكون تطبيق جدولة نشطًا
  • عمليات CRUD القياسية: Create، Get، List، Update، Delete، Enable، Disable
  • Triggers هو RPC ببثّ من الخادم، يرسل تطبيقك رسالة تشغيل كلما حان موعد جدول
  • لا يمكن أن يكون أكثر من تطبيق جدولة واحد نشطًا في الوقت نفسه

تطبيقات متعددة القدرات

يمكن للتطبيق أن يقدّم عدة قدرات. فمثلًا، تطبيق لوحة تحكم يضم أداة وواجهة معًا:

{
    "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تعليمات الأداة لموظف الذكاء الاصطناعي

قواعد الأمان أثناء الاستخراج:

  • لا تجاوز للمسارات (يُرفض ../)
  • لا روابط رمزية (تُرفض)
  • لا مسارات مطلقة (تُرفض)
  • لا تُقبل إلا أسماء الملفات المدرجة في قائمة السماح

التوقيعات

توقّع 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)

الخطوة 1: أنشئ التطبيق

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

الخطوة 2: ارفع الملفات التنفيذية للمنصات

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

ارفع ملفًا تنفيذيًا واحدًا لكل منصة: darwin-arm64، darwin-amd64، linux-amd64، linux-arm64.

الخطوة 3: قدّمه للمراجعة

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

عملية المراجعة

  1. فحص آلي: تُفحص الملفات التنفيذية عبر VirusTotal
  2. مراجعة إدارية: يراجع فريق NeboAI البيانات الوصفية وملف البيان ونتائج الفحص
  3. عند الموافقة: توقّع NeboAI التطبيق باستخدام Ed25519 وتنشره
  4. عند الرفض: تتلقى سببًا ويمكنك الإصلاح وإعادة التقديم

مدة المراجعة المستهدفة: <24 ساعة.

نشر التحديثات

  1. حدّث إصدار التطبيق: PUT /api/v1/developer/apps/{id} مع الإصدار الجديد
  2. ارفع ملفات تنفيذية جديدة لكل منصة
  3. قدّمه للمراجعة مجددًا

يمرّ كل تحديث بعملية المراجعة نفسها. وتظل الإصدارات السابقة متاحة حتى تتم الموافقة على الإصدار الجديد.

بيانات المتجر الوصفية

الحقلالوصف
categoryمثل productivity، communication، developer-tools
iconعنوان URL لأيقونة التطبيق
visibilitypublic أو private
descriptionيمكن أن يكون أطول وأغنى من وصف ملف البيان

سير عمل التطوير

التطوير المحلي

لا حاجة إلى التحزيم في التطوير المحلي:

  1. أنشئ مجلد تطبيقك:
    mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp
  2. اكتب ملف manifest.json والشيفرة
  3. ابنِ ملفك التنفيذي:
    go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary .
  4. يكتشف Nebo المجلد الجديد تلقائيًا (أو أعد تشغيل Nebo)
  5. بعد تعديل الشيفرة، أعد بناء الملف التنفيذي، وسيعيد مراقب الملفات تشغيل التطبيق

عرض السجلات

يُلتقط stdout/stderr للتطبيق في ملفات سجل خاصة بكل تطبيق:

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

البيانات الدائمة

استخدم المجلد data/ (المتاح أيضًا عبر متغير البيئة NEBO_APP_DATA) لأي ملفات يحتاج تطبيقك إلى الاحتفاظ بها. يبقى هذا المجلد بعد تحديثات التطبيق والعزل.

نصائح لتصحيح الأخطاء

  • إذا لم يبدأ تطبيقك، فراجع logs/stderr.log بحثًا عن الأخطاء
  • تأكد من أن الملف التنفيذي قابل للتنفيذ (chmod +x binary)
  • تأكد من أنك تستمع على مسار مقبس Unix المأخوذ من NEBO_APP_SOCK
  • يجب أن يكون المقبس جاهزًا خلال 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 أثناء المحادثة. عندما تكون مهارة نشطة، يُحقن محتواها مباشرة في موجّه النظام، فيوجّه نبرة موظف الذكاء الاصطناعي ومنهجيته وخبرته في المجال واستخدامه للأدوات خلال تلك الجلسة.

المهارات ليست شيفرة. إنها مستندات markdown مع بيانات وصفية بصيغة YAML. لا تجميع، ولا ملف تنفيذي، ولا gRPC. المهارة ملف SKILL.md داخل مجلد. هذا كل شيء.

المهارات سياقية ومؤقتة. تُفعَّل عندما تكون ذات صلة (عبر مطابقة المُشغِّلات أو التحميل اليدوي)، وتستمر لبضعة أدوار، ثم تنتهي عندما لا تعود هناك حاجة إليها. وهذا يُبقي سياق موظف الذكاء الاصطناعي خفيفًا، فلا يكون في الموجّه إلا التوجيه المهم الآن.

المهارات تكمّل التطبيقات. توفّر التطبيقات قدرات قابلة للتنفيذ (أدوات، وقنوات، وبوابات). وتوفّر المهارات توجيهًا لتنسيق العمل، أي كيفية استخدام تلك الأدوات بفعالية. يمنح تطبيق التقويم Nebo القدرة على قراءة الأحداث وكتابتها. أما مهارة "التحضير للاجتماعات" فتخبر Nebo كيف يحضّر للاجتماعات باستخدام تطبيق التقويم والبريد الإلكتروني والبحث على الويب معًا.

المهارات مقابل التطبيقات

المهاراتالتطبيقات
الصيغةMarkdown (SKILL.md)ملف تنفيذي مُجمَّع (.napp)
بيئة التشغيلتُحقن في موجّه النظامعملية معزولة عبر gRPC
ما تقدّمهتوجيه سلوكي، ومنهجيةأدوات، وقنوات، ولوحات واجهة
مدة البقاءمرتبطة بالجلسة، وتنتهي وفق 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 بين علامتي ---، ونص markdown (التعليمات الفعلية التي تُحقن في موجّه النظام).

الحقلمطلوبالقيمة الافتراضيةالوصف
nameنعم—معرّف فريد (يصبح الاسم المختصر)
descriptionنعم—وصف من سطر واحد يظهر في كتالوج المهارات
versionلا"1.0.0"إصدار بصيغة Semver لتتبّع التحديثات
authorلا—مؤلف المهارة
priorityلا0القيمة الأعلى تُطابَق أولًا (100+ للتجاوزات الحرجة)
max_turnsلا4عدد أدوار الخمول قبل الانتهاء التلقائي
triggersلا[]عبارات تفعّل هذه المهارة تلقائيًا (مطابقة جزئية دون حساسية لحالة الأحرف)
toolsلا[]الأدوات التي يُتوقع أن تستخدمها هذه المهارة (للعلم فقط)
dependenciesلا[]مهارات أخرى يجب أن تكون مثبّتة
tagsلا[]للتصنيف والاكتشاف
platformلا[]المنصات المدعومة: macos، linux، windows (الفراغ = الكل)

كيف تُفعَّل المهارات

تتبع المهارات نموذج تفعيل من مرحلتين: تلميح ثم استدعاء.

المرحلة 1: مطابقة المُشغِّلات: في كل مرة يرسل فيها المستخدم رسالة، يفحص Nebo كل المهارات المسجّلة بحثًا عن تطابق مع المُشغِّلات. وتظهر المهارات المطابقة على شكل تلميحات في موجّه النظام. يرى موظف الذكاء الاصطناعي التلميح ويقرّر ما إذا كان سيستدعي المهارة.

المرحلة 2: الاستدعاء: يستدعي موظف الذكاء الاصطناعي المهارة عبر:

skill(name: "code-review")

يعيد هذا قالب SKILL.md كاملًا كنتيجة للأداة، ويسجّل الاستدعاء، ويعيد حقن القالب في موجّه النظام في الأدوار التالية.

TTL والانتهاء:

  • المهارات المطابَقة تلقائيًا: 4 أدوار من الخمول (قابلة للتهيئة عبر max_turns)
  • المهارات المحمّلة يدويًا: 6 أدوار من الخمول
  • إعادة الاستدعاء تعيد ضبط المؤقت
  • الحد الصارم: 4 مهارات نشطة كحد أقصى لكل جلسة
  • ميزانية الرموز: مجموع محتوى المهارات النشطة محدود بـ 16,000 حرف

إدارة المهارات

يستطيع موظف الذكاء الاصطناعي إدارة المهارات عبر الأداة skill:

الإجراءالوصفمثال
catalogسرد كل المهارات المتاحةskill(action: "catalog")
loadالتفعيل لهذه الجلسةskill(name: "code-review", action: "load")
unloadإلغاء تفعيل مهارةskill(name: "code-review", action: "unload")
createإنشاء مهارة جديدة على القرصskill(action: "create", content: "...")
updateتحديث مهارة موجودةskill(name: "my-skill", action: "update", content: "...")
deleteحذف مهارة من القرصskill(name: "my-skill", action: "delete")

كتابة مهارات جيدة

يتضمن قالب المهارة الجيد ما يلي:

  1. عنوان واضح: يخبر موظف الذكاء الاصطناعي بالوضع الذي يعمل فيه
  2. مبادئ أساسية: قواعد السلوك غير القابلة للتفاوض
  3. المنهجية: نهج خطوة بخطوة للسيناريوهات الشائعة
  4. أمثلة: أنماط ملموسة من رسالة المستخدم إلى الرد
  5. أنماط يجب تجنّبها: ما الذي يجب ألا يُفعل (تتعلم النماذج جيدًا من الأمثلة السلبية)

نصيحة: ينبغي لكل مهارة أن تُتقن شيئًا واحدًا. لا تنشئ مهارة "برمجة عامة"، بل أنشئ code-review وdebugging وapi-design كمهارات منفصلة. ويمكن أن تكون لدى موظف الذكاء الاصطناعي عدة مهارات نشطة في الوقت نفسه.

المهارات المضمّنة

يأتي Nebo مع مهارات مضمّنة تغطي حالات الاستخدام الشائعة:

المهارةالأولويةالوصف
onboarding100الترحيب بالمستخدم الجديد وجمع بيانات ملفه الشخصي
best-friend50مهارة الشخصية: حديث عفوي ووفيّ وصريح
debugging25منهجية منظمة لتصحيح الأخطاء
api-design15أفضل ممارسات تصميم RESTful API
code-review10مراجعة منظمة للشيفرة مع مستويات الخطورة
database-expert10تصميم قواعد البيانات والاستعلامات والتحسين
git-workflow10تفرّعات Git والإيداعات وسير عمل طلبات الدمج
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مغلّف الرسالة الواردة مع كل الحقول المشتركة + الطابع الزمني
MessageSenderهوية البوت (name، role، botId)، يُثريها الوسيط
Attachmentمرفق ملف/صورة/صوت (type، url، filename، size)
MessageActionإجراء زر/لوحة مفاتيح تفاعلية (label، callback_id)

هوية البوت وأدواره

لبوتات Nebo نموذج هوية من ثلاثة محاور:

  • creature: ما هو البوت (النموذج الأصلي): "استراتيجي سريع البديهة"، "باحث دقيق"
  • role: علاقته بالمستخدم: "صديق"، "مدير العمليات"، "مرشد"
  • vibe: طاقته (أسلوب التواصل): "هادئ لكن له آراء"، "دافئ ومشجّع"

عندما تستلم إضافة القناة لديك رسالة صادرة، يحتوي الحقل sender على name وrole الخاصين بالبوت. استخدمهما لتنسيق اسم العرض على منصتك. الدور ليس مسمّى وظيفيًا، بل وصف للعلاقة. "صديق" و"ابن" و"مرشد" أدوار صالحة إلى جانب "COO" و"DevLead".