Шолу
Nebo деген не
Nebo — жеке компьютерлік ЖИ көмекшісі, цифрлық өміріңізді басқаратын үнемі жұмыс істейтін ЖИ қызметкері. Nebo-ны смартфон сияқты елестетіңіз: қолданбалары арқылы түбегейлі өзгеріс әкелетін қуатты платформа.
Nebo өз бетінше-ақ жады, жоспарлау, веб-шолу, файлдарды басқару және shell қолжетімділігі бар қабілетті ЖИ қызметкері. Бірақ нағыз мүмкіндікті қолданбалар ашады. Смартфонның күші оның қолданбалар экожүйесінен келетіні сияқты, Nebo-ның күші де оның мүмкіндіктерін кеңейтетін қолданбалардан келеді.
Қолданбалар деген не
Nebo қолданбалары — керемет функционалы бар, дербес, алдын ала компиляцияланған бірліктер. Әр қолданба Nebo-ға жаңа супер қабілет береді — күнтізбені басқару, хаттарды сұрыптау, жобаларды бақылау, үйді автоматтандыру, қаржылық талдау — әзірлеуші ойлап таба алатын кез келген нәрсе.
Қолданбалар орасан зор мүмкіндікті өте қауіпсіз түрде береді. Әр қолданба әдепкі бойынша бәріне тыйым салынған рұқсаттармен құмсалғышта жұмыс істейді. Ол тек манифестте жарияланған және пайдаланушы мақұлдаған нәрсеге ғана қол жеткізе алады.
Интерфейс 100% сөйлесу арқылы жүреді. Пайдаланушылар қолданбалармен бөлек экрандар немесе бақылау тақталары арқылы жұмыс істемейді. Олар Nebo-мен сөйлеседі, ал Nebo істі бітіру үшін қолданбаның құралдарын пайдаланады. «Ертең күнтізбемде не бар?» — Nebo күнтізбе қолданбасын шақырады. «Сағат 15:00-де Sarah-пен кездесу құр» — Nebo күнтізбе қолданбасын шақырады. Пайдаланушы әңгімеден ешқашан шықпайды.
Қолданбалар қаласа баптаулар интерфейсін ұсына алады — Nebo-ның кіріктірілген браузер терезесінде ашылатын конфигурация панелі. Пайдаланушылар осы жерде API кілттерін енгізеді, функцияларды қосып-өшіреді және қолданбаны баптайды. Баптаулар интерфейсі манифесттегі settings массиві арқылы басқарылады (Nebo форманы автоматты түрде көрсетеді), немесе қолданба ui мүмкіндігі арқылы өзінің толық жеке интерфейсін ұсына алады.
Қолданбалар Nebo-ның кіріктірілген мүмкіндіктерін алмастырады және кеңейтеді. Nebo негізгі платформа құралдарымен келеді (жергілікті күнтізбеге қолжетімділік, скриншоттар және т.б.). Күнтізбе қолданбасын орнатқанда, ол кіріктірілген күнтізбе құралын алмастырып, оның кеңейтілген жиынына айналады — жергілікті + бұлт + біріктіру + бос уақытты тексеру.
Тек компиляцияланған файлдар саясаты
Nebo тек компиляцияланған бинарлық файлдарға қатаң саясат қолданады. Барлық қолданбалар нативті компиляцияланған орындалатын файлдар болуы тиіс.
| Күйі | Тілдер |
|---|---|
| Қолдау көрсетіледі | Go (ұсынылады), Rust, C/C++, Zig |
| Қабылданбайды | Python, Node.js, Ruby, Java, .NET, shell скриптері |
Негіздеме:
- ЖИ-дің өзін-өзі өзгертуінің алдын алу — Shell қолжетімділігі бар ЖИ қызметкері интерпретацияланатын скрипттің әрекетін орындалу кезінде өзгерте алады. Компиляцияланған бинарлық файлдар қолтаңба қойылғаннан кейін өзгермейді.
- Қолтаңба тұтастығы — Ed25519 қолтаңбалары бинарлық файлдың шикі байттарын қамтиды. Қолтаңбаланған бинарлық файлды қолтаңбаны жарамсыз етпей өзгерту мүмкін емес.
- Құмсалғыш талаптарын орындату — Бинарлық пішімді тексеру (ELF/Mach-O/PE magic bytes) — жылдам әрі сенімді тосқауыл.
Жылдам бастау
SDK орнату
Ресми SDK-лар gRPC серверін баптаудың, сигналдарды өңдеудің және протоколдарды байланыстырудың бәрін өздері атқарады. Сізге тек өңдеуші интерфейстерін іске асыру қалады.
Go (ұсынылады):
go get github.com/neboloop/nebo-sdk-go Rust (жақында):
# Coming soon
[dependencies]
nebo-sdk = "0.1" C/C++ (жақында):
# Coming soon — Add as a CMake subdirectory or copy headers from sdk/c/include/ Қолданба каталогының құрылымы
Қолданбалар Nebo деректер каталогыңыздың apps/ ішкі каталогында орналасады:
~/Library/Application Support/Nebo/apps/ # macOS
~/.config/nebo/apps/ # Linux
%AppData%\Nebo\apps\ # Windows
apps/
com.example.myapp/
manifest.json # Required: app metadata
binary # Required: executable (or named "app")
signatures.json # Required for NeboAI distribution, optional in dev
TOOL.md # Required: tool instructions for the agent
data/ # Auto-created: app's sandboxed storage
logs/ # Auto-created: stdout.log, stderr.log
ui/ # Optional: static UI assets (HTML/CSS/JS) Ең қарапайым қолданбаға арналған тексеру тізімі
id,name,version,providesөрістері барmanifest.jsonжасаңыз- ЖИ қызметкері құралыңызды қалай пайдалануы керегін сипаттайтын
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 | [] | Бапталатын параметрлер (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 | Браузерді автоматтандыру |
Қолданба бірнеше мүмкіндік ұсына алады. Мысалы, қолданба әрі құрал, әрі UI панелін ұсына алады.
Рұқсаттар
Рұқсаттар қолданбаның неге қол жеткізе алатынын басқарады. Әдепкі бойынша тыйым — жарияланбаса, қолданба оны пайдалана алмайды.
| Префикс | Мысалдар | Сипаттама |
|---|---|---|
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 | Push-хабарландырулар |
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 оларды дерекқорда сақтайды және өзгерген кезде Configure RPC арқылы қолданбаңызға жібереді.
Баптаулар схемаңыз 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 провайдеріне қойылатын талаптарды жариялай алады. Nebo-ның OAuth брокері бүкіл үдерісті өзі жүргізеді — қолданбалар токендерді Configure RPC арқылы автоматты түрде алады.
{
"oauth": [
{
"provider": "google",
"scopes": ["https://www.googleapis.com/auth/calendar"]
}
]
} | Өріс | Сипаттама |
|---|---|
provider | OAuth провайдері: "google", "microsoft", "github" |
scopes | Қолданбаға қажет OAuth аумақтарының массиві |
Пайдаланушы қолданбаны орнатқанда, Nebo одан қажетті OAuth аумақтарына рұқсат беруді сұрайды. Қолданба OAuth үдерісін өзі жүргізбей-ақ жаңартылған токендерді Configure RPC арқылы алады.
Орта айнымалылары
Қолданба процесіңіз тазартылған ортаны алады. Барлық құпия деректер алынып тасталады. Сізге берілетіндер:
| Айнымалы | Мәні |
|---|---|
NEBO_APP_DIR | Қолданбаның орнату каталогы |
NEBO_APP_SOCK | Жасалатын Unix сокетінің жолы |
NEBO_APP_ID | Манифесттегі қолданба ID-і |
NEBO_APP_NAME | Манифесттегі қолданба атауы |
NEBO_APP_VERSION | Манифесттегі қолданба нұсқасы |
NEBO_APP_DATA | Қолданбаның data/ каталогының жолы |
PATH | Жүйелік PATH (өзгеріссіз беріледі) |
HOME | Пайдаланушының үй каталогы (өзгеріссіз беріледі) |
TMPDIR | Уақытша каталог (өзгеріссіз беріледі) |
Маңызды: Бинарлық файлыңыз NEBO_APP_SOCK мекенжайындағы Unix сокетін тыңдайтын gRPC серверін жасауы тиіс. Nebo бұл сокеттің пайда болуын 10 секундқа дейін күтеді.
Қолданбаны іске қосу реті
- Nebo
manifest.jsonфайлын оқып, тексереді - Қолданба каталогынан
binaryнемесеappорындалатын файлын табады .quarantinedбелгісін тексереді (карантиндегі қолданбаларды іске қоспайды)- Кері қайтарып алу тексерісі (тек NeboAI таратқан қолданбалар үшін)
- Қолтаңбаны тексеру (тек NeboAI таратқан қолданбалар үшін, әзірлеу режимінде өткізіліп жіберіледі)
- Бинарлық файлды тексеру (символдық сілтемелерді, скрипттерді, орындалмайтын және тым үлкен файлдарды қабылдамайды)
- Алдыңғы іске қосудан қалған ескі сокетті тазалайды
- Құмсалғыштағы сақтау үшін
data/каталогын жасайды - Әр қолданбаға лог файлдарын баптайды (
logs/stdout.log,logs/stderr.log) - Бинарлық файлды тазартылған ортамен және процестер тобын оқшаулаумен іске қосады
- Unix сокетінің пайда болуын күтеді (экспоненциалды кідіріс, ең көбі 10 секунд)
- Unix сокеті арқылы gRPC бойынша қосылады
providesнегізінде мүмкіндікке арналған gRPC клиенттерін жасайды- Жұмыс күйін тексереді
- Мүмкіндіктерді ЖИ қызметкерінде тіркейді (құралдар, шлюз, comm және т.б.)
Құрал қолданбалары
Манифестіңізде "provides": ["tool:my_tool_name"] деп жариялаңыз.
STRAP үлгісі
Барлық Nebo құрал қолданбалары схема мен орындауды бағыттау үшін міндетті түрде STRAP (Single Tool Resource Action Pattern) үлгісін пайдалануы керек. Бұл — Nebo ішкі жұмысында 35+ жеке құралды 4 домендік құралға біріктіру үшін пайдаланатын сол үлгі — LLM контекстіне түсетін жүктемені ~80%-ға азайтады.
Негізгі идея: Бірнеше құралды (get_events, check_availability, suggest_slots) тіркеудің орнына, тиісті өңдеушіге бағыттайтын action (және қажет болса resource) өрістері бар БІР құралды тіркеңіз.
Бір ресурсты мысал (күнтізбе):
calendar(action: "get_events", start: "2025-01-15T09:00:00Z", end: "2025-01-16T00:00:00Z")
calendar(action: "next_event")
calendar(action: "check_availability", start: "...", end: "...")
calendar(action: "suggest_slots", duration_minutes: 30, preferred_time: "morning") Көп ресурсты мысал (жоба менеджері):
project(resource: "task", action: "create", title: "Ship v2", assignee: "alice")
project(resource: "task", action: "list", status: "open")
project(resource: "milestone", action: "create", name: "Beta", deadline: "2025-03-01")
project(resource: "milestone", action: "list") Схема ережелері:
- Әрдайым міндетті string enum ретінде
actionөрісін қосыңыз resourceөрісін (міндетті string enum) құралыңыз бірнеше бөлек ресурс түрін басқарғанда ғана қосыңыз- Қалған барлық өрістер — әрекетке тән параметрлер
actionenum сипаттамасы барлық қолжетімді әрекеттерді тізіп көрсетуі керек
STRAP неге маңызды:
- LLM-дер
actionбағыттау үлгісін бір рет үйреніп, оны барлық операцияларға жалпылайды - Құрал анықтамалары контекстің ~6%-ын алады — STRAP оны 80%-ға қысқартады
- Жаңа операциялар — жаңа құрал тіркеу емес, тек enum-ға қосымша
- Хостингтегі және жергілікті модельдерде бірдей жұмыс істейді
Go мысалы — Калькулятор құралы
package main
import (
"context"
"encoding/json"
"fmt"
"log"
nebo "github.com/neboloop/nebo-sdk-go"
)
type Calculator struct{}
func (c *Calculator) Name() string { return "calculator" }
func (c *Calculator) Description() string { return "Performs arithmetic calculations." }
func (c *Calculator) Schema() json.RawMessage {
return nebo.NewSchema("add", "subtract", "multiply", "divide").
Number("a", "First operand", true).
Number("b", "Second operand", true).
Build()
}
func (c *Calculator) Execute(_ context.Context, input json.RawMessage) (string, error) {
var in struct {
Action string `json:"action"`
A float64 `json:"a"`
B float64 `json:"b"`
}
if err := json.Unmarshal(input, &in); err != nil {
return "", fmt.Errorf("invalid input: %w", err)
}
var result float64
switch in.Action {
case "add":
result = in.A + in.B
case "subtract":
result = in.A - in.B
case "multiply":
result = in.A * in.B
case "divide":
if in.B == 0 {
return "", fmt.Errorf("division by zero")
}
result = in.A / in.B
default:
return "", fmt.Errorf("unknown action: %s", in.Action)
}
return fmt.Sprintf("%g %s %g = %g", in.A, in.Action, in.B, result), nil
}
func main() {
app, err := nebo.New()
if err != nil {
log.Fatal(err)
}
app.RegisterTool(&Calculator{})
log.Fatal(app.Run())
} manifest.json:
{
"id": "com.example.calculator",
"name": "Calculator",
"version": "1.0.0",
"description": "Arithmetic calculator tool for the agent",
"runtime": "local",
"protocol": "grpc",
"provides": ["tool:calculator"],
"permissions": []
} Жинау және орнату:
go build -o binary .
mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.calculator
cp binary manifest.json ~/Library/Application\ Support/Nebo/apps/com.example.calculator/ Rust мысалы
use async_trait::async_trait;
use nebo_sdk::{NeboApp, NeboError, SchemaBuilder};
use nebo_sdk::tool::ToolHandler;
use serde::Deserialize;
use serde_json::Value;
struct Calculator;
#[derive(Deserialize)]
struct Input { action: String, a: f64, b: f64 }
#[async_trait]
impl ToolHandler for Calculator {
fn name(&self) -> &str { "calculator" }
fn description(&self) -> &str { "Performs arithmetic calculations." }
fn schema(&self) -> Value {
SchemaBuilder::new(&["add", "subtract", "multiply", "divide"])
.number("a", "First operand", true)
.number("b", "Second operand", true)
.build()
}
async fn execute(&self, input: Value) -> Result<String, NeboError> {
let i: Input = serde_json::from_value(input)
.map_err(|e| NeboError::Execution(e.to_string()))?;
let r = match i.action.as_str() {
"add" => i.a + i.b,
"subtract" => i.a - i.b,
"multiply" => i.a * i.b,
"divide" => {
if i.b == 0.0 {
return Err(NeboError::Execution("division by zero".into()));
}
i.a / i.b
}
other => return Err(NeboError::Execution(format!("unknown action: {other}"))),
};
Ok(format!("{} {} {} = {}", i.a, i.action, i.b, r))
}
}
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
NeboApp::new()?.register_tool(Calculator).run().await?;
Ok(())
} C мысалы
#include <nebo/nebo.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
static int calculator_execute(const char *input_json, char **output, int *is_error) {
/* Parse JSON, compute result, set *output */
*output = strdup("2 add 3 = 5");
*is_error = 0;
return 0;
}
int main(void) {
const char *actions[] = {"add", "subtract", "multiply", "divide", NULL};
nebo_schema_builder_t *sb = nebo_schema_new(actions);
nebo_schema_number(sb, "a", "First operand", 1);
nebo_schema_number(sb, "b", "Second operand", 1);
char *schema = nebo_schema_build(sb);
nebo_schema_free(sb);
nebo_tool_handler_t calculator = {
.name = "calculator",
.description = "Performs arithmetic calculations.",
.schema = schema,
.execute = calculator_execute,
};
nebo_app_t *app = nebo_app_new();
nebo_app_register_tool(app, &calculator);
int ret = nebo_app_run(app);
free(schema);
return ret;
} Арна қолданбалары
"provides": ["channel:my_channel"] және "permissions": ["channel:send"] деп жариялаңыз.
Арна қолданбалары сыртқы хабар алмасу платформаларын (Telegram, Discord, Slack және т.б.) Nebo-ның ЖИ қызметкерімен байланыстырады. Пайдаланушы сыртқы платформада хабар жібергенде, қолданбаңыз оны Receive арқылы Nebo-ға ағынмен жібереді. ЖИ қызметкері жауап бергісі келгенде, Nebo қолданбаңыздың Send әдісін шақырады.
Қалай жұмыс істейді
- Nebo арнаңыздың бірегей идентификаторын алу үшін
ID()шақырады - Nebo қолданбаңыздың баптауларындағы конфигурациямен
Connect()шақырады - Nebo
Receive()ағынын ашады — пайдаланушы ботқа жазған сайын қолданбаңыз кіріс хабарларды жібереді - Кіріс хабарлар ЖИ қызметкерінің негізгі әңгіме жолағына бағытталады
- ЖИ қызметкері хабар жібергісі келгенде, Nebo v1 хабар конвертімен
Send()шақырады - Жұмысты аяқтағанда Nebo
Disconnect()шақырады
v1 хабар конверті
Барлық арна хабарлары — кіріс те, шығыс та — ортақ хабар конвертін пайдаланады:
{
"message_id": "01953f8a-...",
"channel_id": "telegram:12345",
"sender": { "name": "Alex", "role": "COO", "bot_id": "uuid" },
"text": "Q3 numbers look good...",
"attachments": [{ "type": "image", "url": "https://...", "filename": "chart.png", "size": 45000 }],
"reply_to": "01953f89-...",
"actions": [{ "label": "Approve", "callback_id": "approve_q3" }],
"platform_data": null,
"timestamp": "2026-02-12T15:10:00Z"
} | Өріс | Түрі | Сипаттама |
|---|---|---|
message_id | UUID v7 | Уақыт бойынша реттелген бірегей ID |
channel_id | {type}:{platform_id} | Бағыттауға болатын арна идентификаторы |
sender | object | Бот сәйкестігі — name, role, botId |
text | string | Хабар мәтіні |
attachments | array | Файлдар, суреттер, аудио |
reply_to | UUID v7 | Тізбек құру үшін ата-хабардың ID-і |
actions | array | Интерактивті түймелер/пернетақталар |
platform_data | bytes | Платформаға тән мүмкіндіктер үшін мөлдір емес өткізу өрісі |
timestamp | ISO 8601 | Мұны жариялаушы орнатады |
Екі қабатты дизайн: Ортақ өрістер (text, attachments, reply_to, actions) қызметкер бастаған хабар алмасудың 90%-ын қамтиды. Платформаға тән мүмкіндіктер platform_data ішіне түседі — плагиніңіз оларды платформаның нативті пішіміне және кері түрлендіреді.
Әңгіме ағындары
Арна хабарлары оқшаулау үшін әр арнаға бөлек әңгіме ағындары арқылы бағытталады:
neboai/bot/{botID}/channels/{channelType}/inbound # messages from users → agent
neboai/bot/{botID}/channels/{channelType}/outbound # messages from agent → channel Go мысалы — Telegram арнасы
package main
import (
"context"
"encoding/json"
"fmt"
"log"
"time"
"github.com/google/uuid"
tgbot "github.com/go-telegram/bot"
nebo "github.com/neboloop/nebo-sdk-go"
)
type Telegram struct {
bot *tgbot.Bot
messages chan nebo.ChannelEnvelope
cancel context.CancelFunc
}
func (t *Telegram) ID() string { return "telegram" }
func (t *Telegram) Connect(_ context.Context, config map[string]string) error {
token := config["bot_token"]
if token == "" {
return fmt.Errorf("bot_token is required")
}
botCtx, cancel := context.WithCancel(context.Background())
t.cancel = cancel
bot, err := tgbot.New(token, tgbot.WithDefaultHandler(
func(bCtx context.Context, b *tgbot.Bot, update *tgbot.Update) {
if update.Message == nil {
return
}
env := nebo.ChannelEnvelope{
MessageID: uuid.Must(uuid.NewV7()).String(),
ChannelID: fmt.Sprintf("telegram:%d", update.Message.Chat.ID),
Text: update.Message.Text,
Timestamp: time.Unix(int64(update.Message.Date), 0).UTC(),
}
t.messages <- env
},
))
if err != nil {
return err
}
t.bot = bot
go bot.Start(botCtx)
return nil
}
func (t *Telegram) Send(ctx context.Context, env nebo.ChannelEnvelope) (string, error) {
if t.bot == nil {
return "", fmt.Errorf("not connected")
}
chatID := env.ChannelID[len("telegram:"):]
params := &tgbot.SendMessageParams{
ChatID: chatID,
Text: env.Text,
}
msg, err := t.bot.SendMessage(ctx, params)
if err != nil {
return "", err
}
return fmt.Sprintf("%d", msg.MessageID), nil
}
func (t *Telegram) Receive(_ context.Context) (<-chan nebo.ChannelEnvelope, error) {
return t.messages, nil
}
func (t *Telegram) Disconnect(_ context.Context) error {
if t.cancel != nil {
t.cancel()
}
return nil
}
func main() {
app, err := nebo.New()
if err != nil {
log.Fatal(err)
}
app.RegisterChannel(&Telegram{
messages: make(chan nebo.ChannelEnvelope, 100),
})
log.Fatal(app.Run())
} manifest.json:
{
"id": "com.example.telegram",
"name": "Telegram",
"version": "1.0.0",
"description": "Telegram messaging channel for Nebo",
"runtime": "local",
"protocol": "grpc",
"provides": ["channel:telegram"],
"permissions": ["channel:send", "network:outbound"],
"settings": [
{
"key": "bot_token",
"title": "Bot Token",
"type": "password",
"required": true,
"description": "Telegram bot token from @BotFather",
"secret": true
}
]
} Қосымша мүмкіндіктер
Comm қолданбасы
"provides": ["comm"] және "permissions": ["comm:*"] деп жариялаңыз. Comm қолданбалары ЖИ қызметкерлері арасында байланыс орнатуға мүмкіндік береді.
| Өріс | Сипаттама |
|---|---|
from | Жіберуші қызметкердің ID-і |
to | Алушы қызметкердің ID-і |
topic | Хабар тақырыбы/арнасы |
type | "message", "mention", "proposal", "command", "info", "task" |
content | Хабар мәтіні |
Негізгі мінез-құлық:
Registerбұл ЖИ қызметкерін оның мүмкіндіктерімен бірге желіде жариялайдыSubscribe/Unsubscribeтақырыптарға жазылуды басқарадыReceiveкіріс хабарларды ағынмен жібереді (арналардағыдай, сервер жақтан ағын)- Бір уақытта тек бір comm қолданбасы белсенді бола алады
Шлюз қолданбасы
Шлюз қолданбасы LLM сұрауларын модельдерге бағыттайды. "provides": ["gateway"] және "permissions": ["network:outbound", "user:token"] деп жариялаңыз.
GatewayRequest ішінде хабарлар, құралдар, жүйелік промпт, максималды токен саны, temperature және UserContext (user:token рұқсаты берілсе, JWT токені) болады.
GatewayEvent түрлері:
| Түрі | Мазмұны | Сипаттама |
|---|---|---|
"text" | Мәтін бөлігі | Ағындық мәтін токені |
"tool_call" | JSON | Модель құралды шақырғысы келеді |
"thinking" | Мәтін бөлігі | Кеңейтілген ойлау/пайымдау |
"error" | Қате туралы хабар | Бірдеңе дұрыс болмады |
"done" | Бос | Ағын аяқталды |
UI қолданбасы
UI қолданбасы Nebo-ның кіріктірілген браузер терезесінде ашылатын жеке конфигурация интерфейсін ұсынады. "provides": ["ui"] деп жариялаңыз. Автоматты баптаулар формасынан (оны Nebo сіздің settings манифестіңізден көрсетеді) айырмашылығы — UI қолданбасы өзінің толық HTML/CSS/JS фронтендін ұсынады.
Қолданбаңыз статикалық веб-ресурстары (HTML, CSS, JS — әдетте index.html файлы бар SPA) бар ui/ каталогымен бірге шығады. Nebo бұл файлдарды тікелей ұсынады және API шақыруларын gRPC арқылы қолданбаңызға проксилейді.
| Жол | Механизм | Мақсаты |
|---|---|---|
GET /api/v1/apps/{id}/ui/* | Статикалық файл сервері | ui/ каталогыңыздағы файлдарды ұсынады (SPA үшін index.html файлына қайтарады) |
ANY /api/v1/apps/{id}/api/* | gRPC прокси | HTTP сұрауларын қолданбаңыздың UIService.HandleRequest() әдісіне проксилейді |
SDK стандартты net/http.ServeMux орап алады, сондықтан сіз кәдімгі Go HTTP өңдеушілерін жазасыз — gRPC байланыстыруды SDK автоматты түрде атқарады.
Go мысалы — Dashboard UI:
package main
import (
"encoding/json"
"log"
"net/http"
nebo "github.com/neboloop/nebo-sdk-go"
)
type Dashboard struct {
mux *http.ServeMux
}
func NewDashboard() *Dashboard {
d := &Dashboard{mux: http.NewServeMux()}
d.mux.HandleFunc("GET /status", func(w http.ResponseWriter, r *http.Request) {
json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
})
d.mux.HandleFunc("POST /action", func(w http.ResponseWriter, r *http.Request) {
var req map[string]string
json.NewDecoder(r.Body).Decode(&req)
json.NewEncoder(w).Encode(map[string]string{"result": "done"})
})
return d
}
func (d *Dashboard) Handler() *http.ServeMux { return d.mux }
func main() {
app, err := nebo.New()
if err != nil {
log.Fatal(err)
}
app.RegisterUI(NewDashboard())
log.Fatal(app.Run())
} ui/index.html файлыңыз /api/v1/apps/com.example.dashboard/api/status мекенжайына fetch шақыруларын жасайды, ал олар mux өңдеушіңізге проксиленеді.
Кесте қолданбасы
Кесте қолданбасы Nebo-ның кіріктірілген cron жоспарлаушысын алмастырады. "provides": ["schedule"] және "permissions": ["schedule:create"] деп жариялаңыз.
Кесте қолданбаңыз іске қосылғанда, Nebo барлық жоспарлауды әдепкі cron қозғалтқышының орнына сіздің қолданбаңыз арқылы бағыттайды. Қолданбаңыз құласа, Nebo автоматты түрде кіріктірілген қозғалтқышқа қайта ауысады.
- Қолданбаңыз кесте күйіне иелік етеді — кесте қолданбасы белсенді кезде Nebo кестелерді өз дерекқорында сақтамайды
- Стандартты 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>"
} Әзірлеу режимінде (NeboAI URL бапталмаған кезде) қолтаңбаны тексеру толығымен өткізіліп жіберіледі. Жергілікті әзірлеу үшін сізге signatures.json қажет емес.
Жариялау
Қолданбаңыз жергілікті түрде жұмыс істегеннен кейін, оны барлық Nebo пайдаланушыларына тарату үшін NeboAI арқылы жариялаңыз.
Әзірлеуші аккаунтын баптау
POST /api/v1/owners/registerарқылы NeboAI аккаунтын тіркеңіз- JWT токенін алу үшін кіріңіз:
POST /api/v1/owners/login - Әзірлеуші аккаунтын жасаңыз:
POST /api/v1/developer/accounts
Жіберу үдерісі
draft → pending_review → [approved] → published
→ [rejected] → draft (fix and resubmit) 1-қадам: Қолданбаны жасау
curl -X POST https://neboai.com/api/v1/developer/apps \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "My App",
"version": "1.0.0",
"description": "What it does",
"category": "productivity",
"visibility": "public"
}' 2-қадам: Платформалық бинарлық файлдарды жүктеу
curl -X POST https://neboai.com/api/v1/developer/apps/{id}/binaries \
-H "Authorization: Bearer $TOKEN" \
-F "binary=@myapp-darwin-arm64" \
-F "platform=darwin-arm64" Әр платформаға бір бинарлық файл жүктеңіз: darwin-arm64, darwin-amd64, linux-amd64, linux-arm64.
3-қадам: Тексеруге жіберу
curl -X POST https://neboai.com/api/v1/developer/apps/{id}/submit \
-H "Authorization: Bearer $TOKEN" Тексеру үдерісі
- Автоматты сканерлеу — бинарлық файлдар VirusTotal арқылы сканерленеді
- Әкімші тексеруі — NeboAI командасы метадеректерді, манифестті және сканерлеу нәтижелерін қарайды
- Мақұлданғанда — NeboAI қолданбаға Ed25519 арқылы қолтаңба қойып, оны жариялайды
- Қабылданбағанда — себебін аласыз, түзетіп, қайта жібере аласыз
Тексерудің мақсатты уақыты: <24 сағат.
Жаңартуларды шығару
- Қолданба нұсқасын жаңартыңыз: жаңа нұсқамен
PUT /api/v1/developer/apps/{id} - Әр платформаға жаңа бинарлық файлдарды жүктеңіз
- Қайтадан тексеруге жіберіңіз
Әр жаңарту дәл сондай тексеруден өтеді. Жаңа нұсқа мақұлданғанша алдыңғы нұсқалар қолжетімді болып қалады.
Дүкен метадеректері
| Өріс | Сипаттама |
|---|---|
category | мысалы, productivity, communication, developer-tools |
icon | Қолданба белгішесінің URL-і |
visibility | public немесе private |
description | Манифест сипаттамасынан ұзынырақ/толығырақ болуы мүмкін |
Әзірлеу үдерісі
Жергілікті әзірлеу
Жергілікті әзірлеу үшін пакеттеу қажет емес:
- Қолданба каталогын жасаңыз:
mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp manifest.jsonфайлыңыз бен кодыңызды жазыңыз- Бинарлық файлды жинаңыз:
go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary . - Nebo жаңа каталогты автоматты түрде анықтайды (немесе Nebo-ны қайта іске қосыңыз)
- Кодты өзгерткеннен кейін бинарлық файлды қайта жинаңыз — файл бақылаушысы қолданбаны қайта іске қосады
Логтарды қарау
Қолданбаның stdout/stderr ағындары әр қолданбаға арналған лог файлдарына жазылады:
tail -f ~/Library/Application\ Support/Nebo/apps/com.example.myapp/logs/stdout.log
tail -f ~/Library/Application\ Support/Nebo/apps/com.example.myapp/logs/stderr.log Тұрақты деректер
Қолданбаңыз сақтап қалуы тиіс кез келген файл үшін data/ каталогын (ол NEBO_APP_DATA орта айнымалысы ретінде де қолжетімді) пайдаланыңыз. Бұл каталог қолданба жаңартулары мен карантиннен кейін де сақталады.
Ақауларды іздеу бойынша кеңестер
- Қолданбаңыз іске қосылмаса, қателерді
logs/stderr.logфайлынан тексеріңіз - Бинарлық файлдың орындалатынына көз жеткізіңіз (
chmod +x binary) NEBO_APP_SOCKішіндегі Unix сокет жолын тыңдап тұрғаныңызға көз жеткізіңіз- Сокет іске қосылғаннан кейін 10 секунд ішінде дайын болуы тиіс
- Сақтау үшін қатаң жазылған жолдарды емес,
NEBO_APP_DATAпайдаланыңыз - Жөндеу логтары үшін stderr-ге шығарыңыз (
logs/stderr.logфайлына жазылады)
Тексеру
# List installed apps
nebo apps list
# Check running apps via the web UI Settings > Apps
# Or check the apps directory for running sockets
ls ~/Library/Application\ Support/Nebo/apps/*/app.sock Жою
nebo apps uninstall com.example.myapp Дағдылар
Дағдылар деген не
Дағдылар — әңгіме барысында Nebo-ның мінез-құлқын айқындайтын нұсқаулар жиынтығы. Дағды белсенді болғанда, оның мазмұны тікелей жүйелік промптқа енгізіледі — сол сеанс үшін ЖИ қызметкерінің үнін, әдістемесін, салалық біліктілігін және құралдарды пайдалануын бағыттайды.
Дағдылар — код емес. Олар YAML метадеректері бар markdown құжаттары. Компиляция да, бинарлық файл да, gRPC да жоқ. Дағды — каталогтағы SKILL.md файлы. Болғаны сол.
Дағдылар контекстке байланысты әрі уақытша. Олар қажет кезде іске қосылады (іске қосу шартына сәйкестік немесе қолмен жүктеу арқылы), бірнеше жүріс бойы сақталады және енді қажет болмаған кезде мерзімі бітеді. Бұл ЖИ қызметкерінің контекстін ықшам ұстайды — промптта тек дәл қазір маңызды нұсқаулар ғана болады.
Дағдылар қолданбаларды толықтырады. Қолданбалар орындалатын мүмкіндіктерді (құралдар, арналар, шлюздер) береді. Дағдылар үйлестіру нұсқауларын береді — сол құралдарды қалай тиімді пайдалану керек. Күнтізбе қолданбасы Nebo-ға оқиғаларды оқу және жазу мүмкіндігін береді. «Кездесуге дайындық» дағдысы Nebo-ға сол күнтізбе қолданбасын, поштаны және веб-іздеуді бірге пайдаланып, кездесулерге қалай дайындалу керегін айтады.
Дағдылар мен қолданбалар
| Дағдылар | Қолданбалар | |
|---|---|---|
| Пішімі | Markdown (SKILL.md) | Компиляцияланған бинарлық файл (.napp) |
| Орындалу ортасы | Жүйелік промптқа енгізіледі | gRPC арқылы жұмыс істейтін құмсалғыштағы процесс |
| Ұсынады | Мінез-құлық нұсқаулары, әдістеме | Құралдар, арналар, UI панельдері |
| Өмір сүру мерзімі | Сеанс аясында, TTL бойынша мерзімі бітеді | Әрдайым жұмыс істейді |
| Жасау | Markdown файлын жазу | Жазу, компиляциялау, қолтаңба қою, пакеттеу |
| Қауіпсіздік | Рұқсат қажет емес | Әдепкі бойынша тыйым салынған құмсалғыш |
Жылдам бастау
Nebo дағдылар қалтасында SKILL.md файлы бар каталог жасаңыз:
~/Library/Application Support/Nebo/skills/ # macOS
~/.config/nebo/skills/ # Linux
%AppData%\Nebo\skills\ # Windows mkdir -p ~/.config/nebo/skills/my-skill SKILL.md жазыңыз:
---
name: my-skill
description: One-line description of what this skill does
version: "1.0.0"
triggers:
- keyword that activates this skill
- another trigger phrase
---
# My Skill
Instructions for Nebo when this skill is active.
Tell the agent what to do, how to approach problems,
what tools to use, and what tone to take. Nebo дағдылар каталогын fsnotify арқылы бақылайды. Дағдыңыз бірден қолжетімді болады — қайта іске қосу қажет емес. Іске қосу шартына сәйкес келетін бір нәрсе айтыңыз, сонда ол автоматты түрде іске қосылады.
Немесе Nebo-дан тікелей сұраңыз: «Блог жазбаларын жазуға арналған дағды жаса» — Nebo SKILL.md файлын сіз үшін жазып береді.
SKILL.md пішімі
Әр дағды екі бөліктен тұратын жалғыз SKILL.md файлы: --- белгілерінің арасындағы YAML frontmatter және markdown мәтіні (жүйелік промптқа енгізілетін нақты нұсқаулар).
| Өріс | Міндетті | Әдепкі | Сипаттама |
|---|---|---|---|
name | Иә | — | Бірегей идентификатор (slug-қа айналады) |
description | Иә | — | Дағдылар каталогында көрсетілетін бір жолдық сипаттама |
version | Жоқ | "1.0.0" | Жаңартуларды бақылауға арналған semver |
author | Жоқ | — | Дағды авторы |
priority | Жоқ | 0 | Жоғарырақ = бірінші сәйкестендіріледі (маңызды басымдықтар үшін 100+) |
max_turns | Жоқ | 4 | Автоматты түрде мерзімі біткенге дейінгі белсенсіз жүрістер саны |
triggers | Жоқ | [] | Бұл дағдыны автоматты түрде іске қосатын тіркестер (регистрді ескермейтін ішкі жол сәйкестігі) |
tools | Жоқ | [] | Бұл дағды пайдаланатын құралдар (ақпарат үшін) |
dependencies | Жоқ | [] | Орнатылуы тиіс басқа дағдылар |
tags | Жоқ | [] | Санаттау және табу үшін |
platform | Жоқ | [] | Қолдау көрсетілетін платформалар: macos, linux, windows (бос = барлығы) |
Дағдылар қалай іске қосылады
Дағдылар екі кезеңді іске қосу үлгісіне сүйенеді: алдымен нұсқау, содан кейін шақыру.
1-кезең: Іске қосу шартын сәйкестендіру — Пайдаланушы хабар жіберген сайын Nebo тіркелген барлық дағдыларды іске қосу шарттарына сәйкестігін тексереді. Сәйкес келетін дағдылар жүйелік промптта нұсқау ретінде пайда болады. ЖИ қызметкері нұсқауды көріп, дағдыны шақыру-шақырмауды шешеді.
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 тармақтау, коммиттер, PR жұмыс үдерістері |
security-audit | 10 | Қауіпсіздікті талдау және осалдықтарды анықтау |
Бұлар әрі пайдалы әдепкі параметрлер, әрі өз дағдыларыңызды жасауға арналған эталондық үлгілер қызметін атқарады.
Анықтама
Proto файлдары
Proto файлдары proto/apps/v0/ ішінде орналасқан. SDK-лар алдын ала генерацияланған кодпен келеді, сондықтан әдеттегі әзірлеу үшін protoc қажет емес.
| Файл | Қызмет | Негізгі RPC-лер |
|---|---|---|
v0/common.proto | (тек хабарлар) | HealthCheckRequest/Response, SettingsMap, UserContext, Empty |
v0/tool.proto | ToolService | Name, Description, Schema, Execute, RequiresApproval, Configure |
v0/channel.proto | ChannelService | ID, Connect, Disconnect, Send, Receive (stream), Configure |
v0/comm.proto | CommService | Name, Version, Connect, Disconnect, Send, Subscribe, Register, Receive (stream), Configure |
v0/gateway.proto | GatewayService | HealthCheck, Stream (stream), Poll, Cancel, Configure |
v0/ui.proto | UIService | HealthCheck, HandleRequest, Configure |
v0/schedule.proto | ScheduleService | HealthCheck, Create, Get, List, Update, Delete, Enable, Disable, Trigger, History, Triggers (stream), Configure |
Әр қызметте HealthCheck және Configure RPC-лері бар. SDK екеуін де автоматты түрде өңдейді.
Арна proto түрлері
| Хабар түрі | Сипаттама |
|---|---|
ChannelSendRequest | message_id, channelId, sender, text, attachments, reply_to, actions, platform_data өрістері бар шығыс хабар конверті |
ChannelSendResponse | Тізбек құруға арналған платформа хабарының ID-і |
InboundMessage | Барлық ортақ өрістері + уақыт белгісі бар кіріс хабар конверті |
MessageSender | Бот сәйкестігі (name, role, botId) — брокер толықтырады |
Attachment | Файл/сурет/аудио тіркемесі (type, url, filename, size) |
MessageAction | Интерактивті түйме/пернетақта әрекеті (label, callback_id) |
Бот сәйкестігі және рөлдері
Nebo боттарының үш өлшемді сәйкестік үлгісі бар:
- creature — Бот кім (архетип): «Тапқыр стратег», «Ұқыпты зерттеуші»
- role — Оның пайдаланушыға қатысы (қарым-қатынас): «Дос», «COO», «Тәлімгер»
- vibe — Оның энергиясы (сөйлесу стилі): «Сабырлы, бірақ өз пікірі бар», «Жылы әрі қолдаушы»
Арна плагиніңіз шығыс хабар алғанда, sender өрісінде боттың name және role мәндері болады. Мұны платформаңызда көрсетілетін атауды пішімдеу үшін пайдаланыңыз. Рөл — лауазым емес, қарым-қатынасты сипаттайтын белгі. «Дос», «Ұл» және «Тәлімгер» — «COO» мен «DevLead» сияқты жарамды рөлдер.