نظرة عامة
ما هو 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) قائمة التحقق لأبسط تطبيق
- أنشئ
manifest.jsonيحتوي علىidوnameوversionوprovides - اكتب
TOOL.mdلتصف كيف ينبغي لموظف الذكاء الاصطناعي استخدام أداتك - ثبّت SDK (
go get github.com/neboloop/nebo-sdk-go) - نفّذ واجهة المعالِج الخاصة بقدرتك (
ToolHandler،ChannelHandler، وغيرها) - سجّل المعالِج واستدعِ
app.Run() - ابنِ ملفًا تنفيذيًا أصليًا (
go build -o binary .) - ضع الملف التنفيذي + manifest.json + TOOL.md في المجلد
apps/<your-app-id>/ - يكتشفه Nebo ويشغّله تلقائيًا
التهيئة
manifest.json
يحتاج كل تطبيق إلى ملف manifest.json:
{
"id": "com.example.myapp",
"name": "My App",
"version": "1.0.0",
"description": "What this app does",
"runtime": "local",
"protocol": "grpc",
"provides": ["tool:my_tool"],
"permissions": ["network:outbound"],
"settings": [
{
"key": "api_key",
"title": "API Key",
"type": "password",
"required": true,
"description": "Your API key for the service",
"secret": true
}
]
} الحقول المطلوبة:
| الحقل | الوصف |
|---|---|
id | معرّف بصيغة النطاق المعكوس (مثل com.mycompany.myapp) |
name | اسم مقروء للبشر |
version | سلسلة إصدار بصيغة Semver |
provides | قدرة واحدة على الأقل (انظر أدناه) |
الحقول الاختيارية:
| الحقل | القيمة الافتراضية | الوصف |
|---|---|---|
runtime | "local" | "local" أو "remote" |
protocol | "grpc" | "grpc" هو الخيار الوحيد المدعوم |
permissions | [] | ما يحتاج التطبيق إلى الوصول إليه |
description | "" | يظهر في الواجهة |
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 | عمليات المسارات |
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/ الخاص بالتطبيق |
PATH | PATH الخاص بالنظام (يُمرَّر كما هو) |
HOME | المجلد الرئيسي للمستخدم (يُمرَّر كما هو) |
TMPDIR | المجلد المؤقت (يُمرَّر كما هو) |
مهم جدًا: يجب أن ينشئ ملفك التنفيذي خادم gRPC يستمع على مقبس Unix عند NEBO_APP_SOCK. ينتظر Nebo ظهور هذا المقبس مدة تصل إلى 10 ثوانٍ.
تسلسل تشغيل التطبيق
- يقرأ Nebo الملف
manifest.jsonويتحقق منه - يعثر على الملف التنفيذي
binaryأوappفي مجلد التطبيق - يتحقق من وجود العلامة
.quarantined(ويرفض تشغيل التطبيقات المعزولة) - التحقق من الإلغاء (للتطبيقات الموزّعة عبر NeboAI فقط)
- التحقق من التوقيع (للتطبيقات الموزّعة عبر NeboAI فقط، ويُتخطّى في وضع التطوير)
- التحقق من الملف التنفيذي (يرفض الروابط الرمزية والسكربتات والملفات غير التنفيذية والملفات كبيرة الحجم)
- ينظّف المقبس القديم المتبقي من التشغيل السابق
- ينشئ المجلد
data/للتخزين المعزول - يُعِدّ ملفات سجل لكل تطبيق (
logs/stdout.log،logs/stderr.log) - يشغّل الملف التنفيذي ببيئة منقّاة وعزل لمجموعة العمليات
- ينتظر ظهور مقبس Unix (مع تراجع أسّي، بحد أقصى 10 ثوانٍ)
- يتصل عبر gRPC من خلال مقبس Unix
- ينشئ عملاء gRPC خاصين بكل قدرة بناءً على
provides - يُجري فحص السلامة
- يسجّل القدرات لدى موظف الذكاء الاصطناعي (الأدوات، والبوابة، والتواصل، وغيرها)
تطبيقات الأدوات
صرّح بـ "provides": ["tool:my_tool_name"] في ملف البيان.
نمط STRAP
يجب أن تستخدم جميع تطبيقات الأدوات في Nebo نمط STRAP (Single Tool Resource Action Pattern) لمخططها وتوجيه تنفيذها. وهو النمط نفسه الذي يستخدمه Nebo داخليًا لدمج أكثر من 35 أداة منفردة في 4 أدوات للمجالات، مما يقلّل عبء سياق LLM بنحو 80%.
الفكرة الأساسية: بدلًا من تسجيل عدة أدوات (get_events، check_availability، suggest_slots)، سجّل أداة واحدة فقط تحتوي على حقل action (وحقل resource اختياريًا) يوجّه إلى المعالِج المناسب.
مثال بمورد واحد (التقويم):
calendar(action: "get_events", start: "2025-01-15T09:00:00Z", end: "2025-01-16T00:00:00Z")
calendar(action: "next_event")
calendar(action: "check_availability", start: "...", end: "...")
calendar(action: "suggest_slots", duration_minutes: 30, preferred_time: "morning") مثال بعدة موارد (مدير المشاريع):
project(resource: "task", action: "create", title: "Ship v2", assignee: "alice")
project(resource: "task", action: "list", status: "open")
project(resource: "milestone", action: "create", name: "Beta", deadline: "2025-03-01")
project(resource: "milestone", action: "list") قواعد المخطط:
- أضِف دائمًا حقل
actionبوصفه تعدادًا نصيًا مطلوبًا - أضِف حقل
resource(تعداد نصي مطلوب) فقط إذا كانت أداتك تدير عدة أنواع مختلفة من الموارد - كل الحقول الأخرى معاملات خاصة بالإجراء
- ينبغي أن يسرد وصف التعداد
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 في تطبيقك.
كيف يعمل
- يستدعي Nebo الدالة
ID()للحصول على المعرّف الفريد لقناتك - يستدعي Nebo الدالة
Connect()مع التهيئة المأخوذة من إعدادات تطبيقك - يفتح Nebo بثًّا عبر
Receive()، ويرسل تطبيقك الرسائل الواردة كلما راسل مستخدمٌ البوت - تُوجَّه الرسائل الواردة إلى مسار المحادثة الرئيسي لموظف الذكاء الاصطناعي
- عندما يريد موظف الذكاء الاصطناعي إرسال رسالة، يستدعي 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 | هوية البوت: الاسم، والدور، وbotId |
text | string | نص الرسالة |
attachments | array | الملفات والصور والصوت |
reply_to | UUID v7 | معرّف الرسالة الأم لتكوين سلاسل الردود |
actions | array | أزرار ولوحات مفاتيح تفاعلية |
platform_data | bytes | تمرير مُبهَم للميزات الخاصة بكل منصة |
timestamp | ISO 8601 | يحدّده الناشر |
تصميم من طبقتين: تغطي الحقول المشتركة (text، attachments، reply_to، actions) نسبة 90% من الرسائل التي يبادر بها الموظف. أما الميزات الخاصة بكل منصة فتوضع في platform_data، وتتولى إضافتك تحويلها من صيغة المنصة الأصلية وإليها.
تدفقات المحادثة
تُوجَّه رسائل القنوات عبر تدفقات محادثة منفصلة لكل قناة لضمان العزل:
neboai/bot/{botID}/channels/{channelType}/inbound # messages from users → agent
neboai/bot/{botID}/channels/{channelType}/outbound # messages from agent → channel مثال Go — قناة Telegram
package main
import (
"context"
"encoding/json"
"fmt"
"log"
"time"
"github.com/google/uuid"
tgbot "github.com/go-telegram/bot"
nebo "github.com/neboloop/nebo-sdk-go"
)
type Telegram struct {
bot *tgbot.Bot
messages chan nebo.ChannelEnvelope
cancel context.CancelFunc
}
func (t *Telegram) ID() string { return "telegram" }
func (t *Telegram) Connect(_ context.Context, config map[string]string) error {
token := config["bot_token"]
if token == "" {
return fmt.Errorf("bot_token is required")
}
botCtx, cancel := context.WithCancel(context.Background())
t.cancel = cancel
bot, err := tgbot.New(token, tgbot.WithDefaultHandler(
func(bCtx context.Context, b *tgbot.Bot, update *tgbot.Update) {
if update.Message == nil {
return
}
env := nebo.ChannelEnvelope{
MessageID: uuid.Must(uuid.NewV7()).String(),
ChannelID: fmt.Sprintf("telegram:%d", update.Message.Chat.ID),
Text: update.Message.Text,
Timestamp: time.Unix(int64(update.Message.Date), 0).UTC(),
}
t.messages <- env
},
))
if err != nil {
return err
}
t.bot = bot
go bot.Start(botCtx)
return nil
}
func (t *Telegram) Send(ctx context.Context, env nebo.ChannelEnvelope) (string, error) {
if t.bot == nil {
return "", fmt.Errorf("not connected")
}
chatID := env.ChannelID[len("telegram:"):]
params := &tgbot.SendMessageParams{
ChatID: chatID,
Text: env.Text,
}
msg, err := t.bot.SendMessage(ctx, params)
if err != nil {
return "", err
}
return fmt.Sprintf("%d", msg.MessageID), nil
}
func (t *Telegram) Receive(_ context.Context) (<-chan nebo.ChannelEnvelope, error) {
return t.messages, nil
}
func (t *Telegram) Disconnect(_ context.Context) error {
if t.cancel != nil {
t.cancel()
}
return nil
}
func main() {
app, err := nebo.New()
if err != nil {
log.Fatal(err)
}
app.RegisterChannel(&Telegram{
messages: make(chan nebo.ChannelEnvelope, 100),
})
log.Fatal(app.Run())
} manifest.json:
{
"id": "com.example.telegram",
"name": "Telegram",
"version": "1.0.0",
"description": "Telegram messaging channel for Nebo",
"runtime": "local",
"protocol": "grpc",
"provides": ["channel:telegram"],
"permissions": ["channel:send", "network:outbound"],
"settings": [
{
"key": "bot_token",
"title": "Bot Token",
"type": "password",
"required": true,
"description": "Telegram bot token from @BotFather",
"secret": true
}
]
} مزيد من القدرات
تطبيق التواصل
صرّح بـ "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.json | 1 MB | بيانات التطبيق الوصفية |
binary أو app | 500 MB | ملف تنفيذي |
signatures.json | 1 MB | توقيعات Ed25519 |
TOOL.md | 1 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.
إعداد حساب المطوّر
- سجّل حسابًا في 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) الخطوة 1: أنشئ التطبيق
curl -X POST https://neboai.com/api/v1/developer/apps \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "My App",
"version": "1.0.0",
"description": "What it does",
"category": "productivity",
"visibility": "public"
}' الخطوة 2: ارفع الملفات التنفيذية للمنصات
curl -X POST https://neboai.com/api/v1/developer/apps/{id}/binaries \
-H "Authorization: Bearer $TOKEN" \
-F "binary=@myapp-darwin-arm64" \
-F "platform=darwin-arm64" ارفع ملفًا تنفيذيًا واحدًا لكل منصة: darwin-arm64، darwin-amd64، linux-amd64، linux-arm64.
الخطوة 3: قدّمه للمراجعة
curl -X POST https://neboai.com/api/v1/developer/apps/{id}/submit \
-H "Authorization: Bearer $TOKEN" عملية المراجعة
- فحص آلي: تُفحص الملفات التنفيذية عبر VirusTotal
- مراجعة إدارية: يراجع فريق NeboAI البيانات الوصفية وملف البيان ونتائج الفحص
- عند الموافقة: توقّع NeboAI التطبيق باستخدام Ed25519 وتنشره
- عند الرفض: تتلقى سببًا ويمكنك الإصلاح وإعادة التقديم
مدة المراجعة المستهدفة: <24 ساعة.
نشر التحديثات
- حدّث إصدار التطبيق:
PUT /api/v1/developer/apps/{id}مع الإصدار الجديد - ارفع ملفات تنفيذية جديدة لكل منصة
- قدّمه للمراجعة مجددًا
يمرّ كل تحديث بعملية المراجعة نفسها. وتظل الإصدارات السابقة متاحة حتى تتم الموافقة على الإصدار الجديد.
بيانات المتجر الوصفية
| الحقل | الوصف |
|---|---|
category | مثل productivity، communication، developer-tools |
icon | عنوان URL لأيقونة التطبيق |
visibility | public أو private |
description | يمكن أن يكون أطول وأغنى من وصف ملف البيان |
سير عمل التطوير
التطوير المحلي
لا حاجة إلى التحزيم في التطوير المحلي:
- أنشئ مجلد تطبيقك:
mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp - اكتب ملف
manifest.jsonوالشيفرة - ابنِ ملفك التنفيذي:
go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary . - يكتشف Nebo المجلد الجديد تلقائيًا (أو أعد تشغيل Nebo)
- بعد تعديل الشيفرة، أعد بناء الملف التنفيذي، وسيعيد مراقب الملفات تشغيل التطبيق
عرض السجلات
يُلتقط stdout/stderr للتطبيق في ملفات سجل خاصة بكل تطبيق:
tail -f ~/Library/Application\ Support/Nebo/apps/com.example.myapp/logs/stdout.log
tail -f ~/Library/Application\ Support/Nebo/apps/com.example.myapp/logs/stderr.log البيانات الدائمة
استخدم المجلد data/ (المتاح أيضًا عبر متغير البيئة NEBO_APP_DATA) لأي ملفات يحتاج تطبيقك إلى الاحتفاظ بها. يبقى هذا المجلد بعد تحديثات التطبيق والعزل.
نصائح لتصحيح الأخطاء
- إذا لم يبدأ تطبيقك، فراجع
logs/stderr.logبحثًا عن الأخطاء - تأكد من أن الملف التنفيذي قابل للتنفيذ (
chmod +x binary) - تأكد من أنك تستمع على مسار مقبس 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") |
كتابة مهارات جيدة
يتضمن قالب المهارة الجيد ما يلي:
- عنوان واضح: يخبر موظف الذكاء الاصطناعي بالوضع الذي يعمل فيه
- مبادئ أساسية: قواعد السلوك غير القابلة للتفاوض
- المنهجية: نهج خطوة بخطوة للسيناريوهات الشائعة
- أمثلة: أنماط ملموسة من رسالة المستخدم إلى الرد
- أنماط يجب تجنّبها: ما الذي يجب ألا يُفعل (تتعلم النماذج جيدًا من الأمثلة السلبية)
نصيحة: ينبغي لكل مهارة أن تُتقن شيئًا واحدًا. لا تنشئ مهارة "برمجة عامة"، بل أنشئ code-review وdebugging وapi-design كمهارات منفصلة. ويمكن أن تكون لدى موظف الذكاء الاصطناعي عدة مهارات نشطة في الوقت نفسه.
المهارات المضمّنة
يأتي Nebo مع مهارات مضمّنة تغطي حالات الاستخدام الشائعة:
| المهارة | الأولوية | الوصف |
|---|---|---|
onboarding | 100 | الترحيب بالمستخدم الجديد وجمع بيانات ملفه الشخصي |
best-friend | 50 | مهارة الشخصية: حديث عفوي ووفيّ وصريح |
debugging | 25 | منهجية منظمة لتصحيح الأخطاء |
api-design | 15 | أفضل ممارسات تصميم RESTful API |
code-review | 10 | مراجعة منظمة للشيفرة مع مستويات الخطورة |
database-expert | 10 | تصميم قواعد البيانات والاستعلامات والتحسين |
git-workflow | 10 | تفرّعات Git والإيداعات وسير عمل طلبات الدمج |
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 | مغلّف الرسالة الواردة مع كل الحقول المشتركة + الطابع الزمني |
MessageSender | هوية البوت (name، role، botId)، يُثريها الوسيط |
Attachment | مرفق ملف/صورة/صوت (type، url، filename، size) |
MessageAction | إجراء زر/لوحة مفاتيح تفاعلية (label، callback_id) |
هوية البوت وأدواره
لبوتات Nebo نموذج هوية من ثلاثة محاور:
- creature: ما هو البوت (النموذج الأصلي): "استراتيجي سريع البديهة"، "باحث دقيق"
- role: علاقته بالمستخدم: "صديق"، "مدير العمليات"، "مرشد"
- vibe: طاقته (أسلوب التواصل): "هادئ لكن له آراء"، "دافئ ومشجّع"
عندما تستلم إضافة القناة لديك رسالة صادرة، يحتوي الحقل sender على name وrole الخاصين بالبوت. استخدمهما لتنسيق اسم العرض على منصتك. الدور ليس مسمّى وظيفيًا، بل وصف للعلاقة. "صديق" و"ابن" و"مرشد" أدوار صالحة إلى جانب "COO" و"DevLead".